Prise en charge de la nouvelle architecture OpenTok React Native
La version 2.31.0-beta.2 du SDK OpenTok pour React Native prend en charge la Nouvelle architecture React Native. Pour plus d'informations, cette documentation.
La version 2.31.0-beta.2 prend en charge les mises à jour du Client SDK pour la version 2.31.0. Consultez la liste des problèmes connus.
Cette version bêta n'est pas destinée à être utilisée dans des applications de production finales.
La version 2.31 ne sera prise en charge que dans la nouvelle architecture de React Native. Elle ne sera pas prise en charge dans les applications utilisant l'ancienne architecture.
Exigences du système
La version 2.31 du SDK OpenTok pour React Native n'est prise en charge que dans le Nouvelle architecture React Native. Si votre application doit fonctionner avec une version de React Native qui n'utilise pas la nouvelle architecture, vous devrez utiliser une version antérieure du SDK OpenTok pour React Native (par exemple, la version 2.30).
Installation
Vous pouvez installer cette version bêta depuis npmjs :
... ou ...
Les étapes d'installation sur Android et iOS sont globalement les mêmes que pour les versions précédentes. Toutefois, pour cette version, vous devez enregistrer les paquets OpenTok dans votre application.
Pour Android, enregistrez le OpentokReactNativePackage, OTPublisherViewNativePackageet OTSubscriberViewNativePackage les paquets dans le fichier MainActivity de votre application. Reportez-vous à l'étape 6 de la section « Installation Android » ci-dessous.
Pour iOS, enregistrez le OpentokReactNativePackage, OTPublisherViewNativePackageet OTSubscriberViewNativePackage les paquets dans le fichier MainActivity de votre application. Reportez-vous à l'étape 4 de la section « Installation sur iOS » ci-dessous.
Installation sur iOS
-
Installer les pods iOS :
Copienpx pod-install -
Pour les versions de React Native antérieures à la version 0.60:
-
Ajoutez ceci à votre Podfile :
Copietarget '<YourProjectName>' do # Pods for <YourProject> pod 'OTXCFramework', '2.30.1' end -
Exécuter
react-native link opentok-react-native.
Ces étapes ne sont pas nécessaires dans React Native version 0.60 et les versions ultérieures.
-
-
Assurez-vous d'avoir activé l'utilisation de la caméra et du microphone en ajoutant les entrées suivantes au fichier
Info.plistfichier :Copie<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>
Lorsque vous créez une archive de votre application, le fichier les paramètres du manifeste de confidentialité requis par l'App Store d'Apple sont ajoutés automatiquement avec cette version du SDK OpenTok pour React Native.
-
Enregistrez les classes OpenTok OTPublisherViewNative et OTSubscriberViewNative. Pour ce faire, modifiez l'implémentation de AppDelegate.
- Si votre application possède un fichier Objective-C++ AppDelegate (AppDelegate.mm), ajoutez ces classes à la liste des paquets dans le NSMutableDictionary renvoyé par la fonction
thirdPartyFabricComponents()fonction :
Copie#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- Si votre application utilise un fichier Swift AppDelegate (AppDelegate.swift), vous devrez avoir son implémentation de la fonction
RCTAppDelegate.application(_, didFinishLaunchingWithOptions)utilise un en-tête de transition pour appeler une méthode dans un fichier Objective-C++ qui appelle la méthode[RCTComponentViewFactory registerComponentViewClass:]en passant par la méthodeOTPublisherViewNativeComponentViewetOTSubscriberViewNativeComponentViewcours.
- Si votre application possède un fichier Objective-C++ AppDelegate (AppDelegate.mm), ajoutez ces classes à la liste des paquets dans le NSMutableDictionary renvoyé par la fonction
-
Si votre application utilise la fonction
OTPublisher.setVideoTransformers()ouOTPublisher.setAudioTransformers()vous devez inclure les éléments suivants dans votre fichier Podfile :Copiepod 'VonageClientSDKVideoTransformers'
Si vous essayez d'archiver l'application et que l'opération échoue, procédez comme suit :
-
Aller à Cible.
-
Cliquez sur Phases de construction.
-
En vertu de la Lier des binaires à des bibliothèques supprimer
libOpenTokReactNative.aet l'ajouter à nouveau.
Installation sur Android
-
Dans votre terminal, allez dans le répertoire de votre projet.
-
Pour les versions de React Native antérieures à la version 0.60:
- Exécuter
react-native link opentok-react-native
Cette étape n'est pas nécessaire dans React Native version 0.60 et les versions ultérieures.
- Exécuter
-
Exécuter
bundle install. -
Assurez-vous que les éléments suivants sont présents dans le gradle de votre application
compileSdkVersion,buildToolsVersion,minSdkVersionettargetSdkVersionsont supérieures ou égales aux versions spécifiées dans la bibliothèque OpenTok React Native. -
Le SDK ajoute automatiquement les autorisations Android dont il a besoin. Vous n'avez pas besoin de les ajouter au manifeste de votre application. Toutefois, pour certaines autorisations, vous devez demander à l'utilisateur de le faire. Voir la section liste complète des autorisations requises dans la documentation du SDK Android Video API de Vonage.
-
Dans le fichier MainActivity.kt de votre application, enregistrez les paquets OpenTok OpentokReactNativePackage, OTPublisherViewNativePackage et OTSubscriberViewNativePackage. Pour ce faire, modifiez le fichier MainApplication en les ajoutant à la liste des paquets renvoyée par le
getPackages()fonctionCopieoverride fun getPackages(): List<ReactPackage> = PackageList(this).packages.apply { add(OTPublisherViewNativePackage()) add(OTSubscriberViewNativePackage()) add(OpentokReactNativePackage()) } // ... -
Si votre application utilise la fonction
OTPublisher.setVideoTransformers()ouOTPublisher.setAudioTransformers()vous devez inclure les éléments suivants dans votre fichier app/build.gradle :Copieimplementation "com.vonage:client-sdk-video-transformers:2.30.1"
Problèmes connus
Voici les problèmes connus dans cette version bêta :
- La vidéo des abonnés se fige fréquemment lors de l'utilisation des formats VP9 ou H.264.
otrnErrorIl manque des événements.