Configurez votre centre de données

Il se peut que vous deviez configurer le Client SDK pour qu'il se connecte au centre de données le plus proche. Vous pouvez utiliser ce guide pour vous aider à déterminer la meilleure configuration possible.

NOTE : Il s'agit d'une étape facultative avancée. Elle n'est nécessaire que si vous estimez que les performances de votre réseau doivent être améliorées. Pour la plupart des utilisateurs, cette configuration n'est pas nécessaire. Cette étape peut être réalisée après ajouter le SDK à votre application.

Pourquoi configurer vos centres de données ?

Vous ne devez le faire que si vous pensez que les performances de votre application pourraient être améliorées en vous connectant à un centre de données plus local. Par défaut, le Client SDK se connecte à un centre de données américain.

Configuration avec les régions

Le Client SDK Config dispose d'un initialisateur qui prend un enum de région (US, EU, AP) :

Si elle est chargée d'un <script> étiquette :

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

S'il est chargé via import:

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

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

Pour mettre à jour après l'initialisation :

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)

NOTE : Les utilisateurs sont spécifiques aux régions, si vous changez le centre de données du Client SDK, vous devez créer des utilisateurs dans le même centre de données. Les URL des centres de données sont détaillées ci-dessous.

URL

Si vous souhaitez plus de contrôle que la définition de la région, il est possible de configurer les URL suivantes :

apiUrl: l'URL de la Conversation API.
websocketUrl: l'URL de la socket.

`apiUrl`

Il s'agit de l'URL de la Conversation API. Il s'agit de l'URL utilisée lorsque le Client SDK appelle l'API.

La valeur par défaut est https://api-us-3.vonage.com.

Centre de données	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`

Il s'agit de l'URL du websocket : l'URL qui reçoit les événements en temps réel.

La valeur par défaut est wss://ws-us-3.vonage.com.

Centre de données	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`

Configuration à l'aide d'URL

Vous pouvez spécifier vos URL préférés lorsque vous créez le Client SDK ClientConfig objet :

Si elle est chargée d'un <script> étiquette :

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

S'il est chargé via 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"
});

Pour mettre à jour après l'initialisation :

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)

Voir aussi

Ajouter le SDK à votre application