Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
この記事では、Vega OSデバイス上で動作するReact Nativeアプリに画面解像度を検出する処理を実装する方法を紹介します。Vegaデバイスは4K再生をサポートしていますが、すべてのTVが4Kに対応しているとは限りません。4KをサポートするVegaデバイスが高精細(HD)TVに接続されている場合は、最適なエクスペリエンスを提供するために、アプリでHD以下のストリームのみをリクエストする必要があります。不適切なビデオストリームをリクエストすると、途切れやゆがみ、再生エラーなどの再生の問題が発生することがあります。 画面の解像度を検出するには、次の2つの方法があります。
  • W3C標準のdecodeInfo()。Shaka Playerやその他のウェブベースのプレーヤーを使用するアプリに推奨されます。
  • Vega Graphics API。アプリで画面の解像度を検出するために使用できます。

前提条件

  • Vega開発環境がセットアップされていること
  • Vega OSで動作するReact Nativeアプリ
  • 4Kをサポートするテスト用のVegaデバイス
  • @amazon-devices/react-native-w3cmediaパッケージがインストールされていること(decodeInfo()アプローチの場合)

decodeInfo()ポリフィルの定義

Amazonのパッチが適用されたShaka Playerを使用する場合は、この手順をスキップしてください。これにはポリフィルが既に含まれています。 その他のプレーヤーの場合は、decodeInfo()のポリフィルを定義します。ポリフィルのコードについては、メディア機能のドキュメントを参照してください。 Vega Sports Sample Appでは、ビルドスクリプトによって、W3CMediaPolyfill.tsというファイルが**<app-root>/w3media/polyfills/**フォルダに配置されます。このファイルには、decodeInfo()の実装が含まれています。

ポリフィルのインストール

アプリにポリフィルを定義したら、そのポリフィルをインストールして、アプリからメディア機能にアクセスできるようにします。Vega Sportsサンプルアプリでは、アプリの初期化中にポリフィルがインストールされます。

decodeInfo()で解像度のサポートを照会する

Shaka Player、またはdecodingInfo()を直接呼び出すその他のW3Cベースのプレーヤーを使用している場合は、この手順をスキップしてください。 カスタムプレーヤーのコードでは、decodeInfo()を使用して、接続されたディスプレイがサポートしている解像度を確認します。次の例では、HDおよび超高精細(UHD)のAdvanced Video Coding(AVC)ストリームのデコードがサポートされるかどうかを確認します。
4K対応のVegaデバイスが4K非対応のディスプレイ(1080pや720pなど)に接続されている場合、decodingInfoImpl()はconfiguration_4kを非サポートとして返し、それより低い解像度の構成をサポート対象として返します。

代替手段としてのVegaグラフィックスAPIの使用

Vega Graphics APIを使用すると、Fire TVデバイスと接続されたディスプレイに関する情報(高さ、幅、ハイダイナミックレンジ(HDR)などの機能を含む)を取得できます。この方法は、W3C APIを使用しないカスタムプレーヤーに最適です。 返される高さの値には、デバイスとディスプレイの組み合わせに応じて適切な解像度が反映されます。
  • 4KをサポートするVegaデバイスにHD TVが接続されている場合、1080が返されます。
  • 4KをサポートするVegaデバイスに4K TVが接続されている場合、2160が返されます。

実装のテスト

アプリをビルドし、Fire TVデバイスで実行します。
  1. 4KをサポートするVegaデバイスをHD(1080p)TVに接続します。
  2. アプリを実行し、HDストリームのみがリクエストされることを確認します。
  3. 4KをサポートするVegaデバイスを4K TVに接続します。
  4. アプリを実行し、4Kストリームがリクエストされることを確認します。

関連コンテンツ


最終更新日 2026年4月8日