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ファイルを検証するには

kepler exec livetv_validator <manifest.tomlのパス>

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

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

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

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

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

E Volta:[KeplerScript-JavaScript] 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: 2025年9月30日