Visión general

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

Requisitos previos

Para usar el SDK de Vonage para iOS, debes tener instalado lo siguiente:

  • Xcode
  • iOS 13 o posterior

Añadir el Client SDK al proyecto iOS

El Client SDK de Vonage para iOS se distribuye en 3 SDK separados. VonageClientSDKVoice para la funcionalidad de voz dentro de la aplicación, VonageClientSDKChat para la funcionalidad de mensajería dentro de la aplicación, y combinado como VonageClientSDK. VonageClientSDKChat 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 - Instalar VonageClientSDK sólo.

  • In-App Voice - instalar VonageClientSDKVoice sólo.

  • In-App Messaging - instalar VonageClientSDKChat 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.

Puede instalar el Client SDK a través de Swift Package Manager o CocoaPods.

  1. Después de crear su aplicación en Xcode, haga clic en Archivo > Añadir dependencias de paquetes...
Add Package Dependencies

  1. En el cuadro de búsqueda, pega la URL del Vonage Client SDK: https://github.com/Vonage/vonage-client-sdk-ios

  2. Elija su regla de dependencia, puede especificar un rango de versiones, una versión exacta o la rama principal.

Vonage Client SDK version
  1. Añade la dependencia, Xcode descargará ahora el SDK. Una vez completado, elija qué SDK desea añadir.
Choosing which Vonage Client SDK

Nota: Como se ha mencionado anteriormente, sólo puede incluir un SDK a la vez.

  1. Haga clic en su objetivo de compilación en Xcode, vaya a Ajustes de construcción. A continuación, busque Otros indicadores del enlazador. Añada el -ObjC tanto para la configuración de depuración como para la de liberación.
Other Linker Flags

Añadir permisos (Voz)

Para utilizar las funciones de voz de la aplicación, tienes que añadir permisos de audio:

  1. En su Info.plist añada una nueva fila con "Privacidad - Descripción del uso del micrófono" y una descripción del uso del micrófono. Por ejemplo Audio Calls.

  2. En tu código añade una petición de Permisos de Audio:

import AVFoundation

func askAudioPermissions() {
    AVAudioSession.sharedInstance().requestRecordPermission { granted in
        print("Allow microphone use. Response: ", granted)
    }
}

En AppDelegate es el mejor lugar para hacerlo.

Uso del Client SDK en su 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 VGVonageClient y, a continuación, crear una sesión con un usuario JWT simbólico.

let client = VGVonageClient()
client.delegate = self

client.createSession("JWT_TOKEN") { error, sessionId in
    ...
}

Si la creación de la sesión se realiza correctamente, recibirá un identificador de sesión. Tenga en cuenta que self debe aplicar el VGClientDelegate/VGVoiceClientDelegate/VGVoiceClientDelegate dependiendo del SDK que haya instalado.

Estado de la sesión

Si se produce algún error con la sesión después de que se haya creado correctamente, lo recibirá en la pantalla didReceiveSessionErrorWithReason en el VGVoiceClientDelegate.

extension ViewController: VGClientDelegate {

    func client(_ client: VGBaseClient,
    didReceiveSessionErrorWith reason: VGSessionErrorReason) {
        // Session Error
    }

    ...
}

Conclusión

Ha añadido el Client SDK a su aplicación iOS y ha creado una sesión. Ahora puede utilizar las funciones del Client SDK.

Ver también