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

​

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

​

前提条件

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. ネットワーク認証情報を入力します。
4. デバイスの登録を完了します。 a. オンラインまたはQRコードを通じてAmazonアカウントにログインします。 b. 画面の指示に従います。 c.「登録が完了しました」というメッセージが表示されるまで待ちます。
5. 「Fire TVリモコンのセットアップが完了しました」というメッセージが表示されたら、[OK] を押します。

​

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

1. [設定] > [My Fire TV] > [バージョン情報] に移動します。
2. デバイス情報で [シリアル番号] を探します。 このシリアル番号が、デバイスを登録するために必要なDSNです。DSNは、梱包されていたパッケージやAmazonアカウントの [コンテンツと端末の管理] でも確認できます。

1. [デバイスシリアル番号（DSN）] 入力フィールドにDSNを入力します。
2. [デバイスを追加] をクリックします。 [Registered Devices] セクションにDSNが表示されます。

​

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

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で入力します。
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」と表示されます。
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にアプリを読み込む

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

build/armv7-release/sampleapp_armv7.vpkg

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

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

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

​

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

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

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

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

​

トラブルシューティング