Vega仮想デバイスまたはFire TV Stickでのアプリの実行

Fire TV Stickでアプリを実行する

VegaアプリをFire TV Stickで実行することは、Amazonアプリストアに申請する前に実際のデバイスのパフォーマンスをテストし、互換性を確認するために不可欠です。このセクションでは、Fire TV Stick 4K Selectを開発用にセットアップする方法、開発者モードを有効にする方法、Vegaアプリをテスト用にサイドロードする方法について説明します。

前提条件

1. Vega SDKをインストールします。

2. Fire TV Stick 4K Select。

   必ずFire TV Stick 4K Selectデバイスに付属のリモコンを使用してください。ほかのFire TVデバイスのリモコンを使用すると、開発中やテスト中にペアリングの問題が発生します。

手順1： Fire TV Stickをセットアップして登録する

1. Fire TV Stickを接続します。

   a. USBケーブルを使用して開発コンピューターに接続します。

   b. HDMIアダプターを使用してディスプレイに接続します。

   リモコンのペアリング画面が表示されます。

2. リモコンのペアリングを完了します。

   a. プロンプトが表示されたら、ホームボタンを押します。

   b. 画面の指示に従います。

   c. Fire TVのロゴが表示されるまで待ちます。

3. 設定を構成します。

   a. リモコンの再生／一時停止ボタンを押します。

   b. 使用する言語を選択します。

   c. ネットワークに接続します。

   d. ネットワーク認証情報を入力します。

   警告： デバイスは無線（OTA）アップデートをチェックします。アップデートが完了するまで、デバイスの電源をオフにしたり再起動したりしないでください。アップデートを中断すると、ネットワークを検出できなくなる可能性があります。

4. デバイスの登録を完了します。

   a. オンラインまたはQRコードを通じてAmazonアカウントにログインします。

   b. 画面の指示に従います。

   c. 「登録が完了しました」というメッセージが表示されるまで待ちます。

5. 「Fire TVリモコンのセットアップが完了しました」というメッセージが表示されたら、[OK] を押します。

手順2： Fire TV Stickを開発者モードに登録する

開発者モードを有効にすると、Fire TVデバイスでアプリをサイドロードし、開発ビルドをテストできます。デバイスを登録するには、デバイスシリアル番号（DSN）が必要です。

DSNを検索するには：

1. [設定] > [My Fire TV] > [バージョン情報] に移動します。

2. デバイス情報で [シリアル番号] を探します。

   このシリアル番号が、デバイスを登録するために必要なDSNです。DSNは、梱包されていたパッケージやAmazonアカウントの [コンテンツと端末の管理] でも確認できます。

Fire TV Stickを登録するには：

1. [デバイスシリアル番号（DSN）] 入力フィールドにDSNを入力します。

2. [デバイスを追加] をクリックします。

   [Registered Devices] セクションにDSNが表示されます。

手順3： 開発者モードを構成する

開発者モードを有効にするには、Vega CLIを使用してAmazon開発者アカウントで認証する必要があります。このプロセスでは、Fire TVデバイスから認証コードを取得し、ブラウザ経由で認証した後、ターミナルからデバイスの有効化を完了します。有効化すると、デバイスは自動的に再起動します。

1. Fire TVの [設定] メニューにアクセスします。

   オプション1： ホームボタンを使用する

   a. リモコンのホームボタンを押して、[ホーム] 画面に移動します。

   b. 上部のメニューバーに移動します。

   c. 右にスクロールして、[設定] アイコン（歯車記号）を見つけて選択します。

   オプション2： ホームボタンのショートカットを使用する

   a. リモコンのホームボタンを3秒間長押します。

   b. 表示されたクイックメニューから [設定] を選択します。

2. [設定] > [My Fire TV] > [バージョン情報] に移動します。

   

3. デバイス名（Fire TV Stick HD、Fire TV Stick 4K Select、Fire TVストリーミングメディアプレーヤーなど）を選択します。

   

4. リモコンの中央のボタンを7回押します。

   7回押すと、画面に「You are now a developer」という簡単な通知が表示されます。

5. 戻るボタンを押して [My Fire TV] に戻ります。

   一覧に [開発者オプション] が表示されます。

   

6. [開発者オプション] を選択します。

   メニュー一覧に [開発者モード]（デフォルトでは無効）が表示されます。

   

7. [開発者モード] を選択して続行します。

   

8. [続行] を選択して続行します（または、[キャンセル] を選択すると中止します）。

   [キャンセル] を選択すると、ダイアログが閉じ、何も変更されずに [開発者オプション] 画面に戻ります。

   [続行] を選択すると、Fire TVの画面に6桁の認証コードが表示されます。このコードは手順11で入力します。

   

   注： コードは5分後に期限切れになります。割り当てられた時間内にコードを入力しなかった場合は、同じ画面で [Request a New Code] を選択するか、[開発者オプション] に戻ってプロセスをやり直してください。

9. Amazon開発者アカウントで認証するために、loginコマンドを実行します。

   コードをコピー クリップボードにコピーしました。

    vega devmode login
   

   CLIの指示に従って認証を完了します。CLIによってデフォルトのウェブブラウザが自動的に開き、Amazonの認証ページが表示されます。ブラウザが自動的に開かない場合は、ターミナルに表示されているURLに移動してください。

10. ブラウザでVega CLIのアクセスを認可します。

    Amazon OAuthの同意画面に、「Vega Authentication Test would like access to:」というメッセージに続けて開発者の基本的なプロフィール情報と名前が表示されます。

    a. リクエストされた権限を確認します。

    b. [許可] を選択してVega Authentication Testを認可します（または、[キャンセル] を選択すると拒否します）。

    [キャンセル] を選択すると、CLIは認可を拒否し、認証エラーを表示します。やり直すには、vega devmode loginをもう一度実行してください。

    [許可] を選択すると、確認ページが開き、チェックマークアイコンと「Device connected to your account」というメッセージが表示されます。 このページは閉じて構いません。

    ターミナルに戻ります。CLIに次のように表示されます。

    Login successful! You are now authenticated with Amazon Developer Services.
    

11. Fire TVの画面に表示された6桁のコードを使用してデバイスを有効にします。

    コードをコピー クリップボードにコピーしました。

    vega devmode enable-device --code <6桁のコード>
    

    Amazon開発者アカウントに登録されているベンダーが1つだけの場合は、CLIに次のように表示されます。

    Using vendor: Amazon
    ✓ Device enabled successfully
    

    アカウントに複数のベンダーが登録されている場合は、CLIからいずれかを選択するように求められます。

    Select a vendor:
    1. Amazon (XXXXXXXXXX)
    2. Amazon (XXXXXXXXXX)
    

    使用するベンダーに対応する番号を入力します。CLIに「✓ Device enabled successfully」と表示されます。

    注： ベンダーは、Amazonの開発者サービスを通じてコンテンツを管理および公開するための開発者アカウントです。この認証がデバイスに届くまでには数秒かかることがあります。

12. デバイスが再起動するまで待ちます。

    

13. デバイスの再起動後、[設定] > [My Fire TV] > [開発者オプション] > [開発者モード] に移動します。

    [開発者モード] のステータスが [有効] として表示されます。

    

14. デバイスが認識されることを確認します。

    コードをコピー クリップボードにコピーしました。

    vega device list
    

    1台のデバイスを接続したときの出力例：

    Found the following device:
    [シリアル番号] : [デバイス番号]
    

    複数のデバイスを接続したときの出力例：

    Found the following devices:
    [シリアル番号] : [デバイス番号]
    [シリアル番号] : [デバイス番号]
    

15. デバイスに接続します。

    • 接続されているデバイスが1台の場合は、次のコマンドを使用します。

      コードをコピー クリップボードにコピーしました。

      vega device shell
      

    • 接続されているデバイスが複数ある場合は、デバイスのシリアル番号を指定します。

      vega device -d <デバイスのシリアル番号> shell
      

      出力の例：

       (hostmachine)% vega device -d <デバイスのシリアル番号> shell
      
       ##################################################
      
       ##### Welcome to Developer Mode Shell #####
      
       ##################################################
      
       sh(com.amazon.dev.shell):/$
      

手順4： Fire TV Stickにアプリを読み込む

Fire TV Stickで開発者モードを構成した後、新しいターミナルを開き、次のコマンドを使用してアプリを読み込みます。

Find your .vpkg file

vega buildでアプリをビルドすると、.vpkgファイルがプロジェクトのbuild/ディレクトリに生成されます。パスは次のパターンに従います。

build/<アーキテクチャ>-<ビルドタイプ>/<アプリ名>_<アーキテクチャ>.vpkg

Fire TV Stickの場合は、armv7アーキテクチャを使用します。たとえば、アプリの名前がsampleappでリリースバリアントを作成すると、次のようになります。

build/armv7-release/sampleapp_armv7.vpkg

コンピューターに1台のデバイスを接続している場合

<パッケージ.vpkg>を.vpkgファイルへのバスに置き換えます。

vega device install-app --packagePath build/armv7-release/sampleapp_armv7.vpkg

コンピューターに複数のデバイスを接続している場合

次のコマンドを使用してターゲットデバイスを指定します。<デバイスのシリアル番号>はデバイスのシリアル番号に、<パッケージ.vpkg>は.vpkgファイルへのパスに置き換えます。

vega device -d <デバイスのシリアル番号> install-app --packagePath build/armv7-release/sampleapp_armv7.vpkg

出力の例：

Installing/Updating '/tmp/sampleapp_armv7.vpkg' .. success

手順5： Fire TV Stickでアプリを実行する

Fire TV Stickにアプリを読み込んだ後、次のコマンドを使用してアプリを実行します。

コンピューターに1つのデバイスを接続している場合

vega device launch-app --appName <コンポーネントID>

コンピューターに複数のデバイスを接続している場合

次のコマンドを使用してターゲットデバイスを指定します。<デバイスのシリアル番号>はデバイスのシリアル番号に、<コンポーネントID>はアプリのコンポーネントIDに置き換えてください。

vega device -d <デバイスのシリアル番号> launch-app --appName <コンポーネントID>

出力の例：

(hostmachine)% vega device -d <デバイスのシリアル番号> launch-app --appName com.amazondeveloper.sampleapp
Launching app 'com.amazondeveloper.sampleapp' .. success

トラブルシューティング

Fire TV Stickで問題が発生した場合は、Fire TV Stickに関する問題の解決を参照してください。