开发者控制台

步骤7: 更新Fire TV技能部分(VSK Fire TV)

步骤7: 更新Fire TV技能部分(VSK Fire TV)

现在,您已将具有相应安全配置文件的Fire TV应用上传到开发者控制台,包括AWS中的Lambda函数,您可以填写视频技能配置中的其他字段,并将您的Fire TV应用与视频技能相关联。

更新视频技能以启用Fire TV支持

在此步骤中,您将把自己的视频技能与Fire TV应用相关联:

  1. Alexa控制台中返回至您的视频技能。
  2. 单击视频技能旁边的Edit(编辑)。
  3. 完成以下各部分:

    下面提供了每个部分的详细信息。

1.Video Skill Service Endpoint(视频技能服务终端节点)

  1. Default endpoint(默认终端节点)字段中,输入您的Lambda ARN(您复制于步骤6: 创建和部署Lambda程序包)。Lamba ARN告知视频技能向哪个Lambda函数发送指令。

  2. 在“Pick a geographical region …”(选择地理区域...)部分中,您可以根据不同的地区选择不同的Lambda ARN,以缩短Alexa和Lambda之间的延迟。根据您之前选择的AWS地区,将您的ARN粘贴到这些地区中的一个。

    使用Lambda ARN配置您的视频技能
    使用Lambda ARN配置您的视频技能

2.Country Specific Configuration(特定于国家/地区的配置)

在该部分中,为您的技能选择一个国家/地区。默认情况下,应该已经选择了一个国家/地区(例如美国)。如果您的视频技能将在多个国家/地区使用,可单击Add Country(添加国家/地区),然后添加其他国家/地区。

在国家/地区下方,您将看到一个名为“A. [Country name] Configuration”(A. [国家/地区名称] 配置)的子部分。 此处列出了该国家/地区的目录详细信息。如果您添加了更多国家/地区,则会看到每个国家/地区的更多目录详细信息。例如,如果您为视频技能同时添加了United States和Canada,则会看到两个目录子部分,如下所示:

与国家/地区对应的目录子部分
与国家/地区对应的目录子部分

Catalog Name(目录名称)字段中,输入您的目录名称(针对每个国家/地区)。

如简介中所述,视频技能需要目录集成。当用户请求媒体标题时,亚马逊将在您的目录中查找标题匹配项,然后向您发送相应的标识符。有关目录集成(包括CDF格式)的更多详细信息,请参阅目录文档

使用Fire TV应用测试视频技能所用目录的示例

如果您使用的是示例Fire TV应用,可输入tms作为您的目录名称。此目录名称是IMDb目录。因此,您几乎能搜索所有电影或电视节目并获得结果。但是示例应用将始终播放相同的示例视频。

忽略MSO ID,因为此字段不用于Fire TV应用上的视频技能。(MSO代表多系统运营商,用于将直播TV视频技能集成到机顶盒中。)

3.Language Specific Configuration(特定于语言的配置)

如有必要,在该部分中,为您的视频技能选择语言。将自动添加与您之前选择的国家/地区相对应的语言,但您可以根据需要单击Add Language(添加语言)来添加其他语言。您输入的其他每种语言都会创建一个包含技能引用详细信息的相应子部分。

例如,假设您的视频技能在美国和加拿大都可用。因此,默认情况下会选择两种语言:en-US和en-CA。因此,您将看到两个子部分,用来配置每种语言的技能引用: “A. English (United States): en-US Configuration”(A.英语 [美国]:en-US配置)和“B. English (Canada): en-CA Configuration”(B.英语 [加拿大]:en-CA配置),如以下屏幕截图所示:

按国家/地区划分的特定语言配置
按国家/地区划分的特定语言配置

这些子部分让您可以为每种语言自定义视频技能引用名称和图像资产。例如,假设您的视频技能名称在两个位置之间有所不同,或者标志图像不同,如果是,则可以通过这些子部分自定义引用并适当地显示。

Alternate Skill Invocation(备用技能引用)框中,输入其他技能引用方式。默认情况下,可以通过您在创建技能时为其赋予的名称来引用视频技能。但是您也可以在这里创建备用名称。

例如,假设您的技能被命名为XYZ。用户可以说“Play the movie Big Buck Bunny on XYZ”(在XYZ上播放电影Big Buck Bunny)来引用您的视频技能。(该表述显式地以您的技能为目标。) 如果您添加了“ACME”的备用技能引用,那么用户可以说出“Play the movie Big Buck Bunny on ACME”(在ACME上播放电影Big Buck Bunny),而Alexa也会通过这个引用以您的视频技能为目标。

4.Fire TV Support(Fire TV支持)

  1. 在“4.Fire TV Support”部分,选择Enable Fire TV Support(启用Fire TV支持)复选框。
  2. 选择您想要与该视频技能配对的Fire TV应用。开发者控制台的“应用”部分中的所有Fire TV应用都会自动显示在此处。如果选择应用,也会自动填充客户端ID。

    例如,如果您在“应用与服务”>“我的应用程序”下有一个Fire TV应用,则该应用将出现在此Fire TV应用框中供您选择。当您将视频技能与Fire TV应用配对时,该技能和应用将相互关联在一起。当您启动Fire TV应用时,相关的视频技能会自动启用。您的技能将从Alexa应用的Alexa技能商店中消失,并且将变成Fire TV视频技能交互的一部分(从用户的角度来看)。

    也就是说,从用户的角度来看,让您的应用支持Alexa将是无缝实现的 - 用户无需在Alexa技能商店中寻找您的技能即可将语音和您的技能结合使用。这大幅提高了用户对语音功能的采用率。

    将您的视频技能与Fire TV应用配对
    将您的视频技能与Fire TV应用配对

    选择应用后,将自动填充与应用关联的客户端ID。Login with Amazon使用此客户端ID来识别您的应用并对其授权。Login with Amazon对技能授权,以与您的应用通信。

    (请注意,此处的客户端ID与您的安全配置文件的客户端ID不同。如果您进入安全配置文件并单击“Web设置”选项卡,则会看到列出的另一个客户端ID。一个安全配置文件可以有多个与之关联的客户端ID。实际上,在将应用推送到动态应用测试 (LAT) 后,您需要在此处重新选择客户端ID - 这将在后面的步骤中完成。)

    在这里选择Fire TV应用后,技能与应用的配对是永久性的,无法撤消。

    另请注意,一个视频技能只能支持一个Fire TV应用。您无法将单个视频技能与多个Fire TV应用关联。

  3. 单击Save(保存)按钮。

    完成Fire TV Support部分后,Account Linking(账户关联)和Permissions(权限)选项卡将变为不可访问。它们未用在Fire TV技能中。

Distribution(分发)选项卡

  1. 在Build(构建)选项卡上保存更改后,单击顶部导航栏中的Distribution选项卡,并确保填写所有字段,包括所有图标。如果需要,您可以稍后再修改这些字段(因为您无需正式发布技能即可对其进行测试),但现在至少要在每个字段中输入一些存根值。下表描述了该选项卡中的字段。

    下表描述了每个字段:

    Distribution字段
    字段 描述
    Public Name(公共名称) 在Alexa应用中向客户显示的技能名称。使用您应用的名称(例如,“ACME”)。
    One Sentence Description(描述) 一个简短的概述句子,描述技能或客户可以用它做什么(例如,“此技能允许您使用自己的语音与ACME交互。”)。此文本显示为您的Alexa技能描述的第一行。
    Detailed Description(详细描述) 输入技能的目的、特性和功能的更全面描述(例如“享受免提体验,可以与智能电视互动,发现新内容”)。描述如何使用技能(例如“可以按名称搜索您最喜欢的节目,并可使用常用命令控制播放、更改频道等”)。
    What's new(新增内容) 您技能的发行说明。(例如,“首次发布技能。”)
    Example Phrases(示例短语) 用户可以在您的应用中说出的示例表述。把每个表述置于新的一行。示例短语应与您实现的视频技能功能相对应,并将出现在技能描述中。例如:
    • “Alexa, search for [TV show] on ACME.”(Alexa,在ACME上搜索 [电视节目]。)
    • “Alexa, watch [movie] on ACME.”(Alexa,在ACME上观看 [电影]。)
    • “Alexa, tune to ACME.”(Alexa,调到ACME。)
    • “Alexa, rewind 30 seconds.”(Alexa,倒回30秒。)
    • Alexa, show episodes of [TV show] on ACME.(Alexa,在ACME上播放 [电视节目] 的剧集。)
    Small Skill Icon(小技能图标) 一个108 x 108像素的图标(PNG或JPG),用于表示您Alexa应用中的技能。图像必须采用圆形设计。如果您没有图像,请使用下面的图库图像或使用Alexa技能图标生成器创建一个图像。(右键单击下面的图像并将其保存至您的计算机。)
    108x108px 图标
    Large Skill Icon(大技能图标) 一个512 x 512像素的图标(PNG或JPG),提供同一图标的放大版本。此图标出现在Amazon.com的Alexa Skills(Alexa技能)部分。如果您没有图像,请使用下面的图库图像或使用Alexa技能图标生成器创建一个图像。(右键单击下面的图像并将其保存至您的计算机。)
    512x512px 图标
    Category(类别) 选择Video(视频)
    Keywords(关键词) 描述此技能的简单搜索词。例如,您可以列出应用名称的变化形式以及应用中最受欢迎的节目。这有助于客户快捷地找到技能。在每个搜索词之间使用空格或逗号。
    Privacy Policy URL(隐私政策URL) 适用于此技能的隐私政策的链接。(如果你没有,请暂时链接到你的网站。)
    Terms of Use URL(使用条款URL) 此技能的使用条款文档的链接。(如果你没有,请暂时链接到你的网站。)
  2. 填完必填字段后,单击Save and continue(保存并继续)。您将在左侧导航栏中看到下一个屏幕: Privacy & Compliance(隐私与合规性)。
  3. 填写Privacy & Compliance字段。(请注意,您必须在Testing Instructions [测试说明] 中加入一些内容。)
  4. 在此屏幕上完成操作后,单击Save and continue。您将在左侧导航栏中看到下一个屏幕: Availability(销售国家/地区)。
  5. 填写Availability字段。确保选择Public(公开)并选择适当的位置(为您的视频技能选择与应用相同的销售国家/地区)。然后单击Save and continue
  6. 您将转至Certification(认证)选项卡,具体而言是转到Validation(验证)侧面选项卡。如果您正确填写了所有必填字段,则应当看到一条成功消息,表明没有错误。

    视频技能已完成配置并准备好进行测试
    视频技能已完成配置并准备好进行测试

    如果出现错误(例如缺少技能图像),系统会提示您进行修正。修正之后,返回Certification选项卡并单击Run(运行)。

    无需浏览Functional test(功能测试)和Submission(提交)页面。此外,此时您不需要提交视频技能。您可以在开发技能的过程中测试您的技能。

后续步骤

现在您已经完成了所有设置,可以通过示例表述和日志消息来查看视频技能的实际运行情况。继续执行下一步: 步骤8: 测试您的技能以及观察日志

(如果遇到任何问题而无法继续,请参阅云端集成故障排除。)


Last updated: 2021年10月13日