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アンペアを必要としますが、ストリーミングや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アップデートの検証が失敗する

原因： OTAアップデートが正常に完了したか、または予想されるSDKバージョンと一致しているかをシステム側で確認できません。

解決策：

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

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

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

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

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

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

原因： システムの破損または永続的な構成の問題により、デバイスが正常に機能していません。

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

   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年11月14日