Alexa.ChannelController接口 (VSK Fire TV)
当用户说出要更改频道的表述时(例如,“Alexa,将频道改为PBS”),Alexa.ChannelController
接口会发送ChangeChannel
指令以指示应更改频道。当用户指定频道名称、呼叫信号或频道编号时,将发送这些指令。
ChannelController
接口。电视直播集成具有更多益处,例如在Fire TV的 “Live”(直播)选项卡和频道指南上进行集成。直播TV集成是建议Fire TV合作伙伴使用的方法。ChannelController指令的表述
当用户说出以下表述时,Alexa通过ChannelController
接口向您的Lambda发送ChangeChannel
指令。
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
Go to fox |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
Go to channel thirteen |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
Go to channel k. c. p. q. |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
Watch fox |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
Watch channel thirteen |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
Va sur [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
va sur [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
cambia canal a t. p. d. |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
mets [ChannelName] joue [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
mets la chaîne[ChannelNumber] joue la chaîne[ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
Va sur [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
va sur [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
va sur [channel] |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
mets [ChannelName] joue [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
mets la chaîne[ChannelNumber] joue la chaîne[ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
(schalt auf|geh zu) [ChannelName] schalt kanal [ChannelName] ein (geh|schalt|wechsel|änder) zum kanal [ChannelName] (geh|schalt|wechsel|änder) zu [ChannelName] kanal (wechsel|änder) den kanal zu [ChannelName] (wechsel|änder) den kanal zu [ChannelName] auf [AppName] schalt [ChannelName] auf [AppName] an schalt kanal [ChannelName] auf [AppName] an (geh|schalte|wechsel) zu [ChannelName] auf [AppName] (stell|schalt) [ChannelName] ein auf [AppName] (stell|schalt|wechsel) (um zu|auf) [ChannelName] auf [AppName] schalt kanal [ChannelName] auf [AppName] an mach [ChannelName] auf [AppName] an |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
schalt kanal [ChannelNumber] ein (geh|schalt|wechsel|änder) zum kanal [ChannelNumber] (geh|schalt|wechsel|änder) zu [ChannelNumber] kanal (wechsel|änder) den kanal zu [ChannelNumber] (wechsel|änder) den kanal zu [ChannelNumber] auf [AppName] schalt [ChannelNumber] auf [AppName] an schalt kanal [ChannelNumber] auf [AppName] an (geh|schalte|wechsel) zu [ChannelNumber] auf [AppName] (stell|schalt) [ChannelNumber] ein auf [AppName] (stell|schalt|wechsel) (um zu|auf) [ChannelNumber] auf [AppName] schalt kanal [ChannelNumber] auf [AppName] an mach [ChannelNumber] auf [AppName] an kanal [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
schalte/änder/geh zu/auf den fernsehsender [ChannelName] geh zum (fernseh)kanal [ChannelName] ändern den (fernseh)kanal zu/auf [ChannelName] |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
[ChannelName] auf [AppName] ansehen spiel den kanal [ChannelName] ab |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
Zeige Kanal/Sender [channel number] Kanal/Sender [channel number] anschauen |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
fox पर/पे जाओ/जाइए/जाना/चलो/चलना |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
channel दस पर/पे जाओ/जाना/जाइए/चलो/चलना |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
channel sony पर/पे जाओ/जाना/जाइए/चलो/चलना |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
fox देखो/देखिए/देखना/देखें |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
channel बारह देखो/देखना/देखिए/देखें |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
vai su [ChannelName] vai a [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
vai al [ChannelNumber] vai su [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
vai su [Channel] vai a [Channel] |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
guarda [ChannelName] fammi vedere [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
metti [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
[ChannelName]を検索 |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
|
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
|
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
[ChannelName]を見せて |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
チャンネル[ChannelNumber]を見せて |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
vá/vai/ir para o canal [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
|
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
vá para o canal [CallSign] |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
assistir/assiste/assista [ChannelName]Assistir/assiste/assistao [ChannelName] |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
assitir canal [ChannelNumber] |
视图切换到频道号,播放频道中的内容。 |
功能 | 表述示例 | 预期回应 |
---|---|---|
转到频道名称 需要认证 |
cambia a antena tres |
视图切换到频道名称,播放频道中的内容。 |
转到频道号 需要认证 |
cambia el canal a la dos |
视图切换到频道号,播放频道中的内容。 |
转到频道呼叫信号 需要认证 |
cambia canal a t. p. d. |
视图切换到频道呼号,播放频道中的内容。 |
按频道名称观看 需要认证 |
ver la sexta pon la sexta |
视图切换到频道名称,播放频道中的内容。 |
按频道号观看 需要认证 |
pon canal dos |
视图切换到频道号,播放频道中的内容。 |
ChangeChannel指令示例
以下是ChangeChannel
指令示例:
EXTRA_DIRECTIVE_NAMESPACE: Alexa.ChannelController
EXTRA_DIRECTIVE_NAME: ChangeChannel
EXTRA_DIRECTIVE_PAYLOAD_VERSION: 3
EXTRA_DIRECTIVE_PAYLOAD: payload
有效负载
包含以下内容:
{
"payload": {
"experience": {
"mode": "VOICE_OPTIMIZED",
},
"channel": {
"number": "1234",
"callSign": "KSTATION1",
"affiliateCallSign": "KSTATION2",
"uri": "someUrl"
},
"channelMetadata": {
"name": "Alternate Channel Name",
"image": "urlToImage"
}
}
}
{
"directive": {
"header": {
"namespace": "Alexa.ChannelController",
"name": "ChangeChannel",
"messageId": "abc-123-def-456",
"correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
"payloadVersion": "3"
},
"endpoint": {
"scope": {
"type": "BearerToken",
"token": "access-token-from-skill"
},
"endpointId": "device-001",
"cookie": {
}
},
"payload": {
"experience": {
"mode": "VOICE_OPTIMIZED",
},
"channel": {
"number": "1234",
"callSign": "KSTATION1",
"affiliateCallSign": "KSTATION2",
"uri": "someUrl"
},
"channelMetadata": {
"name": "Alternate Channel Name",
"image": "urlToImage"
}
}
}
}
有效负载定义
字段 | 描述 | 类型 | 必需 |
---|---|---|---|
experience |
优化搜索结果显示的对象。请参阅体验类型了解更多详情。 | 对象 | 否 |
channel |
描述频道。 | 对象 | 是 |
channel.number |
标识指定频道的数字,例如5或12.1 | 字符串 | 否。 但是必须指定 channel.number 、channelMetadata.name 、channel.callSign 、affiliateCallSign 或uri 。 |
channel.callSign |
通过呼叫信号(例如PBS)指定频道。 | 字符串 | 否。 但是必须指定 channel.number 、channelMetadata.name 、channel.callSign 、affiliateCallSign 或uri 。 |
channel.affiliateCallSign |
通过本地分台呼叫信号(如KCTS9)指定频道。 | 字符串 | 否。 但是必须指定 channel.number 、channelMetadata.name 、channel.callSign 、channel.affiliateCallSign 或channel.uri 。 |
channel.uri |
频道的URI,例如“entity://provider/channel/12307” | 字符串 | 否。 但是必须指定 channel.number 、channelMetadata.name 、channel.callSign 、channel.affiliateCallSign 或channel.uri 。 |
channelMetadata |
提供有关指定频道的其他信息。 | 对象 | 否 |
channelMetadata.name |
标识频道的另一个值,例如"FOX"。 | 字符串 | 否。 但是必须指定 channel.number 、channelMetadata.name 、channel.callSign 、channel.affiliateCallSign 或channel.uri 。 |
channelMetadata.image |
描述频道的图片的URL。 | 字符串 | 否 |
体验类型
使用experience
对象根据用于执行搜索的设备优化搜索结果的显示。例如,如果客户通过Fire TV遥控器进行搜索,则experience
对象会显示大量的搜索结果,客户可以使用遥控器浏览这些结果。但是,如果搜索请求来自与Fire TV配对的Echo,则experience
对象会限制显示的结果数量及其显示方式,从而让客户可以无需使用遥控器即可查看结果。
experience
对象由一个mode
对象组成,后者决定如何显示搜索结果。mode
对象采用两个值: VOICE_OPTIMIZED
和DEFAULT
.
-
VOICE_OPTIMIZED
: 针对纯语音设备的搜索结果优化的显示。提供结果列表,客户无需遥控器即可通过语音浏览这些结果。 -
DEFAULT
: 所有搜索结果列表格式的默认显示,无论使用哪种设备进行搜索。
为确保向前兼容性,如果在mode
中收到未知值,可回退到DEFAULT
,而不是遭遇失败。
处理ChangeChannel指令
ChangeChannel
指令让客户可以使用语音命令调谐到特定频道。当用户说出“Alexa,调谐到CNN”时,您会在自己的Lambda中收到ChangeChannel
指令。然后,您需要更改电视直播流,以向用户显示正确的频道。
为了帮助您了解哪个指令与哪个频道对应,我们为频道列表中的每个频道提供了可能的呼叫信号。
如果您想支持此列表中未包含的其他频道,请联系您的亚马逊联系人,该联系人将与合适的人员进行协调,为您提供有关如何处理这种情况所需的信息。
或者,尝试让支持Alexa的设备将频道更改为您喜欢的任何频道,然后观察您在Lambda日志中收到的指令,亲自检查呼叫信号。但是,最好还是向您的亚马逊联系人标记出这些频道,这样我们就可以知道在我们的语音模型中要优先考虑哪些频道。频道呼叫信号将在频道更改指令的有效负载内的callSign
字段中可用。
您不会在指令中收到有关本地频道的信息,只会收到顶级名称和呼叫信号,例如“ABC”。 由您自己决定是否为用户执行任何本地化。
响应示例
如果更改频道的请求成功,则必须发送Response
事件。响应应包含一个上下文对象,该上下文对象在请求完成后报告频道。
{
"context": {
"properties": [
{
"namespace": "Alexa.ChannelController",
"name": "channel",
"value": {
"number": "1234",
"callSign": "callsign1",
"affiliateCallSign": "callsign2"
},
"timeOfSample": "2017-02-03T16:20:50.52Z",
"uncertaintyInMilliseconds": 0
}
]
},
"event": {
"header": {
"messageId": "abc-123-def-456",
"correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
"namespace": "Alexa",
"name": "Response",
"payloadVersion": "3"
},
"endpoint":{
"endpointId":"appliance-001"
},
"payload":{ }
}
}
如果您由于某种原因无法完成客户请求,可以用错误来回应。有关更多详细信息,请参见错误处理。
Last updated: 2021年6月9日