as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
开发
测试
应用发布
盈利
用户参与
设备规格
资源

EMBER示例

EMBER示例

本页提供使用娱乐资源增强元数据桥 (EMBER) 格式的常见集成场景的完整目录示例。每个示例都介绍了从策略和节目到优惠的完整目录结构。

示例1: VOD目录

此示例说明如何为包含电影和电视连续剧的流媒体服务构建视频点播 (VOD) 目录。内容可通过免费套餐(含广告)和高级套餐(4K,无广告)获得。

创建VOD目录的概要步骤包括:

  1. ProgramCatalog中定义节目元素,例如电影、电视连续剧。
  2. OfferCatalog中定义节目的优惠。
  3. PolicyCatalog中为订阅级别定义权利策略。

VOD密钥要点

  • 当层级之间的属性不同(例如,不同的视频分辨率)时,为每个层级创建单独的ProgramOffers
  • 使用LaunchTarget在您的应用中提供内容深层链接。如果您的应用完成了启动器集成并且与亚马逊建立了深层链接模式,则可以跳过LaunchTarget。在这种情况下,亚马逊使用您的深层链接模式并应用您目录中的节目ID来创建指向应用的特定于内容的深层链接。
  • 高级套餐通常包括4K、HDR和Dolby Atmos。
  • 务必包含外部ID,尤其是IMDB。

示例2: 体育赛事直播目录

此示例说明如何为应用中直播的NFL比赛(西雅图海鹰队和旧金山49人队)构建目录。该比赛在主队市场有封锁限制,需要订阅体育套餐。

下表总结了基于应用的直播和线性广播之间的区别。

功能 基于应用的直播 线性广播
目录元素 ProgramCatalog中的SportsEvent
OfferCatalog中的ProgramAiringOffers
PolicyCatalog中的RegionPolicyEntitlementPolicy
ProgramCatalog中的SportsEvent
ScheduleCatalog中的Schedule
StationCatalog中的Station
OfferCatalog中的StationOffers
PolicyCatalog中的RegionPolicyEntitlementPolicy
访问模型 需要特定于应用的权利 任何收看该电视台的人都可获得
销售国家(地区) 有时间限制的时段(开始和结束) 在特定时间在特定频道上广播
示例 应用中的独家NFL比赛、音乐会直播、按次付费观看的活动 CBS播出的NFL比赛,当地附属机构播出的新闻(参见示例4

创建直播活动目录的概要步骤包括:

  1. ProgramCatalog中定义体育赛事节目或活动。
  2. OfferCatalog中定义节目的优惠。
  3. PolicyCatalog中为封锁区域定义区域策略,以及定义体育订阅套餐的权利策略。

直播体育要点

包括详细的体育元数据,例如球队、联赛、场地和开球时间。使用以下最佳实践:

  • 对于体育使用官方联盟名称。例如,使用“美式足球”,而不只是“足球”。
  • 仅对一支球队设置homeTeam="true"
  • EventDateTime设置为实际开球时间,而非广播开始时间。
  • Venue中加入完整地址。
  • 使用Credit添加播音员和评论员。

使用PolicyCatalog目录中设置的邮政编码实施封锁规则。当优惠包含多个GeoRestriction元素时,这些元素使用AND逻辑。例如,该活动在西雅图和旧金山被封锁。

在同一个目录更新中同时提交直播和重播优惠,以便从直播无缝过渡到点播。

直播活动优惠:

  • 使用ProgramAiringOffers(非ProgramOffers)。
  • startend属性定义了从赛前到赛后的可用性时段,并且该优惠只能在此时段内访问。
  • 包含完整的Airing元素,而不仅仅是引用。

VOD重播优惠:

示例3: 外部电视台目录

此示例说明如何引用来自Gracenote视频数据 (GVD) 或Tribune媒体服务 (TMS) 的外部电视台元数据,而不是从头开始创建电视台定义。这种方法非常适合提供多个频道并拥有Gracenote电视台ID的有线或卫星提供者。

创建外部电视台目录的概要步骤包括:

  1. StationCatalog中将ExternalStation定义为来自GVD或TMS的引用电视台。
  2. OfferCatalog中定义电视台的优惠。
  3. 使用PolicyCatalog中的区域和权利策略定义您的服务区域和订阅级别。

外部电视台要点

外部电视台可让您使用由GVD或TMS维护的专业元数据,而无需自己创建或维护电视台定义。这样可以为所有服务和设备提供一致的命名。

您可以覆盖TitlesImages中的数据。但是,请尽可能使用外部数据,仅在必要时才覆盖。您想要覆盖的可能原因包括:

  • 自定义品牌,例如您的标志和标题样式
  • 营销或促销目的
  • 外部数据中不存在的语言本地化

您无法覆盖其他数据,例如CallSignDescriptionsGenres中包含的数据。该元数据继承自外部系统,并在外部提供者更新其记录时自动更新。

如果您有订阅级别,请使用EntitlementPolicy来定义套餐级别,并在StationOffers中引用它们。

请记住:

示例4: 完整的线性电视台目录

此示例说明如何将西雅图的当地CBS分支机构 (KIRO 7) 与当地有线电视提供者的24小时广播节目表、节目元数据、电视台信息和频道时间表整合在一起。

创建线性电视台目录的概要步骤包括:

  1. 创建播出的节目。

    线性广播电视台播出多种内容类型。在您的目录中纳入所有节目类型:电影、具有完整层次结构的电视连续剧、体育赛事和本地节目。

    常见节目类型的详细信息:

    • Movie: 在广播电视上播出的剧场版。
    • TVSeries/TVSeason/TVEpisode: 网络黄金时段节目,具有完整的层次结构。
    • SportsEvent: 本地球队比赛,在区域体育网络上播出。
    • Other: 本地新闻、资讯广告节目(非标准类别)。

    有关支持的节目类型元素的完整列表,请参阅ProgramCatalog

  2. 创建每日广播节目表。

    使用Schedule元素引用一天中的所有节目类型,并遵循以下最佳实践:

    • 以YYYY-MM-DD格式纳入date属性。
    • 所有时间均使用UTC时区。
    • 使用Live进行实时广播,使用New进行首次播出或首映。
    • 对于录制或重复的内容,省略LiveNew元素。
    • 确保24小时覆盖,无间隙或重叠播出。
  3. 定义电视台访问权限。

    创建StationOffers元素来定义客户如何访问电视台。

  4. 定义您的电视台。

    使用品牌、网络隶属关系和广播详情创建完全定义的Station元素。

  5. 为有线电视提供者创建频道时间表。

    LineupCatalog中,定义您的电视台在有线电视提供者的频道时间表中的显示方式。

  6. 定义广播区域策略。

    PolicyCatalog中,使用邮政编码精确定义您的广播覆盖区域。

线性广播要点

  • 在创建引用该电视台的时间表之前,请先定义该电视台。
  • 节目表必须包含date属性(YYYY-MM-DD格式),并涵盖整个24小时广播日。
  • 所有时间都必须采用UTC(Z时区)。
  • 包括用于时间表整合的频道号和技术传输ID。
  • 使用邮政编码来实现精确的地理覆盖范围。


Last updated: 2026年5月28日