ライブイベントについて

Fire TVのイベントとは、視聴時にリアルタイムで進行するか（ライブイベント）、後で再放送されるスタンドアロンイベントです。ライブイベントの例として、スポーツイベントやライブコンサートがあります。

リニアTV、ビデオオンデマンド、ライブイベントの詳細については、重要な定義を参照してください。

前提条件

• Fire TV対応アプリのソースコードにアクセスできる。
• この統合がサポートされているFire TVデバイスを使用できる。現在サポートされているデバイスタイプのリストについては、Amazonの担当者に確認してください。

統合の概要

ライブイベントを提供するには、次の2つの統合作業が必要です。

1. Vega EPGプロバイダーと統合して、ユーザーのイベント視聴権限とメタデータを提供する。これにより、ユーザーがコンテンツを参照して見つけられるようになります。
   1. アプリでリニアTVを提供しない場合は、EpgSyncTaskからingestChannelLineupとingestProgramLineupのステップを除外し、チャンネルと番組の詳細を無視します。
2. コンテンツランチャーを利用してライブイベントの再生を開始する。
   1. コンテンツランチャー統合ガイドの手順3で、handleLaunchContent() APIが呼び出されるときに、contentSearch引数の一部としてMediaIdが渡されます。次のサンプルコードを参照してください。

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

      const contentLauncherHandler: IContentLauncherHandler = {
         async handleLaunchContent(
            contentSearch: IContentSearch,
            _autoPlay: boolean,
            _optionalFields: ILaunchContentOptionalFields,
         ): Promise<ILauncherResponse> {
            // コンテンツランチャーのその他のロジック
      
            const searchParameters = contentSearch.getParameterList();
            if (searchParameters.length > 0) {            
               for (let j = 0; j < searchParameters.length; j++) {
                  const externalIdList = searchParameters[j].getExternalIdList();
                  for (let i = 0; i < externalIdList.length; i++) {
                     const catalogName = externalIdList[i].getName();
                     const contentId = externalIdList[i].getValue();  
                              
                     // 「catalogName」は、Kepler EPGプロバイダーを通じて提供したMediaId.catalogNameです。
                     // 「contentId」は、Kepler EPGプロバイダーを通じて提供したMediaId.contentIdです。
                     // ライブイベントの再生を開始します。
                  }
               }
            }
                  
            // 終了ロジック
         },
      };
      

統合の詳細

サポートされているコンテンツ

Amazonがサポートするビデオコンテンツは次のとおりです。

1. 予約されたライブイベントや今後のイベント：有料視聴イベントやオリンピックの試合など。
2. キャッチアップと再放送（VOD）：いつでも視聴可能。
3. ハイライト、試合のダイジェスト、インタビュー（短い形式のVOD）：2と似ているが、それよりも短めなコンテンツ（試合のハイライトなど）。
4. リアルタイムのライブイベント：Twitchフィードなどのライブフィード。

コンテンツのサポート： スケジュールされているイベント

スケジュールがわかっているイベント（スポーツイベントなど）には、SCHEDULED_EVENTタイプを使用します。次のガイダンスに注意してください。

1. Fire TVは、7日以内に放送がスケジュールされているイベントを表示し、終了時刻が過ぎると自動的にUIから削除します。したがって、イベントが早すぎるタイミングで表示されたり、終了時に削除されなかったりする心配をせずに、この7日間の後に実施されるイベントをプッシュできます。
2. 現在放送中のイベントには、放送中というステータスをユーザーに伝えるライブバッジがタイルに表示されます。ライブバッジは、放送されていないときは非表示になります。
3. イベントタイルの下部には、イベントの進行状況をユーザーに知らせる赤い進行状況バーが表示されます。

コンテンツのサポート： 再放送

ライブコンテンツの再放送（以前のスポーツイベントの再放送など）には、REBROADCASTタイプを使用します。ユーザーがいったん視聴を終了し、Fire TVのUIを通じて再びアクセスした場合は、最後に視聴していた時点から再生を開始することがベストプラクティスです。

コンテンツのサポート： クリップ

短いビデオクリップのコンテンツ（スポーツイベントのハイライトなど）には、CLIPタイプを使用します。

コンテンツのサポート： リアルタイムのイベント

その場で進行するリアルタイムのイベント（ライブビデオブログなど）には、INSTANTANEOUS_EVENTタイプを使用します。リアルタイムのイベントには、放送中というステータスをユーザーに伝えるライブバッジがタイルに表示されます。

イベントの権限状態と順序

ライブイベントは、EPG同期タスクの実行中またはアプリがアクティブなときに、バックグラウンドでLiveEventProviderインターフェイスを使用して提供されます。ユーザーには、視聴権限のあるコンテンツのみを提供してください。最後にコミットされたデータセットが、ユーザーに表示されるすべてのコンテンツの取得元として参照されます。ライブイベントへの変更が提供されると、5分以内にUIに反映されます。

アプリのイベントの並べ替え順序はsortRankの指定に基づいて決まり、指定されていない場合はtitleのアルファベット順にフォールバックします。最も重要なコンテンツを最初に配置し、現在放送中の番組を行の先頭に置いて一番目立つように強調してください。

コンテンツの挿入

• カルーセルを完全に埋めるために、少なくとも5枚のタイルを挿入します。Fire TVでは、利用可能なライブイベントの数が5個に満たない場合、行が非表示になります。最小限の数を常に維持するために、再放送や短いビデオクリップを追加することを検討してください。
• 表示可能なイベントタイトルを LiveEvent.title フィールドに指定します。Fire TVでは最大25文字の英数字が表示されますが、文字数がこの制限を超えると、ライブイベントの完全なタイトルは表示されません。この上限は、半角・全角のどちらの文字セットにも適用されます。以下に例を示します。
  • The Walking Dead Universe（最大文字数内-表示される）。
  • Ed's Purple Plane（最大文字数内-表示される）。
  • How Sally Fell off her Horse and Learned to Play Piano on a Saturday（25文字を超えるため、最大文字数外-表示されない）。
  • エドのパープルプレイン（最大文字数内-表示される）。
• ライブイベントに必要なメタデータをすべて指定します。詳細については、メタデータ属性を参照してください。
• 同期の頻度を最小限に抑えるために、今後放送予定のイベントを事前に提供します。Fire TVでは、イベント行ごとのタイルの数は最大15個に制限されています。終了したイベントは、終了時刻を過ぎてから5分以内にカルーセルから削除されます。アプリでは、次回の定期同期で提供するリストから、期限切れのライブイベントコンテンツを削除する必要があります。

バッジにはさまざまな属性が使用されます。データの種類のリファレンスページの属性セクションを参照してください。

メタデータ属性

次の表は、使用できるメタデータとその用途を示しています。

メタデータフィールド	説明	認定に必須（○/×）
LiveEvent.identifier	ライブイベントの一意の識別子。	○
LiveEvent.eventType	ライブイベントのタイプ。詳細については、サポートされているコンテンツを参照してください。	○
LiveEvent.playbackReference	ライブイベントの再生を開始するために必要なメタデータが含まれます。	○
LiveEvent.startTime LiveEvent.endTime	放送時間（例： 午後11:00～午前12:00）。イベントタイトルのすぐ下に表示されます。	○ *スケジュールされているイベントのみ
LiveEvent.title	イベントのタイトル。コンテンツタイルとミニ詳細に表示されます。	○
LiveEvent.description	イベントの説明。ミニ詳細に表示されます。	○
LiveEvent.ratings	ライブイベントに推奨される保護者の助言・指導のレベルを示すレーティングのリスト。ライブイベントが放送される国や地域で使用されている任意のレーティングシステムに従うことができます。	×
LiveEvent.genres	ライブイベントに適用されるジャンルのリスト。	×
LiveEvent.logoUrl	アプリのロゴのURL。	×
LiveEvent.posterArtUrl	コンテンツタイルと背景画像の両方に使用される16:9の画像。	○
LiveEvent.attributes	バッジにはさまざまな属性が使用されます。データの種類のリファレンスページの属性セクションを参照してください。	×
LiveEvent.sortRank	行内のライブイベントの順序を設定します。値の小さいイベントが最初に表示されます。	×

関連トピック

• VegaライブTV APIの概要
• VegaライブTVの問題

---

Last updated: 2026年1月22日