Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
Fire TVには、ホーム画面にアプリの特定のコンテンツを宣伝するバナーやタイルなどのプロモーション枠が表示されます。プロモーション枠に表示されるコンテンツは、「注目コンテンツ」と呼ばれます。注目コンテンツのディープリンクでは、アプリのホームページを経由せずに、プロモーション対象のコンテンツに直接ユーザーを移動させることができます。ディープリンクは、アプリ内の特定の画面を起動する特別な形式のURLです。 たとえば、Fire TVのマーチャンダイジングスロットに、ACME Mediaのフットボールのプレーオフ試合が表示されているとします。このプロモーションをクリックすると、次の処理が実行されます。
  • ACMEアプリを起動します。
  • ユーザーをゲームの詳細画面または再生画面に直接誘導します。
アプリがインストールされていない場合、Fire TVはユーザーをアプリの詳細ページにリダイレクトしてダウンロードを促します。インストールして起動すると、ディープリンクはコンテキストを維持したまま、自動的に目的のコンテンツにユーザーを誘導します。 このドキュメントでは、注目コンテンツのディープリンクをVegaアプリに実装するためのガイダンスを提供します。

注目コンテンツのディープリンク

Vega OSとFire OSは、同じ注目コンテンツのディープリンクを使用します。 Fire OSアプリとVega OSアプリの注目コンテンツのディープリンクを生成するには、「Fire TVのUIから注目コンテンツへのディープリンク」のコンテンツのエンコード済みディープリンクインテントの生成セクションに記載されている手順に従います。 次の例は、Fire OSアプリのエンコード済みディープリンクを示しています。このURIは、Fire TVで注目コンテンツを構成するために使用されます。 amzns://apps/android?asin=B080PZMHSN#Intent;S.intentToFwd=https%3A%2F%2Fwww.acme.com%2Fsome%2Fshow%2Frrn%3Acontent%3Ashows%3A123456789;end ディープリンクに応答するためのURIは、ホームランチャーがディープリンクをアプリにルーティングするために使用する「ヘッダー」と、アプリが解析する必要のあるディープリンクの2つの部分で構成されています。 Vegaアプリは、S.intentToFwdの後に続くURIのデコード済みのバージョンを受け取ります。このデコード済みバージョンは、任意のオンラインツールを使用して取得できます。 https://www.acme.com/some/show/rrn:content:shows:123456789 注目コンテンツのディープリンクはOSに依存しません。ディープリンクはVegaもFire OSも同じで、AndroidインテントスタイルのURIを使用します。 ディープリンクを受信したら、インテントフラグメントのコンポーネントを適切なReact Navigationコンポーネントにマッピングする必要があります。 エンコード済みディープリンクについて詳しくは、「Fire TVのUIから注目コンテンツへのディープリンク」のAndroid Studioを使用してディープリンクインテントをエンコードする手順を参照してください。

Vegaアプリで注目コンテンツのディープリンクを処理する方法

Vegaはreact-native linkingを使用してメッセージを送受信します。次の手順は、メッセージを受信してアプリで処理する方法を示しています。

手順1:リンクライブラリをインポートする

手順2:アプリが既に開いているときにメッセージを受信する

ディープリンクを受信したときに、アプリがフォアグラウンドまたはバックグラウンドで実行中である場合、アプリはurlイベントを受け取ります。イベントをリッスンするには、urlを呼び出してLinking.addEventListener().イベントをサブスクライブします。

手順3:アプリが開いていないときにメッセージを受信する

アプリの起動時に(たとえば、useEffect()内で)Linking.getInitialURL()を呼び出して、ディープリンクがアプリの起動を開始したかどうかを確認します。
次の統合コードサンプルは、ディープリンクイベントを受信して処理する方法を示しています。URLを解析し、データを取得して必要なアクションを実行するには、handleDeepLink()カスタム関数を実装する必要があることに注意してください。

Vegaで注目コンテンツへのディープリンクをテストする方法

ディープリンクをテストするには、アプリをサイドロードするときにアプリのASINにリンクする必要があります。Fire TV対応Amazonアプリストアでは、ASINはAmazon標準識別番号を意味します。ASINは、B080PZMHSNのような10文字の英数字の文字列です。アプリのASINを取得する方法は、Amazonの担当者にお問い合わせください。 ASINをリンクしてアプリをインストールするには、次のコマンドを使用します。「store-id=」の後に続くサンプルASINのB080PZMHSNを、アプリの実際のASINに置き換えてください。
アプリにCLIコマンドを送信することで、ディープリンクをテストできます。CLIコマンドには「amzns」の部分を含めます。 vega exec vda shell "vmsgr send '<ここにamzns URLを追加>'" 次のディープリンクを使用して統合を検証します。ディープリンクの「asin=」の後にアプリのASINが含まれていることに注意してください。
このサンプルコードのhandleDeepLink()関数は、次のメッセージを表示します。 deeplink-sample - received: https://www.acme.com/some/show/rrn:content:shows:123456789

関連トピック


最終更新日 2026年10月26日