API参考概述 (VSK Fire TV)
Alexa将用户说出的表述(例如,搜索电视节目或观看电影的表述)转换为指令。指令是从Alexa发送至您的应用或Lambda的一组数据和指示,以JSON表示。Fire TV应用的视频技能可以支持各种指令,例如SearchAndPlay
、SearchAndDisplayResults
等。
您的Lambda必须解释和履行指令以满足用户的请求。您的Lambda既会向Alexa发送响应,又会采取相应的措施来履行请求。
可用指令
Alexa通过Fire TV应用发送以下指令。
指令 | 描述 |
---|---|
RemoteVideoPlayer - SearchAndPlay |
当用户要求Alexa播放特定视频内容时发送。 |
RemoteVideoPlayer - SearchAndDisplayResults |
当用户要求Alexa搜索视频内容时发送。 |
PlaybackController |
当用户请求视频内容的播放、停止和浏览播放时发送。 |
SeekController |
当用户请求快进(或跳过)或倒回到特定期间时发送。 |
ChannelController |
当用户请求更改频道时发送 |
KeypadController |
当用户请求向右或向左滚动、向上或向下翻页或选择聚焦项目时发送。 |
上述链接中描述了每条指令的详细信息以及触发这些指令的表述。
以您的视频技能为目标
要使用表述将视频技能作为目标,请执行以下操作:
- 在应用打开时说出表述。
- 在请求中不要只是说“播放 [X] 节目”,而应明确说明您的视频技能名称,例如“播放XYZ上的[X] 节目”。(这种方式称为明确表述。)
与多模式指令相比较
如指令参考概述中所述,实现多模式设备的视频技能工具包还涉及解释和响应Alexa的指令。这些指令与用于Fire TV应用的指令不同,但它们相似:
SearchAndPlay
(FTV) 类似于GetPlayableItems
(多模式)。这些指令支持播放表述。SearchAndDisplayResults (FTV)
与GetDisplayableItems
(多模式)类似。这些指令支持搜索表述。
但是,由于基本的交互模型不同,多模式设备针对上述每项拥有两个指令(GetPlayableItems
和GetPlayableItemsMetadata
,以及GetDisplayableItems
和GetDisplayableItemsMetadata
)。对于多模式设备,您的Lambda会在响应中将信息反馈给Alexa。对于Fire TV应用,您的Lambda通过Amazon Device Messaging将所需信息直接推送到您的应用。
术语—请求与指令
在此处的视频技能文档中,术语“请求”和“指令”几乎完全是同义词。对于Alexa发送到您的Lambda的任何消息,请求是一个更笼统的术语。对于视频技能,这些消息在代码中被标记为指令
,因此我们将这些请求称为“指令”。 这与其他Alexa技能工具包文档中使用的术语一致。
此外,术语“指令”在用于用户的表述(例如观看电影的请求)和用于Alexa发送到您的Lambda的信息时存在一些区别。