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 10 o posterior
  • iOS 10.2 o posterior

Añade el SDK a tu proyecto iOS

Abre Xcode con tu proyecto iOS.

Puede instalar el Client SDK directamente o a través de CocoaPods.

CocoaPods

  1. Abra el archivo PodFile. Si aún no lo tienes, abre un terminal y ejecuta los siguientes comandos:

    $ cd 'Project Dir'
$ pod init

    Dónde Project Dir es la ruta al directorio padre del PodFile.

  2. Debajo de su objetivo añada NexmoClient vaina. Sustituir TargetName con el nombre real de tu objetivo.

    Asegúrese de que el archivo pod tiene la fuente del repositorio público CocoaPod specs.

  3. Instale el Pod abriendo un terminal y ejecutando el siguiente comando:

    $ cd 'Project Dir'
$ pod update

    Dónde Project Dir es la ruta al directorio padre del PodFile.

  4. Abra el xcworkspace con Xcode y desactivar bitcode para su objetivo.

  5. En su código, importe el archivo NexmoClient biblioteca:

import NexmoClient

Añadir permisos

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:Bool) in
        NSLog("Allow microphone use. Response: %d", granted)
    }
}

AppDelegate es el mejor lugar para hacerlo.

Uso del cliente en su aplicación

Inicio de sesión

Crear un NXMClient e inicie sesión con un jwt token de usuario. Si es necesario, puede leer más sobre generar el JWT.

let client = NXMClient.shared
client.setDelegate(self)
client.login(withAuthToken: "your token")

Note that `self` should implement the `NXMClientDelegate` protocol.

Estado de la conexión

Cuando el inicio de sesión se realiza correctamente, se llama al siguiente método delegado con NXMConnectionStatusConnected:

func client(_ client: NXMClient, didChange status: NXMConnectionStatus, reason: NXMConnectionStatusReason)

Puede comprobar si el estado de la conexión es conectado con isConnected:

var clientIsConnected: Bool = NXMClient.shared.isConnected()

isConnected será el último estado de conexión del cliente si su aplicación está suspendida en segundo plano. Por lo tanto, el valor de isConnected puede ser rancio.

Obtener información del usuario actual

Después de que el inicio de sesión tenga éxito, el usuario conectado estará disponible a través de:

let user = client.user

Conclusión

Ha añadido el Client SDK a su aplicación iOS y ha iniciado sesión en una aplicación NXMClient instancia. Ahora puede utilizar la función NXMClient en su aplicación y utilice las funciones del Client SDK.

Ver también