Übersicht

In dieser Anleitung erfahren Sie, wie Sie das Client SDK zu Ihrer iOS-App hinzufügen.

Voraussetzungen

Um das Vonage SDK für iOS verwenden zu können, müssen Sie Folgendes installiert haben:

  • Xcode 10 oder höher
  • iOS 10.2 oder höher

Fügen Sie das SDK zu Ihrem iOS-Projekt hinzu

Öffnen Sie Xcode mit Ihrem iOS-Projekt.

Sie können das Client SDK entweder direkt oder über CocoaPods installieren.

CocoaPods

  1. Öffnen Sie Ihr Projekt PodFile. Wenn Sie noch keine haben, öffnen Sie ein Terminal und führen Sie die folgenden Befehle aus:

    $ cd 'Project Dir'
$ pod init

    Wo Project Dir ist der Pfad zum übergeordneten Verzeichnis der PodFile.

  2. Fügen Sie unter Ihrem Ziel die NexmoClient pod. Ersetzen Sie TargetName mit Ihrem tatsächlichen Zielnamen.

    Stellen Sie sicher, dass die Pod-Datei die öffentliche CocoaPod specs-Repository-Quelle enthält.

  3. Installieren Sie den Pod, indem Sie ein Terminal öffnen und den folgenden Befehl ausführen:

    $ cd 'Project Dir'
$ pod update

    Wo Project Dir ist der Pfad zum übergeordneten Verzeichnis der PodFile.

  4. Öffnen Sie die xcworkspace mit Xcode und deaktivieren bitcode für Ihr Ziel.

  5. Importieren Sie in Ihrem Code die NexmoClient Bibliothek:

import NexmoClient

Berechtigungen hinzufügen

Um die In-App Voice-Funktionen nutzen zu können, müssen Sie Audio-Berechtigungen hinzufügen:

  1. In Ihrem Info.plist fügen Sie eine neue Zeile mit "Datenschutz - Beschreibung der Mikrofonverwendung" und eine Beschreibung für die Verwendung des Mikrofons hinzu. Zum Beispiel, Audio Calls.

  2. Fügen Sie in Ihrem Code eine Anforderung für Audio-Berechtigungen hinzu:

import AVFoundation

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

AppDelegate ist der beste Ort, um dies zu tun.

Verwendung des Clients in Ihrer Anwendung

Anmeldung

Erstellen einer NXMClient Objekt und Anmeldung mit einer jwt Benutzer-Token. Falls erforderlich, können Sie mehr über Generierung des JWT.

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

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

Status der Verbindung

Bei einer erfolgreichen Anmeldung wird die folgende Delegatenmethode mit NXMConnectionStatusConnected:

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

Sie können überprüfen, ob der Verbindungsstatus verbunden ist mit isConnected:

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

isConnected wird der letzte Verbindungsstatus des Clients sein, wenn Ihre Anwendung im Hintergrund angehalten wird. Daher ist der Wert für isConnected kann schal sein.

Aktuelle Benutzerinformationen abrufen

Nachdem die Anmeldung erfolgreich war, ist der angemeldete Benutzer über verfügbar:

let user = client.user

Schlussfolgerung

Sie haben das Client SDK zu Ihrer iOS-App hinzugefügt und sich bei einem NXMClient Instanz. Sie können nun die NXMClient Client in Ihrer Anwendung und nutzen Sie die Funktionen des Client SDK.

Siehe auch