Fire TV Stickに関する問題の解決

このページは、Vega SDKを使用して開発する際のFire TV Stickデバイス特有の一般的な問題を解決するのに役立ちます。解決策が見つからない場合は、開発者フォーラムに問題を投稿して支援を求めてください。

無線（OTA）アップデート後、Fire TV Stickが常に再起動する

原因： KPI Visualizerの使用中にサポートされていない開発者モード値を設定すると、OTA更新後に起動ループが発生します。

解決策： 以下のいずれかのコマンドを使用して開発者モードを無効にします。

   kepler exec vda wait-for-device && kepler exec vda shell vsm developer-mode disable

または

   kepler exec vda wait-for-device && kepler exec vda shell vdcm set com.amazon.devconf/system/security/developer_mode disable

コマンドを実行すると、デバイスは再起動を停止し、正常に機能します。

コンピューターのUSB経由で電源を入れると、Fire TV Stickが再起動する

原因： ラップトップのUSBポートからの電力供給が不十分です。このデバイスは5Vで最大1アンペアを必要としますが、HD/4Kビデオ、オーディオコンテンツのストリーミング、または弱いWi-Fiでの操作など、CPU使用率が高いシナリオでは、多くのラップトップUSBポートでは供給できません。

解決策： 次のいずれかのオプションを使用してください。

オプション1： USB Yケーブルを使用する

USB Yケーブルを使用してFire TV Stickを接続すると、ノートパソコンのUSBポートとAmazonが提供するUSB電源アダプターの両方から電力を引き出すことができます。

オプション2： 電源付きUSBハブを使用する

Fire TV Stickは、1アンペア以上を供給できる独立電源のUSB3.0ハブを介して接続します。

Fire TV StickがOTAアップデートを受信しなかった

原因： デバイスがWi-Fiネットワークに接続されていないか、手動更新トリガーが必要な可能性があります。

解決策：

1. VDAシェルを開きます。

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

   kepler exec vda shell
   

2. デバイスのネットワーク接続を確認します。

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

   ace mw wifi_cli get_net_state
   

   このコマンドの出力として、networkState: CONNECTEDが返される必要があります。デバイスが接続されていない場合は、Fire TV Stickを参照してください。

3. 手動更新を強制する：

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

   kepler exec vda shell ace mw ota forceUpdate
   

OTAアップデートの検証が失敗する

原因： 更新が正常に完了し、予想されるSDKバージョンと一致していることを確認する必要があります。

解決策：

1. デバイスのos-releaseを確認してください。

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

   kepler exec vda shell cat /etc/os-release | grep <バージョン番号>
   

   <バージョン番号>をデバイスのリリースバージョン番号に置き換えます。

2. 返されたバージョン番号が最新のSDKバージョンと一致することを確認します。

デバイスを工場出荷時の設定にリセットする必要がある

原因： デバイスを元の状態に完全に復元し、Wi-Fi、リモートペアリング、および登録情報を削除する必要があります。

解決策： 工場出荷時の設定にリセットするコマンドを実行します。

   kepler exec vda shell vfr reset --type shallow

デバイスで実行中のアプリの終了

原因： アプリが応答しない、リソースを過剰に消費している、またはテストを妨げています。

1. VDAシェルを開きます。

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

   kepler exec vda shell
   

2. 実行中のアプリの一覧を表示します。

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

   vlcm list
   

   出力サンプル：

   application                           type      pid     id    state          lifespan       timeout container                               launch args
   com.amazondeveloper.keplersampleapp.main       S         2719    1     VISIBLE        PERMANENT      DEFAULT framework.slice/service                 <none>
   

3. パッケージ名を使用してアプリを終了します。

   例：vlcm terminate-app --pkg-id com.amazondeveloper.keplersampleapp

デバイスからのアプリのアンインストール

原因： テストまたはクリーンアップの目的でアプリを削除する必要があります。

解決策： uninstallコマンドを実行します。

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

   vpm uninstall <パッケージID>

<packageId>を、アプリのパッケージIDに置き換えま（(例：com.foo.keplersampleapp）。

バックグラウンド／フォアグラウンド間でのアプリの移動

原因： テストまたはデバッグでは、アプリの状態をバックグラウンドとフォアグラウンドの間で変更する必要があります。

解決策： アプリをバックグラウンドに移動するには：

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

   vlcm trigger-app background --inst <インスタンスID>

<インスタンスID>をアプリのインスタンスIDと置き換えます。

アプリをフォアグラウンドに移動するには：

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

   vlcm trigger-app foreground --inst <インスタンスID>

<インスタンスID>をアプリのインスタンスIDと置き換えます。

関連トピック

• Fire TV Stickでのアプリの実行

Last updated: 2025年9月30日