アクセスいただきありがとうございます。こちらのページは現在英語のみのご用意となっております。順次日本語化を進めてまいりますので、ご理解のほどよろしくお願いいたします。

Alexa.ChannelController Interface (VSK FTV)

When users say utterances to change the channel (e.g., "Alexa, change the channel to PBS"), the Alexa.ChannelController interface sends ChannelChange directives to indicate that the channel should be changed. These directives are sent when users specify the channel name, call sign, or channel number.

Utterances for ChannelController Directives

Alexa sends a ChannelChange directive through the ChannelController interface to your Lambda when users say the following utterances.

Feature Sample Utterances Expected Response
Go to channel name

Go to Fox

Tune to ESPN

Schalte auf <channel>

Wechsel zu <channel>

Umschalten auf <channel>

Gehe zu <channel name>

<Sat Eins Emotions, Kabel Eins Doku, radio SAW>

Mets Fox

Va sur Fox

change à radio-canada

mets radio-canada

va à/sur radio-canada

joue radio-canada

passe à radio-canada

vai sulla Fox

cambia sulla Fox

metti la Fox

<alfa>

cambia a Fox

ve a Fox

abre Fox

cambia a t.v. Azteca

cámbiale a t.v. Azteca

cámbia le a t.v. Azteca

ve a t.v. Azteca

abre t.v. Azteca

{channel} 見せて

{channel} 開いて

{channel} に行って

{channel} をお願い

{channel} 選んで

{channel} を選択して

The view switches to the channel name, and content from the channel plays.

Go to channel number

Go to channel thirteen

Schalte auf <channel number>

Schalte auf Kanal/Sender <channel number>

Umschalten auf <channel number>

Mets la 5

Passe sur la 5

Va sur la 5

change au (poste) 10

mets le (poste) 10

va au/sur le (poste) 10

joue le (poste) 10

passe au (poste) 10

change au (canal) 10

mets le (canal) 10

va au/sur le (canal) 10

joue le (canal) 10

passe au (canal) 10

change à la chaîne 10

mets la chaîne 10

va à/sur la chaîne 10

joue la chaîne 10

passe à la chaîne 10

vai al canale 13

cambia sul canale 13

metti il canale 13

ve al canal 13

cambia al canal 13

ve al canal 13

cambia al canal 13

vete al canal 13

cámbiale al canal 13

cámbia le al canal 13

チャンネル {channel number} 開いて

チャンネル {channel number} に行って

チャンネル {channel number} をお願い

チャンネル {channel number} 選んで

チャンネル {channel number} 選択して

{channel number} チャンネル 開いて

{channel number} チャンネル に行って

{channel number} チャンネル をお願い

{channel number} チャンネル 選んで

{channel number} チャンネル を選択して

The view switches to the channel number, and content from the channel plays.

Go to channel callsign

Go to channel k. c. p. q.

Schalte auf <channel callsign>

Umschalten auf <channel callsign>

Mets la chaîne (channel code)

Passe sur la chaîne (channel code)

Va sur la chaîne (channel code)

change au ( canal ) (channel code)

mets le ( canal ) (channel code)

va au/sur le canal (channel code)

joue le canal (channel code)

change au poste (channel code)

mets le poste (channel code)

va/sur le au poste (channel code)

joue le poste (canal) channel code)

change à la chaîne (channel code)

mets la chaîne (channel code)

va à/sur la chaîne (channel code)

joue la chaîne (channel code)

vai al canale (code)

cambia sul canale (code)

metti il canale (code)

cambia al canal (channel code)

ve al canal (channel code)

cambia al canal (channel code)

ve al canal (channel code)

cámbiale al canal (channel code)

vete al canal (channel code)

cámbia e al canal (channel code)

vete al canal (channel code)

チャンネル {channel callsign} 見せて

チャンネル {channel callsign} 開いて

チャンネル {channel callsign} に行って

チャンネル {channel callsign} をお願い

チャンネル {channel callsign} を選んで

チャンネル {channel callsign} を選択して

The view switches to the channel callsign, and content from the channel plays.

Watch channel name

Watch fox

Zeige <channel name>

<channel name> anschauen

Spiel <channe name> ab

<Sat Eins Emotions, Kabel Eins Doku, radio SAW>

Mets Fox

Je veux voir/regarder Fox

Va sur Fox

Passe à Fox

mets radio-canada

va à/sur radio-canada

joue radio-canada

Je veux écouter/regarder/voir radio-canada

vai sulla Fox

cambia sulla Fox

metti la Fox

<alfa>

pon Fox

(quiero) ver Fox

pon t.v. Azteca

ponme t.v. Azteca

pon me t.v. Azteca

(quiero) ver t.v. Azteca

{channel name}を再生して

{channel name}を見せて

{channel name}を流して

{channel name}をかけて

{channel name}見たい

{channel name}をお願い

The view switches to the channel name, and content from the channel plays.

Watch channel number

Watch channel thirteen

Zeige Kanal/Sender <channel number>

Kanal/Sender <channel number> anschauen

Mets la 5

Je veux voir/regarder la 5

mets le (canal) 10

va au/sur le

joue le (canal) 10

Je veux écouter/regarder/voir le (canal) 10

vai al canale 13

cambia sul canale 13

metti il canale 13

pon el canal 13

(quiero) ver el canal 13

pon el canal 13

(quiero) ver el canal 13

ponme el canal 13

チャンネル {channel number} 見せて

{channel number} チャンネル 見せて

The view switches to the channel number, and content from the channel plays.

Handling ChannelChange Directives

The ChannelChange directive allows customers to tune to a specific channel using voice commands. When users say "Alexa, tune to CNN," you receive a ChannelChange directive in your Lambda. You then need to change the live TV stream to show the user the correct channel.

To help you understand which directive corresponds with which channel, we have provided a list of possible callsigns for each channel in Channels List.

If you'd like to support additional channels not included in this list, reach out to your Amazon contact, and he or she will coordinate with the right people to get you the information you need on how to handle it.

Alternatively, try asking your Alexa-enabled device to change the channel to whichever channel you like, and then observe the directive received in your Lambda log to check the callsign for yourself. However, it's still best if you flag those channels to your Amazon contact so we can know to prioritize that channel in our voice models. The channel callsign will be available within the callSign field within the channel change directive's payload.

You will not receive information about local channels in the directives — just top level names and callsigns, such as "ABC." It is up to you to perform any localization for your users.

ChannelChange Example

The following is an example ChangeChannel directive:

{
  "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": {
      "channel": {
          "number": "1234",
          "callSign": "KSTATION1",
          "affiliateCallSign": "KSTATION2",
          "uri": "someUrl"
      },
      "channelMetadata": {
          "name": "Alternate Channel Name",
          "image": "urlToImage"
      }
    }
  }
}

Payload Details

Field Description Type Required
channel Describes a channel. object Yes
channel.number A number that identifies the specified channel such as 5 or 12.1 string No,
but channel.number, channelMetadata.name, channel.callSign,
affiliateCallSign or uri must be specified.
channel.callSign Specifies a channel by call sign such as PBS. string No,
but channel.number, channelMetadata.name, channel.callSign,
affiliateCallSign or uri must be specified.
channel.affiliateCallSign Specifies a channel by local affiliate call sign such as KCTS9. string No,
but channel.number, channelMetadata.name, channel.callSign,
channel.affiliateCallSign or channel.uri must be specified.
channel.uri The URI of the channel such as "entity://provider/channel/12307" string No,
but channel.number, channelMetadata.name, channel.callSign,
channel.affiliateCallSign or channel.uri must be specified.
channelMetadata Provides additional information about the specified channel. object No
channelMetadata.name Another value that identifies the channel such as "FOX". string No,
but channel.number, channelMetadata.name, channel.callSign,
channel.affiliateCallSign or channel.uri must be specified.
channelMetadata.image A URL to an image that describes the channel. string No

Response Example

You must send an Response event if a request to change channels was successful. The response should include a context object that reports the channel after the request completes.

{
  "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":{ }
 }
}

Error Response

If you cannot complete the customer request for some reason, reply with an error. See Error Handling for more details.