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
• iOS 13 ou ultérieur

Ajouter le Client SDK à votre projet iOS

Le Client SDK de Vonage sur iOS est distribué sous la forme de 3 SDK distincts. VonageClientSDKVoice pour la fonctionnalité vocale in-App Voice, VonageClientSDKChat pour la fonctionnalité In-App Messaging, et combinée en tant que VonageClientSDK. VonageClientSDKChat n'inclut pas la dépendance WebRTC, il s'agit donc d'une bibliothèque plus petite. Vous ne devez utiliser qu'un seul SDK à la fois dans votre application.

• In-App Voice et In-App Messaging - installation VonageClientSDK seulement.

• In-App Voice - installer VonageClientSDKVoice seulement.

• In-App Messaging - installation VonageClientSDKChat seulement.

Vous pouvez installer le Client SDK via le gestionnaire de paquets Swift ou CocoaPods.

1. Après avoir créé votre application dans Xcode, cliquez sur Fichier > Ajouter les dépendances du paquet...

2. Dans la boîte de recherche, collez l'URL du Vonage Client SDK : https://github.com/Vonage/vonage-client-sdk-ios

3. Choisissez votre règle de dépendance, vous pouvez spécifier une fourchette de versions, une version exacte ou la branche principale.

4. Ajoutez la dépendance, Xcode va maintenant télécharger le SDK. Une fois le téléchargement terminé, choisissez le SDK à ajouter.

Remarque : comme indiqué précédemment, vous ne pouvez inclure que les éléments suivants un SDK à la fois.

5. Cliquez sur votre cible de construction dans Xcode, allez à Paramètres de construction. Rechercher ensuite Autres drapeaux de l'éditeur de liens. Ajouter le -ObjC pour les configurations Debug et Release.

Ajouter des autorisations (voix)

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

Les AppDelegate est le meilleur endroit pour le faire.

Utiliser le Client SDK dans votre application

Maintenant que vous avez installé le Client SDK et demandé les autorisations audio, vous pouvez commencer à l'utiliser.

Créer une session

Les sessions sont un flux de communication en direct entre le Client SDK et les serveurs de Vonage. Créer une VGVonageClient puis créer une session avec un utilisateur JWT de l'argent.

let client = VGVonageClient()
client.delegate = self

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

Si la création de la session est réussie, vous recevrez un identifiant de session. Notez que self doit mettre en œuvre le VGClientDelegate/VGVoiceClientDelegate/VGVoiceClientDelegate en fonction du SDK que vous avez installé.

Statut de la session

Si la session comporte des erreurs après avoir été créée avec succès, vous les recevrez sur la page d'accueil de la session. didReceiveSessionErrorWithReason sur la fonction déléguée VGVoiceClientDelegate.

extension ViewController: VGClientDelegate {

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

    ...
}

Conclusion

Vous avez ajouté le Client SDK à votre application iOS et créé une session. Vous pouvez maintenant utiliser les fonctionnalités du Client SDK.

Voir aussi

• Configuration du centre de données - il s'agit d'une configuration optionnelle avancée que vous pouvez effectuer après avoir ajouté le SDK à votre application.