- スポーツのマルチカメラビュー
- セキュリティカメラダッシュボード
- ピクチャーインピクチャー(PIP)レイアウト
- ビデオの並列比較
前提条件
W3Cメディアプレーヤーを使用するようにアプリを設定します。詳細については、メディアプレーヤーのセットアップを参照してください。サーフェスとプレーヤー
Vegaでのビデオの再生では、W3C Media APIの2つの部分を使用しており、いずれも@amazon-devices/react-native-w3cmediaからエクスポートされています:
KeplerVideoSurfaceView: レンダリングサーフェスを作成するReact Nativeコンポーネント。再生の管理は行いません。VideoPlayer: 初期化、ソースの読み込み、再生制御を処理する命令型クラスです。ハンドルを介してサーフェスに接続します。
アーキテクチャ
プレーヤーとレンダリングサーフェスは独立したオブジェクトです。両方を別々に作成し、サーフェスの準備が整った後にサーフェスハンドルを介して接続します。依存関係の追加
アプリのpackage.jsonファイルを開きます。dependenciesセクションに、次のエントリを追加します。
マニフェストの構成
ビデオを再生するには、manifest.tomlファイルでメディアサービスの依存関係と権限を宣言する必要があります。これらがない場合、メディアパイプラインが初期化されず、サーフェスは黒画面の表示になります。レイアウトの例
単一のビデオストリーミングのレンダリング
次の例では、単一のビデオストリーミングをレンダリングするVideoPaneコンポーネントを定義しています。
横並びレイアウト
次の例では、同じ幅の2つのストリームをレンダリングします。4つのストリームによるグリッドレイアウト
次の例では、4つの同時ストリームを2×2のグリッドでレンダリングします。ピクチャーインピクチャーレイアウト
次の例では、全画面ストリームの上に小さなストリームをレンダリングします。再生制御
次の例では、再生、一時停止、およびシークコントロールを 1 つのペインに追加します。完全な横並び表示の例
次の例は、2つのビデオストリームを並べてレンダリングする完全なApp.tsxファイルです。制限事項とベストプラクティス
サポートされているコンテンツ
- デジタル著作権管理(DRM)のないクリアコンテンツ: 最大4つの同時ストリーム
- DRMコンテンツ: 一度に1つのストリームのみ。VegaベースのFire TVデバイスは単一のセキュアなビデオデコーダーインスタンスしか提供しないため。
パフォーマンスに関する考慮事項
- 各ストリームはGPUメモリとデコードリソースを消費します。
- Vega仮想デバイスは、ソフトウェアデコードを使用して4つの非DRMストリームを同時にサポートします
ベストプラクティス
- リソース競合を防ぐため、時間をずらしてストリームの初期化を実施します。
- 各ストリームのエラーを個別に処理し、1つのストリームが失敗してもレイアウト全体がクラッシュしないようにします。
- 同じソースを4回デコードするのではなく、ストリームごとに別個のURLを使用します。
useEffect()のクリーンアップ関数内でclearSurfaceHandle('')およびpause()を呼び出し、コンポーネントがアンマウントされる際にリソースを解放します。onSurfaceViewCreated()を待ってから、setSurfaceHandle()を呼び出します。
時間をずらしたストリーム初期化
4つのプレーヤーすべてで同時にinitialize()を呼び出すと、リソース競合が発生します。次の例では、VideoPaneにinitDelayプロパティを追加し、初期化の実施を500ミリ秒ずつずらしています。
トラブルシューティング
次の表では、マルチストリーム再生で発生する一般的な問題とその解決策について説明します。Vega仮想デバイスでのテスト
Vega仮想デバイスでのマルチストリーム再生を検証できます。Vega仮想デバイスは、VideoPlayerおよびKeplerVideoSurfaceViewを使用して4つの非DRMストリームの同時再生をサポートします。
コマンドラインからのビルドと実行
-
コマンドプロンプトで、アプリをビルドします。
-
接続済みのVega仮想デバイスでアプリを実行します。次の例は、Mac Mシリーズマシンを対象としています。パス内のアーキテクチャを、お使いの開発マシンに一致するものに置き換え、アプリIDをmanifest.tomlファイルに記載されているものに置き換えてください。
ビルド出力パスおよびアーキテクチャ固有のコマンドの詳細については、「アプリの実行」を参照してください。
Vega Studioからのビルドと実行
- アプリをビルドして実行するには、Vega Studioで実行を選択します。
関連トピック
レビュー用のサンプル変更案
このページの本文にある例は、メディアプレーヤーチームから提供されたバージョンから変更されていません。以下の項目は、ドキュメントのレビュー中に提起された変更と未解決の問い合わせです。それぞれについて、ページに表示される前に、テストと確認が必要です。質問1 - clearSurfaceHandle('')は正しいですか
このページのすべてのクリーンアップ関数は、空の文字列を引数としてclearSurfaceHandle('')を呼び出しています。clearSurfaceHandleのAPIリファレンスでは、このパラメータについて「KeplerVideoSurfaceViewコンポーネントによって発行されたonSurfaceViewCreatedイベントによって返されるサーフェスハンドル」と記載されており、空の文字列ではありません。
クライアント側の広告挿入ドキュメントは、代わりにキャッシュされたハンドルが渡されています。詳細については、「JSアプローチを使用したクライアント側広告挿入の実装」を参照してください。
clearSurfaceHandle('')はサーフェスを解放しますか、それとも何も行わない(no-op)のでしょうか。- 何も行わない場合、
VideoPlayerがガベージコレクションされるまで、サーフェスはリークしたままになりますか。 - これは、トラブルシューティング表の「2つのストリームだけがレンダリングされ、それ以外は黒画面になる」という症状の説明になりますか。
onSurfaceViewCreatedからハンドルをキャッシュし、クリーンアップ関数がそれを渡せるようにする必要があります。次の例は、VideoPaneに対する提案された変更を示しています。
質問2 - これらの例ではdeinitialize()を呼び出すべきでしょうか。
クリーンアップ関数ではpause()を呼び出していますが、deinitialize()は一度も呼び出されていません。メディアアプリの全般的な要件には、アプリはメディアリソースを解放する必要があり、その解放はVideoPlayerの初期化解除によって行われると記載されています。アプリストアの認定要件もこれによって決まります。
チームへの質問:
- 各ペインは、アンマウント時に
await player.deinitialize()を呼び出すべきでしょうか。 deinitialize()はPromise<void>を返すため、useEffect()クリーンアップ関数ではawaitを使用できないことから、この位置ではdeinitializeSync(timeoutInMs)を呼び出すのが正しいのでしょうか。 推奨されるタイムアウト値はいくつですか。- 4つのプレーヤーが同時に実行されている場合に、それらを同時に初期化解除すると、初期化時と同様のリソース競合が発生するのでしょうか。
質問3 - 再生制御の例では何も公開されていません
再生制御の例では、play、pause、およびseekが宣言されていますが、返されることも呼び出されることもありません。記述に従い、コンポーネントはサーフェスをレンダリングするのみで、これら3つの制御にはどの親コンポーネントからもアクセスできません。TypeScriptもこれらを未使用のローカル変数として報告しています。
次の例は、forwardRef()およびuseImperativeHandle()を使用してコントロールを公開する、提案された代替案です。このパターンはすでにVega Carouselでも現れています。
useImperativeHandle()は、推奨すべきパターンでしょうか。それとも、例ではD-padのフォーカス処理によるオンスクリーン制御を示した方が良いでしょうか。currentTime += secondsはシークの正しい方法でしょうか。それとも、ストリームの開始時と終了時でのクランプ処理を行うシークAPIは存在しますか。
質問4 - KeplerVideoSurfaceViewは適切なコンポーネントでしょうか。
APIリファレンスでは、KeplerVideoSurfaceViewとKeplerShareableSurfaceViewについて、次のような同一のテキストで説明されています。 「このコンポーネントは、VideoPlayerコンポーネントを使用してプレバッファリングモードで動作している場合にのみ使用してください。このモードでは、複数のプレーヤーに異なるコンテンツを同時にプレバッファリングできます。」
チームへの質問:
KeplerVideoSurfaceViewとKeplerShareableSurfaceViewにはどのような違いがありますか。また、マルチストリームアプリではどちらを使用すべきですか。- リファレンスには、これらのコンポーネントを「プレバッファリングモードで動作する場合にのみ」使用する、と記載されています。 このページにある例は、プレバッファリングモードで動作していますか。 もしプレバッファリングが前提条件であるなら、その旨を明記し、有効化する方法も示す必要があります。
質問5 - 実際の同時ストリーム数の上限はいくつですか。
このページでは、3か所において4つの同時ストリーム、という記載があります。この数に関するすべての情報源では、ソフトウェアデコードを使用するVega仮想デバイスについて触れられています。 チームへの質問:- VegaベースのFire TV Stickデバイスは、同時にいくつのクリアストリームをサポートしていますか。 4つでしょうか、それともこの4つというのは仮想デバイスに限定した数になるのでしょうか。
- メディアアプリの全般的な要件では、Vegaベースの最初のFire TVは1つのセキュアビデオデコーダーインスタンスのみをサポートすると記載されています。このページ上部のDRMに関する警告は、それに基づくものです。これは現在のハードウェアにおいても依然として正確でしょうか。
- 4つのストリームまでという制限は、解像度によって変わりますか。 たとえば、1080pでの4ストリームは、4Kでの1ストリームと同等になるのでしょうか。
質問6 - 時間をずらした初期化による遅延の確認
時間をずらしたストリーム初期化の例では、500ミリ秒刻みで設定されており、4番目のストリーム初期化が開始されるまでの合計時間は1.5秒になります。 チームへの質問:- 500ミリ秒は実測値ですか、それとも仮の値ですか。
- 固定の遅延を回避するために、各
initialize()を順番に待つような、決定的な代替手段はありますか。
質問7 - ビルドおよび実行のコマンドには検証が必要
以下の変更点は、関連ドキュメントに基づいた最善の推測であり、チームは実際のツールチェーンと照らし合わせて確認または修正する必要があります。 提供された内容は、開発者に対して、トラブルシューティングの表ではnpx react-native build-kepler --build-type Release --target aarch64を実行し、Vega仮想デバイスでのテストの手順でvega run-app build/aarch64-release/<your-app-name>_aarch64.vpkgを実行するよう指示するものでした。
変更点とその理由:
build-keplerがbuild-vegaに変更されました。build-keplerは旧式のコマンド名です。Vega CLIツールのドキュメントでは、React Native Vegaアプリ向けにnpx react-native build-vegaが記載されており、0.24のドキュメント内でのbuild-keplerが登場する他の箇所では、Vega Studioのコンソール出力や「Unrecognized command build-kepler」というタイトルのトラブルシューティング項目など、その名前を説明しているだけで、具体的な指示内容はありません。--target aarch64は削除されました。build-vegaと合わせて使用されるこのフラグは、0.24のドキュメントのどこにも記載されていません。ドキュメントに記載されているフラグは--build-type、--build-version、および--build-numberです。アプリのビルドでは、1回のビルドでaarch64-release、x86_64-release、およびarmv7-releaseの出力フォルダが生成されることが示されているため、ターゲットフラグは必要ないようです。- runコマンドには、アプリIDと
-d VirtualDeviceが追加されました。 Vega CLIツールでは、シグネチャがvega run-app <Vpkg path> <App ID> -d <device>と記載されており、他のすべての0.24の例でも両方が指定されています。指定どおり、コマンドではそれらの両方が省略されています。
- Vega CLIツールでは、
npx react-native build-vegaを直接使用するよう指示しており、vega buildは存在するが、React Nativeアプリ向けではないと注記されています。 - アプリのビルドというメインのビルドページでは、Vega CLIのパスとして
npm run build:appが示されており、build-vegaについては一切言及されていません。Vegaヘッドレスタスクおよびヘッドレスサービスについて、build:appがbuild-vega --build-type Releaseおよび--build-type Debugに解決されることが示されているため、npmスクリプトはおそらくラッパーであると考えられます。この間接的な処理については、ビルドページでは一切説明されていません。 - 手順1: 依存関係の更新では、
@amazon-devices/kepler-cli-platformが**vega build**コマンドを登録しており、@react-native-community/cliを削除するとnpm run build:releaseが「Unrecognized command vega build」というエラーで失敗すると記載されています。これは、React Nativeのnpmスクリプトがvega buildを呼び出していることを示唆しており、Vega CLIツールのページの内容と矛盾しています。
- Vega向けReact Nativeアプリをコマンドラインからビルドする現在の正しい方法は何ですか。
npx react-native build-vega、npm run build:app、vega buildのどれでしょうか。build-vegaとvega buildは、同じコマンドの別名でしょうか、それとも2つの異なるコマンドなのでしょうか。 - このページでは、
build-vegaをそのまま実行するよう指示すべきでしょうか、それともアプリのビルドに合わせて、開始ガイドの手順に沿って進めた開発者がすでに使用しているnpm run build:appを使用すべきでしょうか。 build-vegaは--targetフラグを受け付けますか。 受け付ける場合、ここでターゲットを指定する必要がありますか、それとも1回のビルドですべてのアーキテクチャが生成されますか。vega run-appの呼び出しを確認します。その際、アプリIDのパターンcom.amazondeveloper.<your-app-name>.mainが、サンプルに同梱されているmanifest.tomlファイルと一致しているかどうかも含めて確認します。- 「起動時にアプリがクラッシュする」という項目は、実際の再現可能な障害を説明するものですか。 元の文言は、
vega buildがネイティブ C++ およびRust開発に関連付けられていましたしかし、Vegaに関するドキュメントにはネイティブ開発パスが記載されておらず、このドキュメントセットの他の箇所にもRustに関する記述が一切ないため、それらの文言は削除されました。現在の項目では、vega buildがReact Nativeではサポートされておらず、不完全なパッケージが生成されることのみが記載されています。これが正確であること、および不完全なパッケージがクラッシュの原因であることを確認してください。なお、この項目の前提は、このリストの最初の質問に依存しています。 npmスクリプトが内部でvega buildを呼び出している場合、「vega buildを使用した」ことがクラッシュの原因であるはずはありません。
build-keplerを使用してビルドおよびテストされたものと推測されます。どちらのコマンドが正しい場合でも、このページを公開する前に、そのコマンドを使用して再ビルドを行う必要があります。
