Unterstützung der neuen Architektur von OpenTok React Native
Die Version 2.31.0-beta.2 des OpenTok React Native SDK unterstützt die React Native neue Architektur. Für weitere Informationen, diese Dokumentation.
Die Version 2.31.0-beta.2 unterstützt Client SDK-Updates für 2.31.0. Siehe die Liste der bekannte Probleme.
Diese Betaversion ist nicht für die Verwendung in endgültigen Produktionsanwendungen vorgesehen.
Die Version 2.31 wird nur in der neuen Architektur von React Native unterstützt. Sie wird nicht in Apps unterstützt, die die alte Architektur verwenden.
Systemanforderungen
Version 2.31 des OpenTok React Native SDK wird nur in der React Native neue Architektur. Falls Ihre App mit einer Version von React Native ausgeführt werden muss, die die neue Architektur nicht nutzt, müssen Sie eine ältere Version des OpenTok React Native SDK verwenden (z. B. Version 2.30).
Einrichtung
Sie können diese Beta-Version von npmjs installieren:
... oder ...
Die Installationsschritte für Android und iOS sind im Wesentlichen dieselben wie bei früheren Versionen. Bei dieser Version müssen Sie jedoch die OpenTok-Pakete in Ihren Applications registrieren.
Für Android, registrieren Sie die OpentokReactNativePackage, OTPublisherViewNativePackageund OTSubscriberViewNativePackage Pakete in der MainActivity-Datei für Ihre App. Siehe Schritt 6 des Abschnitts "Android-Installation" unten.
Für iOS, registrieren Sie die OpentokReactNativePackage, OTPublisherViewNativePackageund OTSubscriberViewNativePackage Pakete in der MainActivity-Datei für Ihre App. Siehe Schritt 4 des Abschnitts "iOS-Installation" unten.
iOS-Installation
-
Installieren Sie die iOS-Pods:
Kopierennpx pod-install -
Für React Native-Versionen vor 0.60:
-
Fügen Sie dies zu Ihrem Podfile hinzu:
Kopierentarget '<YourProjectName>' do # Pods for <YourProject> pod 'OTXCFramework', '2.30.1' end -
ausführen.
react-native link opentok-react-native.
Diese Schritte sind in React Native Version 0.60 und höher nicht notwendig.
-
-
Stellen Sie sicher, dass Sie sowohl die Kamera- als auch die Mikrofonverwendung aktiviert haben, indem Sie die folgenden Einträge in die
Info.plistDatei:Kopieren<key>NSCameraUsageDescription</key> <string>Your message to user when the camera is accessed for the first time</string> <key>NSMicrophoneUsageDescription</key> <string>Your message to user when the microphone is accessed for the first time</string>
Wenn Sie ein Archiv Ihrer Anwendung erstellen, wird die Einstellungen für das Datenschutzmanifest, die von Apples App Store verlangt werden werden mit dieser Version des OpenTok React Native SDK automatisch hinzugefügt.
-
Registrieren Sie die OpenTok-Klassen „OTPublisherViewNative“ und „OTSubscriberViewNative“. Ändern Sie dazu die Implementierung von „AppDelegate“.
- Wenn Ihre Anwendung über eine Objective-C++ AppDelegate-Datei (AppDelegate.mm) verfügt, fügen Sie diese Klassen der Liste der Pakete im NSMutableDictionary hinzu, das von der Funktion
thirdPartyFabricComponents()Funktion:
Kopieren#import "OTPublisherViewNativeComponentView.h" #import "OTSubscriberViewNativeComponentView.h" @implementation AppDelegate // ... - (NSDictionary> *)thirdPartyFabricComponents { NSMutableDictionary * dictionary = [super thirdPartyFabricComponents].mutableCopy; dictionary[@"OTPublisherViewNative"] = [OTPublisherViewNativeComponentView class]; dictionary[@"OTSubscriberViewNative"] = [OTSubscriberViewNativeComponentView class]; return dictionary; } @end- Wenn Ihre Anwendung eine Swift-AppDelegate-Datei (AppDelegate.swift) verwendet, müssen Sie deren Implementierung der
RCTAppDelegate.application(_, didFinishLaunchingWithOptions)Methode einen Bridging-Header verwenden, um eine Methode in einer Objective-C++-Datei aufzurufen, die die[RCTComponentViewFactory registerComponentViewClass:]Methode und übergibt dabei dieOTPublisherViewNativeComponentViewundOTSubscriberViewNativeComponentViewKlassen.
- Wenn Ihre Anwendung über eine Objective-C++ AppDelegate-Datei (AppDelegate.mm) verfügt, fügen Sie diese Klassen der Liste der Pakete im NSMutableDictionary hinzu, das von der Funktion
-
Wenn Ihre Anwendung die
OTPublisher.setVideoTransformers()oderOTPublisher.setAudioTransformers()Methode zu verwenden, müssen Sie Folgendes in Ihr Podfile aufnehmen:Kopierenpod 'VonageClientSDKVideoTransformers'
Wenn Sie versuchen, die Anwendung zu archivieren und dies fehlschlägt, gehen Sie bitte wie folgt vor:
-
Gehe zu Ziel.
-
Klicken Sie auf Bauphasen.
-
Im Rahmen der Binär mit Bibliotheken verknüpfen Abschnitt, entfernen
libOpenTokReactNative.aund fügen Sie es wieder hinzu.
Android-Installation
-
Wechseln Sie in Ihrem Terminal in Ihr Projektverzeichnis.
-
Für React Native-Versionen vor 0.60:
- ausführen.
react-native link opentok-react-native
Dieser Schritt ist in React Native Version 0.60 und höher nicht notwendig.
- ausführen.
-
ausführen.
bundle install. -
Stellen Sie sicher, dass in der gradle-Datei Ihrer Anwendung
compileSdkVersion,buildToolsVersion,minSdkVersionundtargetSdkVersionsind größer oder gleich den in der OpenTok React Native-Bibliothek angegebenen Versionen. -
Das SDK fügt automatisch die erforderlichen Android-Berechtigungen hinzu. Sie müssen diese nicht zu Ihrem App-Manifest hinzufügen. Bei bestimmten Berechtigungen müssen Sie den Benutzer jedoch dazu auffordern. Siehe die vollständige Liste der erforderlichen Genehmigungen in der Vonage Video API Android SDK Dokumentation.
-
Registrieren Sie in der Datei „MainActivity.kt“ Ihrer App die OpenTok-Pakete „OpentokReactNativePackage“, „OTPublisherViewNativePackage“ und „OTSubscriberViewNativePackage“. Fügen Sie dazu in der Datei „MainApplication“ diese Pakete zur Liste der Pakete hinzu, die von der
getPackages()FunktionKopierenoverride fun getPackages(): List<ReactPackage> = PackageList(this).packages.apply { add(OTPublisherViewNativePackage()) add(OTSubscriberViewNativePackage()) add(OpentokReactNativePackage()) } // ... -
Wenn Ihre Anwendung die
OTPublisher.setVideoTransformers()oderOTPublisher.setAudioTransformers()Methode zu verwenden, müssen Sie Folgendes in Ihre app/build.gradle-Datei aufnehmen:Kopierenimplementation "com.vonage:client-sdk-video-transformers:2.30.1"
Bekannte Probleme
Die folgenden Probleme sind in dieser Betaversion bekannt:
- Bei der Verwendung von VP9 oder H264 frieren die Videos der Teilnehmer häufig ein.
otrnErrorEreignisse fehlen.