Présentation des projets de démonstration de l'application Vonage Client SDK

Les SDK SDK client de Vonage pour Android, iOS et Web en conjonction avec l Conversation API vous aident à intégrer des fonctions de voix et de messagerie dans vos Applications. Pour présenter la fonctionnalité multiplateforme des SDK et de l'API Conversation, nous avons créé la V-App ! La V-App est une application de bout en bout sur les trois plateformes, mais nous ne nous sommes pas arrêtés là ! Pour soutenir les Applications, nous avons également construit un backend en utilisant Node.JS. Ce blog donnera un bref aperçu de la façon dont les différents composants sont construits, si vous voulez aller plus loin, vous pouvez consulter le code sur GitHub.

Le backend de V-App

Comme indiqué précédemment, le client dorsal est construit à l'aide de Node.JS et, une fois lancé, il gère les événements RTC webhook de Vonage qui sont générés lorsque des utilisateurs sont ajoutés à des conversations, que des messages sont envoyés, etc. Le client dorsal utilise une base de données Postgres pour stocker les événements du webhook afin d'éviter d'avoir à interroger l'API Conversation trop fréquemment. L'In-App Voice prend également en charge les appels, de sorte que le client dorsal dispose également d'une route de réponse vocale qui renvoie un NCCO :

webhookRoutes.get('/voice/answer', async (req, res) => {
  var ncco = [{"action": "talk", "text": "No destination user - hanging up"}];
  var username = req.query.to;
  if (username) {
    ncco = [
      {
        "action": "talk",
        "text": "Connecting you to " + username
      },
      {
        "action": "connect",
        "endpoint": [
          {
            "type": "app",
            "user": username
          }
        ]
      }
    ]
  }
  res.json(ncco);
});

Grâce à l'existence d'une base de données, le client backend prend également en charge les comptes d'utilisateurs ! Une fois qu'un utilisateur s'est inscrit, et lors des connexions suivantes, le backend renvoie un JWT dans la réponse qui peut être utilisé pour s'authentifier avec les SDK du client :

{
  "user": {
    "id": "USR-44326d04-cd82-41f5-ad24-315c2a2eac41",
    "name": "Alice",
    "display_name": "alice"
  },
  "token": "ey...dg",
  "users": [{ ... },
  "conversations": [{ ... }]
}

Le dépôt Dépôt GitHub inclut un fichier .env-sample pour s'assurer que vous avez les bons secrets, ainsi qu'un support pour le déploiement avec docker. Mais lisez la suite pour savoir comment vous pouvez déployer le backend de manière transparente.

Les clients de la V-App

L'application V-App est disponible sous forme d'applications natives sur Android, iOS et Web, chacune utilisant le Vonage Client SDK respectif de la plateforme. L'application Android est construite en utilisant Kotlin, l'application iOS est construite en Swift et UIKit, et l'application Web est construite en utilisant Javascript et les composants Web du SDK du client Vonage. Vonage Client SDK Composants Web.

Comme indiqué précédemment, les applications prennent en charge les comptes d'utilisateurs :

Une fois connecté, vous pouvez entamer une conversation entre deux ou plusieurs utilisateurs enregistrés :

Les chats permettent également d'envoyer des images :

Si les chats textuels ne suffisent pas, V-App permet également de téléphoner :

Les instructions d'installation des clients sont disponibles sur GitHub. Pour faciliter l'essai de la V-App, nous avons construit une chose supplémentaire !

Le plugin CLI Scaffold de Vonage

Pour télécharger, configurer et exécuter les 3 clients et le backend de manière transparente, vous pouvez installer le scaffold plugin pour le CLI de Vonage :

vonage plugins:install @vonage/cli-plugin-scaffold

Une fois installée, vous pouvez démarrer la V-App à l'aide de la commande suivante, en spécifiant les clients que vous souhaitez télécharger :

vonage scaffold:vapp --platforms=web,ios,android --backend=docker

Vous pouvez lancer la commande help pour voir les différentes options disponibles :

vonage scaffold:vapp --help

Comme le CLI Vonage est déjà authentifié auprès de Vonage, le plugin peut créer une nouvelle application Vonage et configurer les webhooks prêts à être utilisés par la V-App. Les clients sont également téléchargés et leurs dépendances installées :

Le plugin déploie également le client backend localement en utilisant docker, et configure les clients avec l'URL du déploiement :

Essayez la V-App, puis rejoignez la conversation sur le Slack de la communauté Vonage. Communauté Vonage ou envoyez-nous un message sur sur Twitter.