Gestion des sessions

Les sessions font partie intégrante de l'utilisation des SDK clients de Vonage. Une session est un flux de communication en direct entre le Client SDK et les serveurs de Vonage.

Création d'une session

Pour commencer à passer ou à recevoir des appels avec le Client SDK de Vonage, vous devez créer une session. Une condition préalable à la création d'une session est d'avoir un utilisateur et un JWT pour cet utilisateur. Vous pouvez en savoir plus sur les utilisateurs et les JWT dans la section Créez votre Applications guide. Une fois que vous avez un utilisateur et un JWT associé, vous pouvez appeler la fonction createSession sur le SDK. Les exemples de ce guide sont en JavaScript, mais les noms des fonctions sont les mêmes pour les trois plateformes.

client.createSession(jwt)
 .then(sessionId => {
    console.log("Id of created session: ", sessionId);
 })
 .catch(error => {
    console.error("Error creating session: ", error);
 });

En cas de succès, vous obtiendrez un identifiant de session. Cela vous permet de vous reconnecter à cette session spécifique si nécessaire. Les sessions ont un TTL de 15 minutes.

Reconnexion d'une session

Si vous souhaitez vous reconnecter à une session existante, le bouton createSession peut éventuellement prendre en paramètre l'identifiant de la session.

client.createSession(jwt, existingSessionId)
 .then(sessionId => {
    console.log("Id of session: ", sessionId);
 })
 .catch(error => {
    console.error("Error: ", error);
 });

Dépannage de la création de session

Si vous ne parvenez pas à créer une session, le message d'erreur renvoyé vous donnera une idée du problème. Voici quelques étapes générales de dépannage

  1. Vérifiez que l'utilisateur Vonage existe en effectuant une requête GET à l'adresse API utilisateurs
  2. Si l'utilisateur existe, assurez-vous qu'il se trouve dans le même groupe d'utilisateurs. région à laquelle le Vonage Client SDK tente de se connecter. Le SDK user._links provenant de l'appel API "Utilisateurs", la région de l'utilisateur sera répertoriée.
  3. Entrez votre JWT dans jwt.io pour s'assurer que le JWT contient le bon nom d'utilisateur sur le serveur sub et qu'il n'est pas expiré. Vous pouvez également vérifier que le Chemins ACL sont corrects et l'objet est correctement imbriqué.

Actualiser une session

Si vous avez une session active et que vous savez que le JWT utilisé pour créer la session va bientôt expirer, vous pouvez rafraîchir la session avec un nouveau JWT.

client.refreshSession(jwt)
 .then(() => {
    console.log("Session refreshed");
 })
 .catch(error => {
    console.error("Error refreshing session: ", error);
 });

Suppression d'une session

Vous pouvez également supprimer une session. Vous feriez cela dans le cadre d'un flux de déconnexion, par exemple.

client.deleteSession(jwt)
 .then(() => {
    console.log("Session deleted");
 })
 .catch(error => {
    console.error("Error deleting session: ", error);
 });

Vous avez des questions ?

Si vous avez d'autres questions, des problèmes ou des commentaires, veuillez nous contacter à l'adresse suivante devrel@vonage.com ou le Communauté des développeurs de Vonage Slack.