Alexa.ChannelController接口 (VSK Fire TV)

当用户说出要更改频道的表述时（例如，“Alexa，将频道改为PBS”），Alexa.ChannelController接口会发送ChangeChannel指令以指示应更改频道。当用户指定频道名称、呼叫信号或频道编号时，将发送这些指令。

警告： 建议您遵循直播TV集成，而不是实现ChannelController接口。电视直播集成具有更多益处，例如在Fire TV的 “Live”（直播）选项卡和频道指南上进行集成。直播TV集成是建议Fire TV合作伙伴使用的方法。

ChannelController指令的表述
ChangeChannel指令示例
有效负载定义
- 体验类型
处理ChangeChannel指令
响应示例

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日