Configure seu data center

Talvez seja necessário configurar o Client SDK para se conectar ao data center mais próximo. Você pode usar este guia para ajudar a determinar a melhor configuração.

NOTA: Esta é uma etapa opcional avançada. Você só precisa realizá-la se concluir que o desempenho da sua rede precisa ser aprimorado. Para a maioria dos usuários, essa configuração não é necessária. Essa etapa pode ser realizada após adicionando o SDK ao seu aplicativo.

Por que configurar seus data centers?

Você só precisa fazer isso se acreditar que o desempenho do seu aplicativo poderia ser melhorado ao se conectar a um data center mais próximo. Por padrão, o Client SDK se conecta a um data center nos EUA.

Configuração com regiões

A configuração do Client SDK possui um inicializador que recebe uma enumeração de região (US, EU, AP):

Se for carregado com um <script> tag:

const client = new vonageClientSDK.VonageClient({
  region: "EU"
});

Se carregado por meio de import:

import { VonageClient } from "@vonage/client-sdk";

const client = new VonageClient({
  region: "EU"
});

Para atualizar após a inicialização:

client.setConfig({
  region: "AP"
});

NOTA: Os usuários são vinculados a regiões específicas; caso altere o data center do Client SDK, será necessário criar usuários no mesmo data center. As URLs dos data centers estão detalhadas abaixo.

URLs

Se você quiser ter mais controle além de definir a região, é possível configurar os seguintes URLs:

apiUrl: a URL da Conversation API.
websocketUrl: a URL do WebSocket.

`apiUrl`

Esta é a URL da Conversation API. Esta é a URL utilizada quando o Client SDK chama a API.

O valor padrão é https://api-us-3.vonage.com.

Centro de Dados	URL
`Virginia`	`https://api-us-3.vonage.com`
`Oregon`	`https://api-us-4.vonage.com`
`Dublin`	`https://api-eu-3.vonage.com`
`Frankfurt`	`https://api-eu-4.vonage.com`
`Singapore`	`https://api-ap-3.vonage.com`
`Sydney`	`https://api-ap-4.vonage.com`

`websocketUrl`

Esta é a URL do WebSocket: a URL que recebe eventos em tempo real.

O valor padrão é wss://ws-us-3.vonage.com.

Centro de Dados	URL
`Virginia`	`wss://ws-us-3.vonage.com`
`Oregon`	`wss://ws-us-4.vonage.com`
`Dublin`	`wss://ws-eu-3.vonage.com`
`Frankfurt`	`wss://ws-eu-4.vonage.com`
`Singapore`	`wss://ws-ap-3.vonage.com`
`Sydney`	`wss://ws-ap-4.vonage.com`

Configuração com URLs

Você pode especificar suas URLs preferidas ao criar o Client SDK ClientConfig objeto:

Se for carregado com um <script> tag:

const client = new vonageClientSDK.VonageClient({
  apiUrl: "https://api-us-3.vonage.com",
  websocketUrl: "wss://ws-us-3.vonage.com"
});

Se carregado por meio de import:

import { VonageClient } from "@vonage/client-sdk";

const client = new VonageClient({
  apiUrl: "https://api-us-3.vonage.com",
  websocketUrl: "wss://ws-us-3.vonage.com"
});

Para atualizar após a inicialização:

client.setConfig({
  apiUrl: "https://api-ap-3.vonage.com",
  websocketUrl: "wss://ws-ap-3.vonage.com"
});

Veja também

Adicione o SDK ao seu aplicativo