Shaka プレーヤーの移行に関する HLS

概要

Cast Web Receiver SDK は、 ストリーミング プロトコルをご覧ください。基づいて、 プロトコルが使用されている場合、SDK はプレーヤーを読み込み、コンテンツの再生を処理します。 HLS コンテンツの場合は、Media Player Library（MPL）が読み込まれます。ケースが DASH コンテンツ（Shaka Player）は、 確認できます。

今後、Cast SDK と Shaka Player のエンジニアリング チームは、 Shaka での HLS コンテンツ再生のサポート強化に向けた取り組みの統合 プレーヤー。MPL への重要な更新は行われなくなります。P-MAX へのアップグレードを アプリの HLS コンテンツ再生に Shaka Player を使用する必要があります。

Shaka プレーヤーのメリット

プレーヤーが変化する中、アプリケーションは次のようなメリットを活用します。

  • より堅牢なストリーミング セッションと、読み込み時間の改善 モニタリングします。
  • 最新の HLS 機能の継続的な採用。
  • プレーヤー コンテンツの根本原因分析がより明確化 Shaka Player のオープンソース特性に起因する互換性の問題。
  • オープンソースのプレーヤー コードベースにより、パートナーは以下のことが可能 Shaka Player Project に貢献してください。
  • 本番環境への移行とバグ修正にかかる時間の大幅な短縮 Shaka Player のリリース 高い頻度です。 Web Receiver SDK のリリースから独立しています
  • 再生環境をより細かく制御: shakaVersion API。
  • エンジニアリング リソースによる Google による再生サポートの強化 Shaka Player での HLS 再生に注目しました。 ロードマップ。

タイムライン

Web Receiver SDK は、デフォルトのプレーヤーとして Shaka Player を使用するように移行します HLS コンテンツ再生に使用できますこのプロセスは段階的に進めます。 プロセスを進めることができます。

フェーズ 開始日 概要
1 2022 年 10 月 Cast Web Receiver SDK に、Shaka Player で HLS コンテンツを再生するためのオプトイン API が導入されました。
2 2024 年下半期 Cast Web Receiver SDK により、HLS コンテンツ再生のデフォルト プレーヤーが Shaka プレーヤーに変更されました。

Web Receiver SDK のエンジニアリング チームはパフォーマンス重視のアプローチを採用 Shaka Player のパフォーマンスがオンの場合にのみ、次のフェーズに進みます。 MPL のベースライン パフォーマンスと同等です。これらの変更は、 cast-sdk-announcements Google グループ: ご覧ください。

オプトイン

CAF バージョン 3.0.0105 以降では、アプリケーション レベルが HLS 再生に Shaka Player を使用するようにオプトインするための設定。このバージョン サポートされているさまざまな Shaka Player バージョンから選択するための API も導入されています 表示されます。これらのフラグは、 CastReceiverOptions クラスを useShakaForHls、 shakaVersion プロパティが定義され、次の場合に評価されます。 CastReceiverContext が開始される。HLS 向け Shaka にオプトインするすべてのアプリケーション 機能を利用するには、Shaka Player のバージョンを 4.3.4 以上に設定する必要があります。 最新の HLS の改善。オプトインするには、以下のコード スニペットに従ってください。

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

コンテンツを検証する

パートナーは、オプトアウトする前に Shaka Player でのコンテンツ再生を検証する必要があります 製品版アプリで Shaka Player を使いました各環境の違いについて コンテンツのパターンは次のとおりです。

  • ストリーミングの種類: LIVE または VOD
  • コンテナ形式: TS、MP4、エレメンタリー ストリーム
  • 中断を伴うコンテンツ、または広告が埋め込まれているコンテンツ
  • 再生できるデバイスの種類: スマートディスプレイ、Chromecast ドングル、 Android TV デバイス、Chromecast built-in 搭載テレビ、スマート スピーカー

エラーや予期しない動作が見つかった場合は、バグを報告してください。 プロジェクトに重大な再生の失敗がないことを確認したら、 変更を本番環境に push できます。

オプトアウト

Web Receiver SDK は Shaka Player HLS のオプトアウト モデルに移行します タイムラインに従ってコンテンツを再生します。プロパティ useShakaForHls によりデフォルト値が変更されます false～true。その時点で、アプリケーションは HLS に MPL を使用することを選択できます。 再生するには、このプロパティを手動で false に設定します。Google CastReceiverContext が開始されました。Web Receiver SDK は読み込みに戻ります Shaka Player ではなく MPL。オプトアウト方法については、以下のサンプルをご覧ください。

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

問題を報告する

HLS の再生中に見つかった問題については、報告することをおすすめしています。 説明します。前述のとおり、MPL は重要な更新を受けなくなります。該当する場合 MPL で問題が発生した場合は、オプトインの手順を実施してください。 セクションを確認して、Shaka Player に切り替えたときに あります。問題が解決しない場合や、問題が発生した場合は、以下の手順を行います。 プレーヤーを切り替える際に 異なる問題が発生する可能性があります

  1. shakaVersion を 異なるブランチ バージョンを使用して問題を解決します。たとえば、この問題が 4.3 ブランチで問題が発生している場合は、 4.2.x バージョンまたは 3.3.x バージョン。Shaka Player のリリースを確認します。 メモ 最も関連性の高いアップデートがリリースされます。なお、 shakaVersion API の最小値と最大値 サポートされているバージョン（リファレンス ドキュメントに詳述）エラーが 回帰が発生している場合は、Shaka Player で問題を報告します。 Issue Tracker をご利用ください。

  2. プレーヤー設定のパラメータを変更してみる。Shaka Player は Google Cloud コンソールで PlayerConfiguration オブジェクト。ウェブ Receiver SDK が一連のデフォルト値を定義し、アプリが Google Cloud コンソールで PlaybackConfig の shakaConfig プロパティ 渡されます。これは読み込み時に、プレーヤー インスタンスが 作成されます。もっと見る:

    アプリケーションの構成と オプションをご覧ください。デフォルト 推奨値です。

  3. Shaka Player Issue tracker または Cast Issue Tracker をご利用ください。バグにコメントし、関連するものがあれば追加します。 ご確認ください。

  4. Shaka Player デモサイトでコンテンツをテストします。もし コンテンツのデモサイトで問題が再現されている場合は、 バグをご覧ください。

  5. 以下の場合は、Cast Issue Tracker でバグを報告してください。 キャスト エンドポイントで Shaka Player 固有の問題が発生しています。

よくある質問

プレーヤーが変わると、多くの疑問が生じます。ここでは、 移行プロセスを進めるうえで役立つ、よくある質問とその回答をご覧いただけます。

Shaka Player に移行した方がよいですか？

HLS コンテンツをご利用のお客様には、 必要があります。その結果、アプリはより安定したストリーミングを提供できます。 優れたエクスペリエンスを構築できますその他の特典については、Shaka Player の 説明をご覧ください。パートナー様が確認すべき点 アプリをスムーズに動作させることを 説明します。一部のアプリは、Web Receiver SDK が パートナーが所有権の確認を行わない場合はオプトアウト モデルへの移行 コンテンツを事前に Shaka Player で適切に再生できるようにする必要があります。

プレーヤーを変更する場合、どの程度の労力が期待できますか？

パートナー様は、テスト環境でアプリケーションとコンテンツをテストする必要があります HLS と同等または改善されたユーザー エクスペリエンスを提供します。 これを行うには、 コンテンツを再生できるかどうかを入念にテストします 使用できます。詳細については、コンテンツの検証をご覧ください。 注力するべき点を明確にします検証が完了したら、パートナー様は以下を行う必要があります。 オプトインするフラグを追加してアプリケーションの本番環境で Shaka Player の利点を活用できます。概要として 最小限のソフトウェア開発変更で ほとんどが QA 要件です 適切な移行計画が必要です

アプリケーションでまもなく HLS を使用してコンテンツをストリーミングする予定はありますか？

新しい統合では、再生に Shaka プレーヤーを使用する必要があります。お客様の より適切にサポートされ、長期的には パフォーマンスが向上します。新しい 統合で問題が発生している場合は、できるだけ早くバグを報告して、 十分な時間を確保できます。アプリケーションに その情報をバグレポートに記載し、その影響と それに応じて優先順位を付けられますGoogle のエンジニアリング チームがソリューションを提供し、 ユーザーを適切にサポートする必要があります

コンテンツまたはアプリが Shaka Player で機能しません。どうすればよいですか？

Shaka Player プロジェクトまたは Cast プロジェクトを使用してバグを報告する必要があります。 （問題を報告するをご覧ください）。Cast SDK のエンジニアリングチームは トラッカーをモニターし、お客様と協力して問題の解決に取り組みます。 問題を早期に検出すればするほど、 修正を提供します

MPL が重要なアップデートを受けなくなりました。これは具体的にどういうことでしょうか？

MPL はこれまで新しい HLS 機能を導入し、 しています。MPL への配信が終了したことで、新しい HLS が提供されます。 プレーヤーに追加されません。同様に HLS で報告された問題は MPL で再生しても MPL では修正されません。これらの問題は、 再生が Shaka Player に切り替えられます。問題が解決しない場合は、 Shaka で発生した関連する問題について、バグとして報告する必要があります。 プレーヤー。パートナーは MPL の使用をやめる必要があります。

コンテンツで Smooth Streaming プロトコルを使用しています。アプリケーションにはどのような影響がありますか？

MPL バイナリは引き続きホストされ、レシーバーからアクセスできます 説明します。ただし、スムーズ ストリーミング関連の機能リクエストやバグは 修正はサポートされなくなります。 スムーズ ストリーミングの仕様は更新されていません 4 年間にわたり利用していますDASH または HLS を使用するようにコンテンツを移行することをおすすめします パフォーマンスのアップデートとサポートを引き続き受けられます。 提供します。

コンテンツで HLS プロトコルまたはスムーズ ストリーム プロトコルを使用していません。アプリケーションにどのような影響がありますか？

コンテンツ ライブラリでこれらのストリーミング プロトコルのいずれも使用されていない場合、次のようになります。 この移行による影響は受けません。変更する必要はありません。 説明します。

前へ
基本機能
次へ
プレーヤーのスタイルを設定する