OpenTokのReact Native向け新アーキテクチャのサポート

OpenTok React Native SDK のバージョン 2.31.0-beta.2 では、 リアクト・ネイティブの新アーキテクチャ. 詳細については、 本書.

バージョン 2.31.0-beta.2 では、2.31.0 向けの Client SDK の更新に対応しています。以下のリストを参照してください。 既知の問題.

このベータ版は、本番環境のアプリでの使用を目的としたものではありません。

バージョン 2.31 は、React Native の新アーキテクチャでのみサポートされます。旧アーキテクチャを使用しているアプリではサポートされません。

システム要件

OpenTok React Native SDK バージョン 2.31 は、以下の環境でのみサポートされています。 リアクト・ネイティブの新アーキテクチャ. アプリを、新しいアーキテクチャを採用していないバージョンのReact Nativeで実行する必要がある場合は、OpenTok React Native SDKの以前のバージョン(バージョン2.30など)を使用する必要があります。

インストール

このベータ版は npmjs からインストールできます:

npm install opentok-react-native@2.31.0-beta.2

…あるいは…

yarn add opentok-react-native@2.31.0-beta.2

Android および iOS へのインストール手順は、基本的に以前のバージョンと同じです。ただし、このバージョンでは、アプリケーションに OpenTok パッケージを登録する必要があります。

Androidの場合は、 OpentokReactNativePackage, OTPublisherViewNativePackageそして OTSubscriberViewNativePackage アプリの MainActivity ファイル内のパッケージ。以下の「Android のインストール」セクションの手順 6 を参照してください。

iOSの場合は、 OpentokReactNativePackage, OTPublisherViewNativePackageそして OTSubscriberViewNativePackage アプリの MainActivity ファイル内のパッケージ。以下の「iOS へのインストール」セクションの手順 4 を参照してください。

iOSへのインストール

  1. iOSポッドをインストールします:

    npx pod-install
    
  2. React Native 0.60 以前のバージョンについては:

    • Podfileに以下を追加してください:

      target '<YourProjectName>' do
          # Pods for <YourProject>
          pod 'OTXCFramework', '2.30.1'
      end
      
    • 走る react-native link opentok-react-native.

    React Native バージョン 0.60 以降では、これらの手順は不要です。

  3. に以下のエントリーを追加して、カメラとマイクの両方の使用が有効になっていることを確認してください。 Info.plist ファイル:

    <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>
    

アプリのアーカイブを作成する際に AppleのApp Storeが要求するプライバシー・マニフェストの設定 このバージョンの OpenTok React Native SDK では、自動的に追加されます。

  1. OpenTokのOTPublisherViewNativeクラスおよびOTSubscriberViewNativeクラスを登録します。これを行うには、AppDelegateの実装を修正してください。

    • アプリにObjective-C++ AppDelegateファイル(AppDelegate.mm)がある場合は、これらのクラスを thirdPartyFabricComponents() 関数である:
     #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
    
    • あなたのアプリが Swift AppDelegate ファイル (AppDelegate.swift) を使用する場合、その実装に RCTAppDelegate.application(_, didFinishLaunchingWithOptions) メソッドを呼び出すObjective-C++ファイルのメソッドを呼び出すには、ブリッジング・ヘッダーを使う。 [RCTComponentViewFactory registerComponentViewClass:] メソッドに OTPublisherViewNativeComponentView そして OTSubscriberViewNativeComponentView クラスである。
  2. あなたのアプリが OTPublisher.setVideoTransformers() または OTPublisher.setAudioTransformers() メソッドを使用する場合は、Podfileに以下を含める必要があります:

    pod 'VonageClientSDKVideoTransformers'
    

アプリをアーカイブしようとして失敗した場合は、以下の操作を行ってください:

  1. こちらへ ターゲット.

  2. クリック 建設段階.

  3. の下にある。 バイナリとライブラリのリンク セクションを削除する。 libOpenTokReactNative.a を追加する。

Androidのインストール

  1. ターミナルでプロジェクト・ディレクトリに移動する。

  2. React Native 0.60 以前のバージョンについては:

    • 走る react-native link opentok-react-native

    React Native バージョン 0.60 以降では、この手順は不要です。

  3. 走る bundle install.

  4. アプリのgradleで以下を確認してください。 compileSdkVersion, buildToolsVersion, minSdkVersionそして targetSdkVersion OpenTok React Native ライブラリで指定されているバージョン以上であること。

  5. SDK は、必要な Android パーミッションを自動的に追加します。アプリのマニフェストにこれらを追加する必要はありません。ただし、特定のパーミッションについては、ユーザーにプロンプトを表示する必要があります。以下を参照してください。 必要なパーミッションの全リスト の Vonage Video API Android SDK ドキュメントを参照してください。

  6. アプリの MainActivity.kt ファイルで、OpenTok の OpentokReactNativePackage、OTPublisherViewNativePackage、および OTSubscriberViewNativePackage パッケージを登録してください。これを行うには、MainApplication ファイルを修正し、 getPackages() 機能

    override fun getPackages(): List<ReactPackage> =
        PackageList(this).packages.apply {
            add(OTPublisherViewNativePackage())
            add(OTSubscriberViewNativePackage())
            add(OpentokReactNativePackage())
        }
        // ...
    
  7. あなたのアプリが OTPublisher.setVideoTransformers() または OTPublisher.setAudioTransformers() メソッドを呼び出すには、app/build.gradleファイルに以下をインクルードする必要がある:

    implementation "com.vonage:client-sdk-video-transformers:2.30.1"
    

既知の問題

このベータ版における既知の問題は以下の通りです:

  • VP9またはH264を使用している際、加入者向け動画が頻繁にフリーズします。
  • otrnError イベントが欠落しています。