Instalación

Instala el Client SDK para tu plataforma de destino antes de crear una sesión.

Requisitos del sistema

Plataforma Versión mínima Permisos necesarios
Android SDK 23 (Android 6.0) INTERNET, RECORD_AUDIO
iOS iOS 15.0 Uso del micrófono (NSMicrophoneUsageDescription (en Info.plist)
Web Navegadores modernos compatibles con WebRTC (Chrome 70 o superior, Firefox 60 o superior, Safari 14.1 o superior, Edge 79 o superior) Acceso al micrófono (solicitado a través del navegador)

Advertencia: fijación de versiones en el entorno de producción En los ejemplos siguientes se utiliza latest.release (Android) y @latest (CDN), para simplificar. En aplicaciones de producción, hay que fijar siempre la versión (por ejemplo, com.vonage:client-sdk-voice:2.3.1 o @vonage/client-sdk@2.3.1) para garantizar que las compilaciones sean reproducibles y evitar cambios inesperados que provoquen errores al actualizar. Consulta el Registro de cambios para consultar las notas de la versión antes de actualizar.

NPM

Instálalo con el gestor de paquetes que prefieras:

npm i @vonage/client-sdk # or yarn add @vonage/client-sdk # or pnpm add @vonage/client-sdk # or bun add @vonage/client-sdk

A continuación, importa el Client SDK:

import clientSDK from '@vonage/client-sdk';

CDN

<script src="https://cdn.jsdelivr.net/npm/@vonage/client-sdk@latest/dist/vonageClientSDK.min.js"></script>

Acceso al micrófono

El navegador solicitará al usuario permiso para acceder al micrófono cuando se inicie una llamada. No se necesita ningún manifiesto ni configuración, pero la página debe servirse a través de HTTPS (o localhost) para getUserMedia estar disponible.

  1. Asegúrate de que Maven Central esté disponible en tus repositorios:
dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}
  1. Añade la dependencia del SDK de voz:
dependencies {
    implementation("com.vonage:client-sdk-voice:latest.release")
}
  1. Añade los permisos necesarios a tu AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

También debes solicitar RECORD_AUDIO en tiempo de ejecución, antes de realizar o responder llamadas (Android 6.0 y versiones posteriores).

CocoaPods

Añade el Client SDK a tu Podfile:

target 'YourApp' do
  use_frameworks!
  pod 'VonageClientSDKVoice'
end

Swift Package Manager

  1. En Xcode, selecciona Archivo -> Añadir dependencias de paquetes...
  2. Uso https://github.com/Vonage/vonage-client-sdk-ios
  3. Elige la regla de versión y añade el paquete a tu destino

Linker Flag

Conjunto -ObjC en el de tu objetivo Configuración de compilación -> Otras opciones del enlazador (Depuración y Versión final).

Microphone Permission

Añade la descripción del uso del micrófono a tu Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Required for voice calls</string>

Sin esta entrada, iOS cerrará tu aplicación cuando el SDK solicite acceso al micrófono.