Configura tu centro de datos
Puede que necesite configurar el Client SDK para conectarse a su centro de datos más cercano. Puede utilizar esta guía para determinar la mejor configuración.
NOTA: Este es un paso opcional avanzado. Sólo necesita hacerlo si determina que el rendimiento de su red necesita ser mejorado. Para la mayoría de los usuarios esta configuración no es necesaria. Este paso puede realizarse después de añadir el SDK a su aplicación.
¿Por qué configurar tus centros de datos?
Solo tienes que hacer esto si crees que el rendimiento de tu aplicación podría mejorar conectándote a un centro de datos más cercano. Por defecto, el Client SDK se conecta a un centro de datos de EE. UU.
Configuración con regiones
La configuración del Client SDK cuenta con un inicializador que toma una enumeración de regiones (US, EU, AP):
Si se carga con un <script> etiqueta:
const client = new vonageClientSDK.VonageClient({
region: "EU"
});
Si se carga a través de import:
import { VonageClient } from "@vonage/client-sdk";
const client = new VonageClient({
region: "EU"
});
Para actualizar después de la inicialización:
client.setConfig({
region: "AP"
});
val config = VGClientConfig(ClientConfigRegion.US) // Other options are .AP & .EU
val client = VonageClient(this.application.applicationContext)
client.setConfig(config)
let config = VGClientConfig(region: .US) // Other options are .AP & .EU
let client = VGVonageClient()
client.setConfig(config)
NOTA: Los usuarios son específicos de las regiones, si cambia el centro de datos del Client SDK deberá crear usuarios en el mismo centro de datos. Las URL de los centros de datos se detallan a continuación.
URL
Si quieres tener más control que el que ofrece la configuración de la región, puedes configurar las siguientes URL:
apiUrl: la URL de la Conversation API.websocketUrl: la URL del websocket.
apiUrl
Esta es la URL de la Conversation API. Es la URL utilizada cuando el Client SDK llama a la API.
El valor por defecto es https://api-us-3.vonage.com.
| Centro de datos | 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 es la URL del websocket: la URL que recibe los eventos en tiempo real.
El valor por defecto es wss://ws-us-3.vonage.com.
| Centro de datos | 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 |
Configuración con URL
Puedes indicar tus URL preferidas al crear el Client SDK ClientConfig objeto:
Si se carga con un <script> etiqueta:
const client = new vonageClientSDK.VonageClient({
apiUrl: "https://api-us-3.vonage.com",
websocketUrl: "wss://ws-us-3.vonage.com"
});
Si se carga a través 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 actualizar después de la inicialización:
client.setConfig({
apiUrl: "https://api-ap-3.vonage.com",
websocketUrl: "wss://ws-ap-3.vonage.com"
});
val config = VGClientConfig()
config.apiUrl = "https://api-us-3.vonage.com"
config.websocketUrl = "wss://ws-us-3.vonage.com"
val client = VonageClient(this.application.applicationContext)
client.setConfig(config)
let config = VGClientConfig()
config.apiUrl = "https://api-us-3.vonage.com"
config.websocketUrl = "wss://ws-us-3.vonage.com"
let client = VGVonageClient()
client.setConfig(config)