Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases

Console

as

開発
設計と開発
公開
リファレンス
サポート

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

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

Vega仮想デバイスまたはFire TV Stickを使用して、Vegaアプリを実行する方法について説明します。各ツールは、それぞれ異なる開発ニーズに対応しています。 Vega仮想デバイスは迅速なイテレーションに適している一方、Fire TV Stickは本番環境に向けた実行に適しています。


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

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

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

前提条件

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

  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. [再生] ボタンをクリックして仮想デバイスを起動します。

  3. VVDウィンドウが開き、デバイスの読み込みが完了するまで待ちます（VirtualDevice:Tvのステータスは「読み込み中...」ではなく「準備完了」になります）

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

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

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

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

    vega virtual-device start

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

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

    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仮想デバイスでアプリを停止する方法

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

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

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

  2. [stop] ボタンをクリックします。

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

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

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

   vega virtual-device stop

オプションの構成

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

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

  1. 右上の [Register this device] をクリックします。
  2. 画面に表示されている登録コードを記録します。
  3. www.amazon.com/codeにアクセスして、コードを入力します。

  4. 次のメッセージが表示されたら登録は完了です。

    Your device has successfully been registered

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

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

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

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

     vega virtual-device start --no-gui

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

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

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

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

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

     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仮想デバイスを制御するには、マウスでクリックする代わりに、次のキーボードショートカットを使用します。

Fire TV Stickのリモコンボタン Vega仮想デバイスのキーボードキー
選択 ENTER
上、下、右、左 矢印キー
戻る ESC
ホームページ F1
メニュー F2
早戻し F3
再生／一時停止 F4
早送り F5

高速リフレッシュの設定

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

トラブルシューティング

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


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. ネットワーク認証情報を入力します。

  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： 開発者モードを構成する

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

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

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

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

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

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

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

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

    [My Fire TV] 設定メニューの [バージョン情報] オプションを示すスクリーンショット。

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

    [バージョン情報] 画面の [Fire TV Stick 4K Select] オプションを示すスクリーンショット。

  3. [Fire TV Stick 4K Select] を選択します。

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

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

    [My Fire TV] 設定画面の [開発者オプション] メニューを示すスクリーンショット。

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

    [開発者オプション] で [開発者モード] のステータスが [無効] として表示されているスクリーンショット。

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

    デフォルトでは、[開発者モード] は [無効] になっています。

  7. [開発者モード] を選択して有効にします。

    「Your Fire TV is Powering Off」という再起動のメッセージを示すスクリーンショット。

  8. 「Your Fire TV is Powering Off」というメッセージが表示されたら、デバイスが再起動するまで待ちます。

  9. デバイスが再起動したら、リモコンの戻るボタンを使用して、[My Fire TV] > [開発者オプション] > [開発者モード] に移動します。

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

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

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

    vega device list

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

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

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

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

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

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

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

      vega device shell

    • 接続されているデバイスが複数ある場合は、DSNを指定します。

      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に関する問題の解決を参照してください。

Last updated: 2026年3月25日

フォローする

サポート対象デバイス

amazon_developer_logo

© 2010-2026, Amazon.com, Inc. or its affiliates. All Rights Reserved. 無断複写·転載を禁じます。

利用規約

Amazon開発者ブログ

お問い合わせ