开始使用直播活动

Fire TV活动为独立活动，既可以实时观看（直播活动），也可以日后重播。体育赛事和音乐会直播均为典型的直播活动。

有关线性电视、视频点播和直播活动的更多信息，请参阅重要定义。

先决条件

• 访问您的Fire TV应用的源代码。
• 支持此集成的Fire TV设备。请咨询您的亚马逊联系人，获取当前支持的设备类型列表。

集成概述

直播活动需要进行两项集成：

1. 与Vega EPG提供方集成，以提供客户的活动权利和元数据，并在Fire TV上为您的内容实现浏览体验。
   1. 如果您的应用不提供线性电视，则EpgSyncTask可以不包含ingestChannelLineup和ingestProgramLineup步骤，您也可以忽略频道和节目特有的详细信息。
2. 利用内容启动器来启动直播活动播放。
   1. 在“内容启动器集成指南”的步骤3中，当调用handleLaunchContent() API时，会将您通过Vega EPG提供方提供的MediaId作为contentSearch参数的一部分来传递。请参见下面的示例代码。

      复制代码 已复制到剪贴板。

      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"是您通过Vega EPG提供方提供的MediaId.catalogName。
                     // "contentId"是您通过Vega EPG提供方提供的MediaId.contentId。
                     // 开始直播活动播放 
                  }
               }
            }
                  
            // 终结逻辑
         },
      };
      

集成详细信息

支持的内容

以下是我们支持的视频内容：

1. 预定直播和未来活动 - 如付费观看活动或奥运会。
2. 点播和重播 (VOD) - 可随时按需观看。
3. 精彩亮点、赛事集锦、访谈（短篇VOD）- 与第2类类似，但时长更短，例如赛事亮点。
4. 即时直播活动 - 直播信息提要，如Twitch信息提要。

内容支持： 预定活动

对于具有已知日程安排的活动（例如体育赛事），请使用SCHEDULED_EVENT类型。请注意以下事项：

1. Fire TV将显示预定在7天内播出的活动，并且会在其结束时间过后自动从用户界面中移除。因此，您可以推送计划播出日期与当前日期相距远超7天的活动，无需担心活动过早显示或未能按时删除。
2. 当前播放的活动将在磁贴上显示LIVE徽标，告知用户活动处于正在播放的状态。未进行播放时，则会隐藏LIVE徽标。
3. 活动磁贴底部会出现红色进度条，告知用户活动的进度。

内容支持： 重播

对于直播内容的重播（例如重播之前的体育赛事），请使用REBROADCAST类型。如果客户退出再通过Fire TV用户界面重新进入，则最佳实践是从客户上次观看的位置开始播放。

内容支持： 剪辑

对于内容的短视频剪辑（例如体育赛事集锦），请使用CLIP类型。

内容支持： 即时活动

对于即时活动（例如直播视频博客），请使用INSTANTANEOUS_EVENT类型。即时活动将在磁贴上显示LIVE徽标，告知用户活动处于正在播出的状态。

活动授权和订购

在EPG同步任务执行期间或应用处于活动状态时，可以在后台使用LiveEventProvider接口提供直播活动。应仅提供客户有权查看的内容，而对于向客户显示的所有内容，授权将以最后提交的数据集为准。对所提供直播活动的更改会在5分钟内反映在用户界面中。

应用播放的活动根据所提供的SortRank排序，并可回退到按活动title字母顺序排序。请将最重要的内容置于前排，并将当前播出的节目放在这一行的前面加以突出，使其最为显眼。

插入内容

• 插入至少5个磁贴，填满旋转显示区域。如果可用的直播活动数量少于5个，则Fire TV将隐藏您的行。为了始终保持最低数量，请考虑添加重播或短视频剪辑。
• 为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	播出时间（例如： 23:00至24: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: 2025年9月30日