Vue d'ensemble

Dans ce guide, vous apprenez à ajouter le Client SDK à votre application iOS.

Conditions préalables

Pour utiliser le SDK Vonage pour iOS, les éléments suivants doivent être installés :

  • Xcode 10 ou version ultérieure
  • iOS 10.2 ou version ultérieure

Ajouter le SDK à votre projet iOS

Ouvrez Xcode avec votre projet iOS.

Vous pouvez installer le Client SDK directement ou via CocoaPods.

CocoaPods

  1. Ouvrez le fichier PodFile. Si vous n'en avez pas encore, ouvrez un terminal et exécutez les commandes suivantes :

    $ cd 'Project Dir'
$ pod init

    Où Project Dir est le chemin d'accès au répertoire parent du PodFile.

  2. Sous votre cible, ajoutez le NexmoClient pod. Remplacer TargetName avec le nom de votre cible.

    target 'TargetName' do
    pod 'NexmoClient'
end

    Assurez-vous que le fichier pod a la source du dépôt public CocoaPod specs.

  3. Installez le Pod en ouvrant un terminal et en exécutant la commande suivante :

    $ cd 'Project Dir'
$ pod update

    Où Project Dir est le chemin d'accès au répertoire parent du PodFile.

  4. Ouvrir le xcworkspace avec Xcode et désactivez bitcode pour votre cible.

  5. Dans votre code, importez le fichier NexmoClient bibliothèque :

import NexmoClient

Ajouter des autorisations

Pour utiliser les fonctionnalités vocales in-app, vous devez ajouter des autorisations audio :

  1. Dans votre Info.plist ajoutez une nouvelle ligne intitulée "Confidentialité - Description de l'utilisation du microphone" et une description de l'utilisation du microphone. Par exemple, Audio Calls.

  2. Dans votre code, ajoutez une demande d'autorisations audio :

import AVFoundation

func askAudioPermissions() {
    AVAudioSession.sharedInstance().requestRecordPermission { (granted:Bool) in
        NSLog("Allow microphone use. Response: %d", granted)
    }
}

AppDelegate est le meilleur endroit pour le faire.

Utiliser le client dans votre application

Connexion

Créer un NXMClient et se connecter à l'aide d'un jwt le jeton d'utilisateur. Si nécessaire, vous pouvez en savoir plus sur générer le JWT.

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

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

État de la connexion

Lors d'une connexion réussie, la méthode de délégation suivante est appelée avec NXMConnectionStatusConnected:

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

Vous pouvez vérifier si l'état de la connexion est connecté avec isConnected:

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

isConnected sera le dernier état de connexion du client si votre application est suspendue en arrière-plan. Par conséquent, la valeur de isConnected peut être périmée.

Obtenir des informations sur l'utilisateur actuel

Une fois la connexion réussie, l'utilisateur connecté sera disponible via :

let user = client.user

Conclusion

Vous avez ajouté le Client SDK à votre application iOS, et vous vous êtes connecté à une application NXMClient de l'instance. Vous pouvez maintenant utiliser la fonction NXMClient dans votre application et utiliser les fonctionnalités du Client SDK.

Voir aussi