Einführung der neuen Vonage Client SDKs für Android und iOS

Das Vonage Client SDK hat einen neuen Paketnamen! Mit diesem neuen Namen kommt eine neue Hauptversion mit vielen neuen Funktionen und Korrekturen. Unter der Haube nutzt das SDK jetzt Kotlin Multiplatform, um den Code der Kernfunktionen zwischen den nativen Android- und iOS-SDKs zu teilen

Wie Sie mit dem SDK beginnen können, erfahren Sie hier.

Hinzufügen des SDK

Wie bereits erwähnt, hat das SDK jetzt einen neuen Namen. Um das SDK zu Ihrer Anwendung hinzuzufügen, müssen Sie Folgendes tun:

Android

Fügen Sie die Abhängigkeit in die build.gradle Datei hinzu:

implementation 'com.vonage:client-sdk-voice'

iOS

Fügen Sie die Abhängigkeit zu Ihrem App's Podfile:

pod 'VonageClientSDKVoice'

Zentrale Concepts

Bei der Arbeit mit dem SDK gibt es einige Concepts, mit denen Sie vertraut sein müssen.

Sitzung

Eine Sitzung ist ein Live-Kommunikationsstrom zwischen dem SDK und den Vonage-Servern. Wie Sie eine Sitzung erstellen, erfahren Sie weiter unten in diesem Blog.

Einladen

Eine Einladung wird an das SDK gesendet, wenn der aktuelle Benutzer zur Teilnahme an einem Anruf eingeladen wurde. Die Listener/Delegate-Funktion für Einladungen enthält die erforderlichen Informationen über einen Anruf. Einladungen können entweder angenommen oder abgelehnt werden.

Rufen Sie an.

Sobald Sie eine Einladung erfolgreich angenommen haben, erhalten Sie eine Anruf-ID. Mit dieser ID können Sie Änderungen an dem Sprachanruf vornehmen, indem Sie die verfügbaren Funktionen nutzen. So können Sie z. B. den Anruf auflegen, stummschalten oder Text-to-Speech verwenden.

Bein

Eine Teilstrecke ist eine Verbindung zwischen einem Benutzer und einem Anruf, jeder Teilstrecke wird eine ID zugewiesen. Ein Anruf setzt sich aus mehreren Teilstrecken zusammen. Im Falle eines Anrufs zwischen zwei SDK-Benutzern wäre also die Verbindung zwischen Benutzer A und Vonage die Teilstrecke 1 und die Verbindung zwischen Benutzer B und Vonage die Teilstrecke 2. Der Anruf ist eine Verbindung zwischen Leg 1 und 2.

Erstellen einer Sitzung

Nachdem Sie nun die wichtigsten Concepts kennen, wollen wir uns ansehen, wie Sie das SDK verwenden. Bevor Sie einen Anruf tätigen, müssen Sie eine Sitzung erstellen. Sie können eine Sitzung mit der createSession Funktion.

Android

val config = ClientConfig(ConfigRegion.US) 
val client = VoiceClient(this.application.applicationContext)
client.setConfig(config)

client.createSession("JWT") { err, sessionID ->
    if err == null {
    // Connected!
    }
}

iOS

let config = VGClientConfig(region: .US) 
let client = VGVoiceClient()
client.setConfig(config)

client.createSession("JWT") { error, sessionID in
    if error == nil {
    // Connected!
    }
}

Diese Funktion nimmt ein JWT um den Benutzer zu identifizieren, zu dem die Sitzung gehören würde. Sehen Sie sich den JWT-Leitfaden für weitere Informationen über die Erstellung von JWTs zur Verwendung mit dem Client SDK.

Anrufe tätigen

Nachdem Sie erfolgreich eine Sitzung erstellt haben, können Sie nun einen Aufruf mit der serverCall Funktion:

Android

client.serverCall(mapOf("to" to "CALLEE")) { err, callID ->
    if err == null {
    // Connected to the call!
    }
}

iOS

client.serverCall(["to": "CALLEE"]) { error, callID in
    if error == nil {
    // Connected to the call!
    }
}

serverCall stellt eine HTTP-Anfrage (über die Vonage-Server) an die in Ihrer Vonage-Anwendung angegebene Antwort-URL. Ihre Antwort-URL muss mit einem Anrufsteuerungsobjekt zurück, das Vonage mitteilt, wie der Anruf zu behandeln ist.

Entgegennahme eines Anrufs

Lassen Sie uns sehen, wie es auf der anderen Seite aussieht, wenn Sie einen Anruf erhalten:

Android

Unter Android können Sie den Listener für die Anrufeinladung festlegen, der ausgeführt wird, wenn das SDK eine Einladung erhält:

client.setCallInviteListener { callId, from, channelType ->
    client.answer(it) { err ->
        if err == null {
        // Connected to the call!
        }
    }
}

iOS

Stellen Sie unter iOS sicher, dass Sie den VGVoiceClientDelegat mit client.delegate = self zu setzen. Wenn das SDK eine Einladung erhält, wird die didReceiveInviteForCall Funktion auf der VGVoiceClientDelegate aufgerufen werden:

func voiceClient(_ client: VGVoiceClient, didReceiveInviteForCall callId: String, from caller: String, withChannelType type: String) {
    client.answer(callId) { error in
        if error == nil {
        // Connected to the call!
        }
    }
}

Push-Benachrichtigungen

Das neue Vonage Client SDK hat Push-Benachrichtigungen zum Standard für den Empfang eingehender Anrufe gemacht, um sicherzustellen, dass alle Anrufe von den Geräten empfangen werden, unabhängig davon, ob sich Ihre Anwendung im Vordergrund befindet oder nicht. Um das oben beschriebene Verhalten zu erreichen, müssen Sie WebSocket Invites in der Konfiguration Ihres Clients aktivieren:

config.enableWebsocketInvites = true

Ausführlichere Informationen zur Konfiguration von Push-Benachrichtigungen für das Vonage Client SDK finden Sie in den neuen Anleitungen zu Push-Benachrichtigungen für Android und iOS.

Was kommt als Nächstes?

Erfahren Sie mehr über das Vonage Client SDK auf developer.vonage.comwo Sie auch das Schritt-für-Schritt-Tutorial wie Sie ausgehende Anrufe tätigen.