开始使用直播活动

Fire TV活动为独立活动，既可以实时观看（直播活动），也可以日后重播。体育赛事和音乐会直播均为典型的直播活动。 有关线性电视、视频点播和直播活动的更多信息，请参阅重要定义。

​

先决条件

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

​

集成概述

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

1. 与Vega EPG提供方集成以获取用户活动权利和元数据，这样用户就可以浏览和发现您的内容。
   1. 如果您的应用不提供线性电视，则EpgSyncTask可以不包含ingestChannelLineup和ingestProgramLineup步骤，并忽略频道和节目详细信息。
2. 利用内容启动器来启动直播活动播放。
   1. 在内容启动器集成指南的步骤3中，当调用handleLaunchContent() API时，会将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分钟内从旋转显示区域中移除已结束的活动。您的应用应当在下一次定期同步时从提供的列表中移除过期的直播活动内容。

用于徽标的各种属性。请参阅数据类型参考页面的属性一节。

​

元数据属性

下表列出了可能使用的元数据及其使用方法。

​

相关主题

• Vega直播TV API概述
• Vega直播TV的问题

---