VegaライブTVの問題

ライブTVログのキャプチャ

問題をデバッグしたり、Amazonにバグを報告したりするには、次のメカニズムを使用してログをキャプチャします。

1. アプリをデバイスにプッシュまたはインストールする前に、ログキャプチャプロセスを開始します。
2. 以下を使用してログ設定を構成します。

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

    loggingctl config --set-rate all 60000
   

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

    loggingctl config --set-level all info
   

3. デバイスを再起動し、ログのキャプチャを開始します。

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

    vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync\|kepler.script.channel"
   

4. Amazonにバグチケットを提出する必要がある場合は、device_logs.txtファイル全体を共有してください。

ライブTV検証ツール

ライブTV検証ツールは、ライブTV統合を評価する目的で設計されています。このツールはマニフェストファイルまたはVPKGを検証し、実装を全般的にチェックします。これは、ライブTV統合の基本的なコンプライアンスを検証し、潜在的な問題を特定するための便利な手段となります。

TOMLファイルを検証するには

vega exec livetv_validator <manifest.tomlのパス>

VPKGファイルを検証するには

vega exec livetv_validator <vpkgのパス> <出力ディレクトリ>

EPG同期タスクが不変条件違反でクラッシュする

EPG同期タスクが次のようなエラーでクラッシュすることがあります。

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

Invariant Violation: TurboModuleRegistry.getEnforcing(...): 'DeviceInfo' could not be found.Verify that a module by this name is registered in the native binary., js engine: hermes.

トラブルシューティングのガイダンスについては、Vegaヘッドレスタスクおよびサービスを参照してください。

[放映中のチャンネル] 行または番組表にチャンネルが表示されない

• Amazonの担当者に連絡して、前提条件に従ってライブTVの許可リストに登録されていることを確認してください。

• EPG同期タスクが正常に実行されていることを確認します。

  1. アプリをデバイスにインストールします。
  2. 数秒以内にEPG同期タスクが実行されます。次のコマンドでアプリのログを検索して検証することもできます。

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

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
     

     正常な場合、ログを確認すると次のメッセージが表示されます。

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

      INFO ktf.tm.nests:Successfully scheduled EPG Sync Task.
     

  3. デバイスを再起動します。
• チャンネル変更と再生が有効になっていることを確認します。

[放映中のチャンネル] でチャンネルが空のタイルとして表示され、画像が表示されない（チャンネル名のみが表示される）

• チャンネルをGracenoteに統合していない場合は、ソフトウェアがProgram.thumbnailUrl（UXフィールドリスト）を正しく実装しているかどうかを確認してください。
• Gracenoteが統合されている場合は、以下を参照してください。

Gracenote IDが割り当てられているチャンネルのメタデータが [放映中のチャンネル] または番組表に表示されない

• フィードがonTVとGVDのどちらに対応しているかを確認し、外部IDとして正しく定義します。特定のマーケットプレイスのAmazonカタログでは、onTVがサポートされています。保有しているGracenote IDのタイプがAmazonでサポートされるタイプと一致しない場合は、Amazonの担当者に詳細をお問い合わせください。担当者がGracenoteと協力して問題を解決します。
• Gracenote ID値を再度確認してください。onTVでは数値のみが使用されていますが、GVDでは英数字が使用されています。

番組のタイルをクリックしてもアプリが起動しない

• システムがmanifest.tomlファイルを正しく更新したかどうかを確認してください。
• チャンネル変更リクエストがソフトウェアから正常に送信されることを確認します。
  • 次のコマンドでアプリのログを検索して検証できます。

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

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    

  • 正常な場合、ログを確認すると次のメッセージが表示されます。

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

    INFO ktf.tm.channel.client:changeChannel request successful: true
    

プログラムタイルをクリックするとアプリが起動するが、コンテンツが再生されない

• ソフトウェアがチャンネルハンドラーを正しく実装しているかどうかを確認してください。
• ソフトウェアがチャンネルハンドラーを正常に呼び出したことを確認します。
  • 次のコマンドでアプリのログを検索して検証できます。

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

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    

  • 正常な場合、IChannelSeverComponent2、ChannelServerComponent2、IChannelServer2インターフェイスを使用していれば、システムで次のログが生成されます。

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

    INFO kepler.script.channel:handleChangeChannelAsync invoked with <コンテンツID> 
    

関連トピック

• リニアTVについて
• VegaライブTV APIの概要
• LoggingCtlによるシステムログと診断の管理

Last updated: 2026年2月24日