Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content

ユニバーサル検索のランチャーUXを使用した検証

Fire TVのホーム画面からユニバーサル検索を使用して、アカウントログインを検証できます。

リモコンを使用したコンテンツランチャー統合の検証

  1. アプリをインストールしてログインします。
  2. Fire TVのホーム画面から、アプリのコンテンツを検索します。
  3. コンテンツ詳細ページで、[今すぐ観る] を選択します。
想定される結果: コンテンツランチャーハンドラーが呼び出されると、アプリが自動的に起動し、選択したコンテンツの再生が開始されます。

音声を使用したコンテンツランチャー統合の検証

アプリをインストールしてログインします。アプリがフォアグラウンドで実行されているときに、音声コマンド(「アレクサ、…」)を使用して、アプリで利用できるコンテンツを再生します。コンテンツランチャーハンドラーが呼び出され、アプリがリクエストを適切に処理し、リクエストされたコンテンツの再生を開始します。 発話の例:
  • 「<映画名>を見せて」
  • 「<TV番組名>のシーズン< 番号>、エピソード<番号>を見せて」
  • 「コメディ映画を見せて」

KCP CLIを使用してアカウントログイン統合を検証する方法

コマンドラインからアカウントログイン統合を検証することもできます。これを使用して、デバッグを行い、アプリがログインステータスを正しく報告しているかデバッグして確認します。

前提条件

  • Vegaデバイスで開発者モードを有効にしていること。手順については、開発者モードの有効化を参照してください。
  • アプリはサイドローディングでインストールされており、1回以上起動済みで、フォアグラウンドまたはバックグラウンドで実行されていること。アプリコンポーネントシェルは、ライブアプリテストまたはアプリストアを介してインストールされたアプリでは動作しません。

コンポーネントシェルに入る方法

開発者モードが有効化されたら、コンポーネントシェルに入り、CLIを確認します。
CLIはあらかじめ/usr/bin/kcp-cli-v2にインストールされており、コンポーネントシェルからアクセスできます。

アカウントログインステータスの確認

コンポーネントシェルからアプリのログインステータスを確認するには、次のコマンドを実行します。
例:
想定される出力:
値がtrueの場合、アプリはSIGNED_INです。falseである場合、アプリSIGNED_OUTはそうです。

アカウントログインステータスの変更の購読

ログインステータスの変更をリアルタイムで監視するには、watch-statusコマンドを使用します。
例:
想定される出力:
ステータスが変化すると、出力ストリームが更新されます。このコマンドの実行中にアプリにログインおよびアプリからログアウトして、ステータスの遷移を確認します。 詳細な使用方法については、以下を実行してください。

アカウントログインのCLIシナリオのテスト

  1. SIGNED_INの確認: アプリにログインし、account-login read-statusを実行します。ステータスによりtrueが返されます。
  2. SIGNED_OUTの確認: アプリからログアウトし、account-login read-statusを実行します。ステータスによりfalseが返されます。
  3. 遷移の確認: account-login watch-statusを実行して、アプリにログインおよびアプリからログアウトします。その都度、ステータスの更新を確認します。

KCP CLIを使用したコンテンツランチャー統合の検証

KCP CLIツールを使用して、アプリ上でコンテンツランチャーリクエストを呼び出すことができます。これにより、ユニバーサル検索、リモート、音声コマンドを使用せずに、起動リクエストをテストできます。

前提条件

  • Vegaデバイスで開発者モードを有効にしていること。手順については、開発者モードの有効化を参照してください。
  • アプリをKCPでインストールして登録し、少なくとも1回起動していること。

コンテンツ検索のJSONの追加

--content-searchパラメーターは、次の構造のJSONオブジェクトを受け入れます。

external_id_listフィールドの追加

タイトルで映画を起動する方法

シミュレート: 「アレクサ、<映画>を見せて」
想定される結果: アプリが起動し、リクエストされた映画の再生が開始します。

特定のシーズンおよびエピソードを起動する方法

シミュレート: 「アレクサ、<番組名>のシーズン1、エピソード3を見せて」
パラメーターの内訳:

特定のエピソードを起動する方法(シーズンなし)

シミュレート: 「アレクサ、<番組名>のエピソード3を見せて」
想定される結果: アプリが起動し、リクエストされた番組のエピソード3の再生が開始します。

特定のシーズンを起動する方法

シミュレート: 「アレクサ、<番組名>のシーズン1を見せて」
想定される結果: アプリが起動し、リクエストされた番組のシーズン1(通常はエピソード1から)の再生が開始します。

検索ケース(現在、特定のアプリでのみサポートされているもの)

映画の検索(自動再生なし)

シミュレート: 「アレクサ、<映画名>を検索して」
想定される結果: アプリによって、リクエストされたコンテンツの検索結果が表示されます。

俳優で検索

シミュレート: 「アレクサ、<俳優名>を探して」
想定される結果: アプリには、指定された俳優に関連するコンテンツが表示されます。

ジャンルで検索

シミュレート: 「アレクサ、コメディ映画を探して」
想定される結果: アプリによってコメディのコンテンツが表示される、または--auto-playが指定されている場合は再生が開始されます。

コンテンツ検索パラメータータイプ

コンテンツ検索のJSONでparam_typeフィールドを使用して、検索のタイプを指定します。

コンテンツランチャーのCLIテストシナリオ

  • 基本的な映画の起動: 有効な--auto-play値を持つ既知の映画タイトルに対して、external_id_listオプションを指定して起動リクエストを送信します。アプリが起動し、再生が開始されることを確認します。
  • シーズンおよびエピソードの起動: シーズンとエピソードのパラメータを指定して起動リクエストを送信します。アプリが正しいエピソードに移動することを確認します。
  • エピソードのみの起動: エピソード番号のみを指定した起動リクエストを送信します。アプリが正しいコンテンツに移動することを確認します。
  • 検索結果の表示: --auto-playを指定せずに起動リクエストを送信します。アプリが関連性の高い検索結果を表示することを確認します。
  • 俳優検索: param_type: 0と俳優の名前を指定した起動リクエストを送信します。アプリがその俳優のコンテンツを表示することを確認します。
  • ジャンル検索: param_type: 6とジャンルを指定した起動リクエストを送信します。アプリがそのジャンルのコンテンツを表示または再生することを確認します。
  • 再生設定: --optional-fieldsで再生位置を指定して起動リクエストを送信します。アプリが正しいタイムスタンプで再生を再開することを確認します。
  • 不明なコンテンツの処理: カタログに存在しないコンテンツに対する起動リクエストを送信します。アプリがリクエストを適切に処理することを確認します。
詳細な使用方法については、以下を実行してください。

トラブルシューティング

最終更新日 2026年10月22日