Visión general

En esta guía aprenderás a añadir el Client SDK a tu aplicación de Android.

Requisitos previos

El Client SDK requiere un nivel mínimo de API de Android de 23.

Para añadir el Client SDK a su proyecto

Abre tu proyecto de Android

Abre el código fuente de tu proyecto de Android en tu IDE.

Añadir dependencias

El Vonage Client SDK en Android se distribuye en tres SDK independientes. com.vonage.client-sdk-voice para la función de In-App Voice integrada en la aplicación, com.vonage.client-sdk-chat para la funcionalidad de mensajería dentro de la aplicación, y combinado como com.vonage.client-sdk. com.vonage.client-sdk-chat no incluye la dependencia de WebRTC, por lo que es una biblioteca más pequeña. Solo debes utilizar un SDK a la vez en tu aplicación.

  • In-App Voice y In-App Messaging dentro de la aplicación: instalar com.vonage.client-sdk sólo.

  • In-App Voice - instalar com.vonage.client-sdk-voice sólo.

  • In-App Messaging - instalar com.vonage.client-sdk-chat sólo.

Aviso de caducidad del producto
A partir del 30 de abril de 2026, Vonage In-App Messaging dejará de estar disponible. Se cerrará el acceso para nuevos usuarios y se interrumpirá el servicio para todos los usuarios existentes.
Si tiene alguna pregunta sobre la retirada de este producto, póngase en contacto con su gestor de Account o con nuestro equipo de asistencia.

NOTA: Hay dos lenguajes utilizados para definir los scripts de construcción de Gradle - Groovy (build.gradle archivo) y el script de Gradle de Kotlin (build.gradle.kts (archivo). Un proyecto de Kotlin-Android puede seguir utilizando Groovy como lenguaje para los scripts de compilación. Comprueba la extensión del archivo para determinar el lenguaje de los archivos de scripts de compilación.

Ahora añade el Client SDK a tu proyecto. Añade la siguiente dependencia en el nivel de tu aplicación build.gradle archivo (normalmente app/build.gradle):

dependencies {
    implementation 'com.vonage:client-sdk:1.6.0'
}

Puede que necesite aumentar la asignación de memoria para la JVM editando el archivo org.gradle.jvmargs propiedad en tu gradle.properties archivo. Recomendamos que sea de al menos 4 GB:

org.gradle.jvmargs=-Xmx4096m -Dfile.encoding=UTF-8

Establecer Java 1.8

Establezca Java 1.8 en el nivel de su aplicación build.gradle o build.gradle.kts archivo (normalmente app/build.gradle o app/build.gradle.kts):

android {
   
   // ...

   compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
   }

   // Only for Kotlin projects
   kotlinOptions {
       jvmTarget = JavaVersion.VERSION_1_8.toString()
   }
}

Añadir permisos

Para utilizar las funciones In-App Voice, añade permisos de audio mediante el siguiente procedimiento:

  1. Añada los permisos necesarios al AndroidManifest.xml archivo:

Permisos de tiempo de ejecución

  • Para los dispositivos que ejecutan Android versión 6.0 Marshmallow (nivel de API 23) o superior, debe solicitar la aplicación RECORD_AUDIO permiso en tiempo de ejecución:
  • En el caso de los dispositivos que ejecuten la versión 12 de Android (nivel de API 31) o superior, también debes solicitar el READ_PHONE_STATE permiso en tiempo de ejecución:

Más información sobre la solicitud de permisos de ejecución en Android aquí.

Normas ProGuard

Si utilizas ProGuard, tendrás que configurar la herramienta para que omita el Vonage Client SDK. No se recomienda reducir el tamaño ni ofuscar el Vonage Client SDK, ya que podría provocar conflictos con otras bibliotecas. La configuración recomendada de ProGuard es la siguiente:

-keep class org.webrtc.**  { *; }
-keep class org.vonage.**  { *; }
-keep class com.vonage.**  { *; }

La configuración anterior obliga a mantener el código fuente del Vonage Client SDK tal como está, al tiempo que permite reducir el tamaño del resto de la aplicación. El compilador realiza automáticamente un conjunto de optimizaciones por defecto, pero es posible habilitar optimizaciones adicionales que pueden requerir que incluyas reglas ProGuard adicionales para evitar problemas en tiempo de ejecución. Puede hacerlo añadiendo lo siguiente en el archivo de propiedades gradle del proyecto:

android.enableR8.fullMode=true

Para obtener más información sobre cómo optimizar tu aplicación para Android, consulta la página oficial Documentación de Android.

Cómo utilizar el Client SDK en tu aplicación

Una vez instalado el Client SDK y solicitados los permisos de audio, ya puede empezar a utilizarlo.

Crear una sesión

Las sesiones son un flujo de comunicación en vivo entre el Client SDK y los servidores de Vonage. Crear una VoiceClient y, a continuación, crear una sesión con un usuario JWT simbólico.

Si la creación de la sesión se realiza correctamente, recibirá un identificador de sesión.

Estado de la sesión

Si se produce algún error con la sesión una vez creada correctamente, se te notificarán en el SessionErrorListener en el VoiceClient objeto.

Conclusión

Has añadido el Client SDK a tu aplicación de Android y has creado una sesión. Ahora puedes utilizar el VoiceClient en su aplicación y utilice las funciones del Client SDK.

Véase también