Presentación del Client SDK de Vonage Proyectos de demostración de V-App

En SDK para clientes de Vonage para Android, iOS y Web junto con la Conversation API te ayuda a incorporar funciones de voz y mensajería en tus aplicaciones. Para mostrar la funcionalidad multiplataforma de los SDK y la Conversation API, hemos creado la V-App. La V-App es una aplicación de extremo a extremo en las 3 plataformas, ¡pero no nos detuvimos ahí! Para dar soporte a las aplicaciones, también hemos construido un backend utilizando Node.JS. Este blog tendrá una breve visión general de cómo los diferentes componentes se construyen, si desea saltar por delante se puede comprobar fuera de el código en GitHub.

El backend de V-App

Como se mencionó anteriormente, el cliente backend se construye utilizando Node.JS, y una vez que se ejecuta maneja eventos webhook RTC de Vonage que se generan cuando los usuarios se agregan a las conversaciones, se envían mensajes, y más. El cliente backend utiliza una base de datos Postgres para almacenar los eventos del webhook para evitar tener que consultar la Conversation API con demasiada frecuencia. La V-App también admite llamadas, por lo que el cliente backend también tiene una ruta de respuesta de voz que devuelve una 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);
});

Gracias a tener una base de datos adjunta, ¡el cliente backend también soporta cuentas de usuario! Una vez que un usuario se ha registrado, y en los inicios de sesión posteriores, el backend devolverá un JWT en la respuesta que se puede utilizar para autenticarse con los SDK de cliente:

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

El repositorio GitHub incluye un archivo .env-sample para asegurarte de que tienes los secretos correctos, así como soporte para el despliegue con docker. Pero, sigue leyendo para aprender cómo puedes desplegar el backend sin problemas.

Los clientes de V-App

La aplicación V-App está disponible como aplicaciones nativas en Android, iOS y Web, cada una usando el respectivo Vonage Client SDK de la plataforma. La aplicación para Android está construida usando Kotlin, la aplicación para iOS está construida en Swift y UIKit, y la aplicación para la Web está construida usando Javascript y el Componentes web del Vonage Client SDK.

Como ya se ha mencionado, las Applications admiten cuentas de usuario:

Una vez conectado, puedes iniciar una conversación entre dos o más usuarios registrados:

Los chats también admiten el envío de imágenes:

Si los chats de texto no son suficientes, V-App también admite llamadas:

Las instrucciones para configurar los clientes están disponibles en GitHub. Para que sea más fácil probar la V-App, ¡hemos construido una cosa más!

El plugin de andamiaje CLI de Vonage

Para descargar, configurar y ejecutar sin problemas los 3 clientes y el backend, puede instalar el scaffold complemento para la CLI de Vonage:

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

Una vez instalada, puedes arrancar la V-App utilizando el siguiente comando, especificando qué clientes quieres descargar:

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

Puede ejecutar el comando help para ver las diferentes opciones disponibles:

vonage scaffold:vapp --help

Como la CLI de Vonage ya está autenticada con Vonage, el plugin puede crear una nueva aplicación de Vonage y configurar los webhooks listos para ser utilizados por la V-App. También se descargan los clientes y se instalan sus dependencias:

El plugin también despliega el cliente backend localmente usando docker, y configura los clientes con la URL del despliegue:

Prueba la V-App y únete a la conversación en nuestra Vonage Vonage o envíanos un mensaje en Twitter.