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

Vega仮想デバイスでのアプリの実行

Vega開発者ツール（VDT）には、物理デバイスがなくてもVegaアプリをテストして実行できるVega仮想デバイス（VVD）が付属しています。仮想デバイスでは、次の制御オプションを使用できます。

• 仮想デバイス上でのマウスの直接操作
• バーチャルリモコンインターフェイス
• キーボードショートカットとコマンド

前提条件

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

   警告： アプリが @amazon-devices/kepler-ui-components を使用している場合、VVDテストには最新のSDKバージョン（0.22以降）を使用する必要があります。古いバージョンのVVDには必要なネイティブモジュールが含まれておらず、モジュール依存関係エラーで失敗します。古いSDKでビルドされたアプリの場合は、代わりに物理的なFire TV Stickでテストしてください。

2. テストするVegaアプリを用意します。

   Vega SDKのプロジェクトテンプレートから作成したアプリやサンプルアプリからダウンロードしたアプリを使用することも、独自に構築したアプリを使用することもできます。

3. （任意）Vega仮想デバイスを登録します。テスト用にAmazonのサービスを使用する場合に必要です。

Vega仮想デバイスでアプリを実行する方法

Vegaアプリは、Vega Studioのユーザーインターフェイス（UI）またはVega CLIを使用して実行できます。

オプション1： Vega Studio UIを使用する

1. [Vega Studio] > [Devices] に移動し、[VirtualDevice:Tv] を選択します。

2. [play] ボタンをクリックして仮想デバイスを起動します。

3. VVDウィンドウが開いてデバイスの読み込みが完了するまで待ちます。

   VirtualDevice:Tvのステータスが、「Loading...」ではなく準備完了として表示されます。

4. プロジェクト名の横にある [play] ボタンをクリックします。

   アプリが起動し、Vega仮想デバイスウィンドウ内に表示されます。

オプション2： Vega CLIを使用する

1. コマンドプロンプトからVega仮想デバイスを起動します。

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

   vega virtual-device start 
   

   このコマンドはVega仮想デバイスが起動するまで待機します。

   Launching virtual device.
   Waiting for virtual device to boot.
   Virtual device ready.
   

   注： Vega仮想デバイスの初回起動時に、マイクへのアクセスが要求されることがあります。ダイアログが表示された場合は、許可することも拒否することもできます。Vega仮想デバイスはマイクを使用しないため、どちらを選択しても問題はありません。ダイアログが表示されない場合は何もする必要はなく、開発とテストのエクスペリエンスにも影響はありません。

   Vega仮想デバイスは起動中にタイムアウトすることがあります。必要に応じて--timeoutフラグを使用して、待ち時間を延長してください。

   例：

   vega virtual-device start --timeout 120 
   

   このコマンドでは、仮想デバイスの起動プロセスの完了を120秒間待機します。

   Vega仮想デバイスを起動すると、UIが新しいウィンドウで開きます。

2. アプリを読み込んで実行します。

   vega run-app <vpkgのパス> <アプリID> -d VirtualDevice
   

   出力の例：

   vega run-app sampleapp.vpkg com.amazon.sampleapp.main -d VirtualDevice
   

   -dフラグは、Vega仮想デバイスでアプリを実行することを指定します。

   アーキテクチャ固有のコマンド

   正しく実行するには、仮想パッケージ（vpkg）のアーキテクチャが開発コンピューターのアーキテクチャと一致している必要があります。以下に例を示します。

   Mac Mシリーズデバイス：

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

   vega run-app build/aarch64-release/sampleapp_aarch64.vpkg com.amazondeveloper.sampleapp.main -d VirtualDevice
   

   x86_64デバイス：

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

   vega run-app build/x86_64-release/sampleapp_x86_64.vpkg com.amazondeveloper.sampleapp.main -d VirtualDevice
   

   ヒント： 初回インストールの後の起動には、vega device launch-appを使用します。起動し直してもアプリのデータは保持されます。

Vega仮想デバイスでアプリを停止する方法

Vega StudioのUIまたはコマンドラインを使用して、Vegaアプリを停止できます。

オプション1： Vega Studio UIを使用する

1. [Vega Studio] > [Devices] に移動し、[VirtualDevice:Tv] を選択します。

2. [stop] ボタンを選択します。

   VirtualDevice:Tvのステータスが停止に変わり、VVDウィンドウが閉じます。

オプション2： Vega CLIを使用する

Vega仮想デバイスを停止するには、仮想デバイスウィンドウを閉じるか、次のコマンドを実行します。

   vega virtual-device stop 

Vega仮想デバイスウィンドウが閉じ、プロセスが終了します。

オプションの構成

Vega仮想デバイスの登録（テスト用にAmazonのサービスを使用する場合のみ）

テスト用にAmazonのサービスを使用するには、Vega仮想デバイスを登録します。Vega仮想デバイスが起動したら、次の手順に従います。

1. Vega仮想デバイスのホーム画面の右上隅にある [Settings] の歯車アイコンを選択します。

   [Settings] 画面が表示されます。

   

2. [Account Settings] を選択します。

   ここには [Amazon Account] と [Parental Controls] の2つのオプションが表示されます。

   

3. [Amazon Account] を選択します。

   [Amazon Account] 画面が開き、[Register Account] ボタンが表示されます。

   

4. [Register Account] を選択します。

   画面に登録コードが表示されます。

5. ブラウザを開きます。

6. www.amazon.com/codeに移動します。

7. Vega仮想デバイスに表示された登録コードを入力します。

8. Vega仮想デバイスの画面に戻り、「Your device has successfully been registered」という確認メッセージが表示されるまで待ちます。

   

9. [OK] を選択します。

Vega仮想デバイスの起動時のカスタマイズ

Vega仮想デバイスには、起動時に使用できるカスタマイズオプションがあります。startコマンドの実行時に次のフラグを指定できます。

• グラフィカルユーザーインターフェイス（GUI）を非表示にします。

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

    vega virtual-device start --no-gui
  

• OpenGLアクセラレーションをオフにします（Ubuntu x86のみ）。

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

    vega virtual-device start --no-gl-accel
  

  ヒント： OpenGLアクセラレーションは、グラフィックスのパフォーマンスを向上させる機能です。オフにするのは、Ubuntu x86システムでディスプレイの問題のトラブルシューティングを行う場合だけにしてください。

• デフォルトのディスプレイ解像度を変更します。

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

    vega virtual-device start --display-res=1920,1080
  

inputd-cliの全機能を利用するための開発者モードの有効化

Vega仮想デバイスでは、デフォルトで限定的なinputd-cliコマンドが提供されています。開発者モードを有効にすると、自動化とテストのための完全なコマンドセットにアクセスできます。

1. 仮想デバイスのシェルを開きます。

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

   vega device shell -d VirtualDevice
   

2. 開発者モードの有効化：

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

   vsm developer-mode enable
   

   このコマンドを実行すると、VVDが再起動します。手順1を繰り返して、仮想デバイスのシェルに再接続します。

3. 全機能の確認：

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

   inputd-cli --help
   

レンダリングされたコンテンツのダンプ

レンダリングされたコンテンツのダンプ機能を使用すると、Vega仮想デバイスの画面に現在表示されているコンテンツを調べることができます。出力形式として、UI階層の完全なXMLレンダーツリーと、表示されているテキストのプレーンテキストでの抽出の2つが用意されています。この機能は、レイアウトの問題のデバッグ、UIコンテンツの検証、アクセシビリティプロパティの監査、ローカリゼーションテスト用のテキストの抽出に使用できます。

レンダリングされたコンテンツをダンプするには：

1. Vega仮想デバイス画面の任意の場所で、コンテキストメニューを開きます。

   

2. コンテキストメニューから次のオプションのいずれかを選択します。

   • [Dump Render Tree]： UI階層の完全なXML表現をエクスポートします。これには、すべてのコンポーネントプロパティ、位置、属性が含まれます。この出力は、Appium Inspectorで確認できるアプリのソースと同じです。

     このオプションを使用すると、レイアウトの問題をデバッグしたり、フォーカス可能状態やロールなどのアクセシビリティプロパティを監査したりできます。また、自動テストの作成に向けてUI構造を理解するためにも役立ちます。

   • [Dump Rendered Text]： UIから、表示されているテキストコンテンツのみを抽出します。

   このオプションを使用すると、エラーメッセージのチェック、ローカライズされた文字列の検証、画面上のテキストのレビューなど、コンテンツの確認をすばやく行うことができます。

3. ファイルの保存ダイアログで、保存先の場所とファイル名を選択します。

   • レンダーツリーは、デフォルトで.xmlとして保存されます。
   • レンダリングされたテキストは、デフォルトで.txtとして保存されます。

4. 保存後、ファイルが自動的にデフォルトのアプリで開きます。

[Dump Render Tree] の出力例（XML）：

<?xml version="1.0"?>
<root id="1">
  <app id="4294967297" appName="com.amazon.myapp">
    <window x="0" y="0" width="1920" height="1080" id="4294967298">
      <child x="100" y="200" width="300" height="50" role="button" focusable="true">
        <text>ここをクリック</text>
      </child>
    </window>
  </app>
</root>

[Dump Rendered Text] の出力例（TXT）：

ここをクリック
アプリへようこそ
設定

ペアレンタルコントロールの有効化

ペアレンタルコントロールを有効にすると、デバイスでアプリの起動保護がアクティブになっているときのアプリの動作をテストできます。開発中にはこの機能を使用して、アプリがPINゲートを正しく処理するかどうかを確認します。

ペアレンタルコントロールを有効にするには：

1. Vega仮想デバイスを登録します（まだ登録していない場合）。

   Vega仮想デバイスの登録を参照してください。

2. [Account Settings] 画面から、[Parental Controls] を選択します。

   [Parental Controls] 画面が開き、[Enable Parental Controls] ボタンが表示されます。

   注： [Enable Parental Controls] がグレー表示になる場合は、Vega仮想デバイスが登録されていません。先に進む前に、Vega仮想デバイスの登録の指示に従ってください。

   

3. [Enable Parental Controls] を選択します。

4. 画面に表示される円形のダイヤルを使用して、Prime VideoのPINを作成または入力します。

   これはAmazonアカウントに関連付けられているPINです。まだ設定していない場合は、デバイスから新しい5桁のPINを作成するように求められます。PINはamazon.com/pinでも管理できます。

   

   仮想リモコンの方向パッドを使用して番号を入力します（デフォルトでは0～4が表示されます。大きい数字に切り替えるには、[5-9] を選択します）。

5. PINが検証されるまで待ちます。

   

   検証に成功すると、[Parental Controls] 設定画面に次のオプションが表示されます。

   • [Disable Parental Controls]： ペアレンタルコントロールをオフにします。
   • [Change PIN]： Prime VideoのPINを更新します。
   • [Protect App Launches: ON]： 有効な場合、デバイスでアプリを起動するたびにPINのプロンプトが表示されます。

アプリの起動保護をテストするには：

ペアレンタルコントロールを有効にして [Protect App Launches: ON] に設定した後、ホーム画面に移動して任意のアプリを起動します。[マイアプリ] 画面に、PINの入力ダイアログが重ねて表示されます。ユーザーが有効なPINを入力した後にのみアプリが起動します。

ペアレンタルコントロールを無効にするには：

1. [Settings] の歯車アイコンを選択し、[Account Settings] > [Parental Controls] の順に選択します。

2. [Disable Parental Controls] を選択します。

3. プロンプトが表示されたらPINを入力します。

キーボードショートカット

Vega仮想デバイスを制御するには、次のキーボードショートカットを使用します。

Vega仮想デバイスに関するフィードバックの送信

Vega仮想デバイスの使用体験に関するフィードバックは、エミュレーターまたはターミナルから直接共有できます。システムによって個人を特定できる情報が収集されることはありません。フィードバックに含まれるのはセッションメタデータ（VVDのバージョン、イメージタイプ、ホストOS）だけです。

エミュレーターから（macOSおよびLinux）：

Vega仮想デバイス画面の任意の場所でコンテキストメニューを開き、[Send Feedback...] を選択します。デスクトップブラウザで簡単なアンケートが開きます。

macOSのメニューバーから：

Vega仮想デバイスの実行中に、アプリのメニューバーから [Feedback] > [Provide Feedback...] の順に選択します。

ターミナルから：

次のコマンドを実行すると、いつでもフィードバックアンケートを開くことができます。

   vega virtual-device feedback

また、vega virtual-device stopを実行すると、セッションの評価をたずねる1行のプロンプトが表示されます。1（良い）、2（悪い）、Enter（スキップ）のいずれかを押してください。悪い評価を選択すると、ブラウザでアンケートが開きます。

How was this VVD session? 👍 👎 [Skip]

フィードバックの送信後、このCLIプロンプトは7～14日間再表示されなくなります。GUIのエントリポイント（メニューバー、コンテキストメニュー）はいつでも利用でき、ワークフローを中断することはありません。

CLIプロンプトを無効にするには：

次の環境変数を設定します。

   export KEPLER_CSAT_DISABLED=true

このプロンプトは、CI/CDパイプラインや非対話型のターミナルでは自動的にスキップされます。

高速リフレッシュの設定

コード変更を自動的に検出し、更新をリアルタイムでVega仮想デバイスに表示するには、高速リフレッシュを設定します。

トラブルシューティング

Vega仮想デバイスで問題が発生した場合は、Vega仮想デバイスに関する問題のトラブルシューティングを参照してください。