开发者控制台

API参考概述 (VSK Fire TV)

API参考概述 (VSK Fire TV)

Alexa将用户说出的表述(例如,搜索电视节目或观看电影的表述)转换为指令。指令是从Alexa发送至您的应用或Lambda的一组数据和指示,以JSON表示。Fire TV应用的视频技能可以支持各种指令,例如SearchAndPlaySearchAndDisplayResults等。

您的Lambda必须解释和履行指令以满足用户的请求。您的Lambda既会向Alexa发送响应,又会采取相应的措施来履行请求。

可用指令

Alexa通过Fire TV应用发送以下指令。

指令 描述
RemoteVideoPlayer - SearchAndPlay 当用户要求Alexa播放特定视频内容时发送。
RemoteVideoPlayer - SearchAndDisplayResults 当用户要求Alexa搜索视频内容时发送。
PlaybackController 当用户请求视频内容的播放、停止和浏览播放时发送。
SeekController 当用户请求快进(或跳过)或倒回到特定期间时发送。
ChannelController 当用户请求更改频道时发送
KeypadController 当用户请求向右或向左滚动、向上或向下翻页或选择聚焦项目时发送。

上述链接中描述了每条指令的详细信息以及触发这些指令的表述。

以您的视频技能为目标

要使用表述将视频技能作为目标,请执行以下操作:

  • 在应用打开时说出表述。
  • 在请求中不要只是说“播放 [X] 节目”,而应明确说明您的视频技能名称,例如“播放XYZ上的[X] 节目”。(这种方式称为明确表述。)

与多模式指令相比较

指令参考概述中所述,实现多模式设备的视频技能工具包还涉及解释和响应Alexa的指令。这些指令与用于Fire TV应用的指令不同,但它们相似:

但是,由于基本的交互模型不同,多模式设备针对上述每项拥有两个指令(GetPlayableItemsGetPlayableItemsMetadata,以及GetDisplayableItemsGetDisplayableItemsMetadata)。对于多模式设备,您的Lambda会在响应中将信息反馈给Alexa。对于Fire TV应用,您的Lambda通过Amazon Device Messaging将所需信息直接推送到您的应用。

术语—请求与指令

在此处的视频技能文档中,术语“请求”和“指令”几乎完全是同义词。对于Alexa发送到您的Lambda的任何消息,请求是一个更笼统的术语。对于视频技能,这些消息在代码中被标记为指令,因此我们将这些请求称为“指令”。 这与其他Alexa技能工具包文档中使用的术语一致。

此外,术语“指令”在用于用户的表述(例如观看电影的请求)和用于Alexa发送到您的Lambda的信息时存在一些区别。