Einrichtung
Installieren Sie das Client SDK für Ihre Zielplattform, bevor Sie eine Sitzung erstellen.
Systemanforderungen
| Plattform | Mindestversion | Erforderliche Berechtigungen |
|---|---|---|
| Android | SDK 23 (Android 6.0) | INTERNET, RECORD_AUDIO |
| iOS | iOS 15.0 | Verwendung des Mikrofons (NSMicrophoneUsageDescription (in der Datei „Info.plist“) |
| Web | Moderne Browser mit WebRTC-Unterstützung (Chrome 70+, Firefox 60+, Safari 14.1+, Edge 79+) | Zugriff auf das Mikrofon (Anfrage über den Browser) |
Warnung: Versionsbindung in der Produktionsumgebung
In den folgenden Beispielen wird latest.release (Android) und @latest (CDN) der Einfachheit halber. In Produktionsanwendungen sollten Sie stets eine bestimmte Version festlegen (z. B. com.vonage:client-sdk-voice:2.3.1 oder @vonage/client-sdk@2.3.1), um reproduzierbare Builds zu gewährleisten und unerwartete, kompatibilitätsbeeinträchtigende Änderungen bei einem Upgrade zu vermeiden. Überprüfen Sie die Änderungsliste die Versionshinweise vor dem Upgrade.
NPM
Installieren Sie das Paket mit dem Paketmanager Ihrer Wahl:
Importieren Sie anschließend das Client SDK:
import clientSDK from '@vonage/client-sdk';
CDN
<script src="https://cdn.jsdelivr.net/npm/@vonage/client-sdk@latest/dist/vonageClientSDK.min.js"></script>
Mikrofonzugang
Der Browser fordert den Nutzer bei einem Anruf auf, die Berechtigung für das Mikrofon zu erteilen. Es ist weder ein Manifest noch eine Konfiguration erforderlich, allerdings muss die Seite über HTTPS (oder localhost) bereitgestellt werden, damit getUserMedia verfügbar sein.
- Stellen Sie sicher, dass Maven Central in Ihren Repositories verfügbar ist:
dependencyResolutionManagement {
repositories {
mavenCentral()
}
}
- Fügen Sie die Abhängigkeit „Voice SDK“ hinzu:
dependencies {
implementation("com.vonage:client-sdk-voice:latest.release")
}
- Fügen Sie die erforderlichen Berechtigungen zu Ihrer
AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
Außerdem müssen Sie Folgendes beantragen RECORD_AUDIO zur Laufzeit, bevor Anrufe getätigt oder angenommen werden (Android 6.0+).
CocoaPods
Fügen Sie das Client SDK zu Ihrer Podfile hinzu:
target 'YourApp' do
use_frameworks!
pod 'VonageClientSDKVoice'
end
Swift Package Manager
- Wählen Sie in Xcode Datei -> Paketabhängigkeiten hinzufügen...
- Verwenden Sie
https://github.com/Vonage/vonage-client-sdk-ios - Wählen Sie Ihre Versionsregel aus und fügen Sie das Paket Ihrem Ziel hinzu
Linker Flag
Satz -ObjC in der Ziel-Datei Build-Einstellungen -> Weitere Linker-Flags (Debug und Release).
Microphone Permission
Fügen Sie die Beschreibung zur Verwendung des Mikrofons zu Ihrer Info.plist:
<key>NSMicrophoneUsageDescription</key>
<string>Required for voice calls</string>
Ohne diesen Eintrag beendet iOS Ihre App, sobald das SDK den Zugriff auf das Mikrofon anfordert.