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

Fire TVでのアプリの実行

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

開発者モードを有効にすると、デバイスでアプリをサイドロードし、開発ビルドをテストできます。どのVega Fire TVデバイスでも、開発者モードを有効にする手順は同じです。

前提条件

1. Vega SDKをインストールします。
2. 最新のSDK Managerがインストールされていることを確認します（最新バージョンを取得するには、vega updateを実行します）。

3. Vega OSが動作するFire TVデバイス（Fire TV Stick HD、Fire TV Stick 4K Select、Fire TVストリーミングメディアプレーヤーなど）を用意します。

   すべてのサポート対象デバイスの一覧については、Fire TVのデバイス仕様を参照してください。

手順1： Fire TVデバイスをセットアップして登録する

先に進む前に、Fire TVデバイスに付属のリモコンを使用していることを確認してください。ほかのFire TVデバイスのリモコンを使用すると、開発中やテスト中にペアリングの問題が発生します。

1. Fire TVデバイスを接続します。

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

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

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

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

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

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

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

   Fire TVのロゴが数分以内に表示されない場合は、Fire TV Stickに関する問題の解決でトラブルシューティングの手順を確認してください。

3. 設定を構成します。

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

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

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

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

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

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

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

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

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

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

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

開発者モードでは、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):/$
      

手順3： Fire TVデバイスにアプリを読み込む

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

.vpkgファイルの特定

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

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

Fire TVデバイスでは、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

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

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

コンピューターに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の画面に表示されます。