EMBER目录集成概述

目录集成是将您的媒体元数据提交给亚马逊的过程，这样客户就可以在亚马逊设备（包括Fire TV、Echo Show和其他支持Alexa的设备）上发现和播放您的内容。

您在目录文件中描述您的媒体内容（电影、电视节目、直播活动、广播频道），该目录文件符合娱乐资源增强元数据桥 (EMBER) 要求，后者是亚马逊娱乐内容元数据的XML架构。然后，将此目录文件上传到Amazon S3存储桶中。引入后，亚马逊会运行内容匹配流程，并将您的元数据整合到一个主要内容数据库中，该数据库支持在多个设备上进行发现和播放。

支持的内容类型

内容类型	描述	EMBER元素
电影	故事片、纪录片	Movie
电视节目	连续剧、季、剧集	TVSeries、TVSeason、TVEpisode
体育	直播运动会、比赛、锦标赛	SportsEvent
直播活动	音乐会、节日、特别表演	Event
广播/线性电视	直播TV频道、FAST频道、24小时时间表	Station、Schedule
额外内容	预告片、片段、幕后花絮、访谈	Extra

设备如何使用您的目录

目录集成与设备无关。您提交一次后，亚马逊就会在所有视频体验中显示您的内容。

• Fire TV - 通用搜索和浏览支持在所有集成目录的应用中发现内容。客户通过搜索、按流派浏览、主屏幕推荐和语音搜索找到您的内容。
• Echo Show - 客户可以在Echo Show设备上发现和播放来自集成目录的应用中的视频内容。
• Alexa - 语音命令适用于所有支持Alexa的设备。当客户说“Play Interstellar”（播放Interstellar）时，系统会打开相应的详情页面或直接开始播放。

在所有设备上，提交相同的目录内容可增强客户体验。

相关集成

仅靠目录集成并不能实现完整的内容播放和发现。您还必须完成以下集成，才能使目录集成内容在设备上正常运行。并非必须进行这些集成才能提交目录，但您必须先完成这些集成，然后亚马逊才能接受您的目录。

Fire TV启动器

Fire TV启动器集成支持视频点播电影、电视节目和直播活动的深层链接和权利。您必须完成此集成，您的内容才能出现在通用搜索结果、浏览页面和语音启动播放中。

有关详细信息，请参阅将您的应用程序与Fire TV启动器集成。

线性电视

线性电视集成支持线性内容（包括电视台、频道和预定节目）的深层链接和权利。您必须完成此集成，才能实现电视台调谐、频道切换和直播电视指南功能。

有关详细信息，请参阅线性电视简介。

集成过程概览

目录集成包括以下概要步骤：

• 步骤1： 设置您的账户 - 配置AWS访问权限并验证连接以开始提交目录。
• 步骤2： 将您的目录上传到暂存环境 - 创建、验证您的目录文件并将其上传到暂存环境。查看引入报告以解决所有报告的问题。
• 步骤3： 在暂存环境中测试您的目录 - 验证您的目录项目是否可通过搜索发现，以及您的优惠是否显示在内容详情页面上。
• 步骤4： 通过亚马逊对目录的验收 - 亚马逊进行匹配和其他测试，并提供反馈。解决反馈问题并进行迭代，直到通过亚马逊的验收。
• 步骤5： 将您的目录上传到生产环境 - 亚马逊授予生产访问权限。您将目录提交到生产环境，然后通过定期更新进行监控和维护。

要求

您需要有以下内容和技术资源才能开始目录集成。

内容要求

• 视频内容（例如电影、电视节目、直播活动）、广播频道或广告变现型免费流媒体电视 (FAST) 频道
• 您从内容管理系统或数据库导出的元数据
• 目标地区的分发权利
• 与Fire TV集成的播放应用（用于Fire TV集成）

技术要求

• 亚马逊云科技 (AWS) 账户
• 已安装并配置好AWS CLI
• XML验证工具（xmllint已预装在Mac和Linux上）
• 对XML格式的理解

建议项目：

• 用于定期提交目录的自动化脚本（Python、Shell或类似脚本）
• 用于自动更新目录的预定任务 (cron)
• 用于跟踪目录变更的版本控制 (Git)

元数据预期

EMBER有两组不同的元数据期望。了解差异可防止在创建目录时出现混淆。

• 架构要求 - 架构要求特定的元数据。当您提交目录时，亚马逊会验证您的XSD文件。如果您省略必填字段，则您的目录将无法引入。

  每个节目必须包含一个Titles元素和至少一个Title。所有其他元素在架构中都是可选的。

• 针对匹配的建议字段 - 建议字段可增强用户体验，但并不是架构必需项。如果您提交的目录中没有这些字段之一，即便它能通过架构验证，也可能无法提供最佳用户体验。

  亚马逊建议纳入ExternalIds（IMDB、TMS及其他）以及以下项中的至少两个： Descriptions、Synopses、ReleaseDates、Credits。亚马逊使用多个元数据点进行内容匹配和重复数据消除。如果没有这些字段，您的内容可能与现有的目录条目不匹配，这意味着它可能会显示为重复内容，而不是与其他提供者的相同标题合并。

  提示： ExternalIds是最重要的匹配字段。如果您有IMDB、TMS或其他行业标准标识符，请务必将其纳入。

您需要哪些目录？

EMBER将元数据组织成专门的目录类型。您需要的目录取决于您的服务类型。

您的服务类型	需要的目录
直播VOD	ProgramCatalog + OfferCatalog + PolicyCatalog（可选）
线性电视/FAST频道	StationCatalog + ProgramCatalog + ScheduleCatalog + OfferCatalog + PolicyCatalog（可选）。如果您的目录使用ExternalStation ID（例如Gracenote），则跳过ProgramCatalog和ScheduleCatalog。
体育直播	ProgramCatalog + OfferCatalog + PolicyCatalog（建议）

有关每种目录类型、跨目录引用和完整的EMBER架构的完整描述，请参阅EMBER规范概述。要浏览整个元素目录，请参阅所有EMBER元素。

• 下一步骤 - 步骤1： 设置您的账户

---

Last updated: 2026年5月27日