開発者コンソール

Alexa.ChannelControllerインターフェース


Alexa.ChannelControllerインターフェース

ユーザーがチャンネル変更の発話(「アレクサ、チャンネルをPBSに変えて」など)を行うと、Alexa.ChannelControllerインターフェースはChangeChannelディレクティブを送信して、チャンネル変更が必要であることを示します。これらのディレクティブが送信されるのは、ユーザーがチャンネル名、コールサイン、チャンネル番号のいずれかを指定したときです。

ChannelControllerディレクティブの発話

ユーザーが以下の発話をすると、AlexaはChannelControllerインターフェースを介してLambdaにChangeChannelディレクティブを送信します。

機能 サンプル発話 想定されるレスポンス バージョン
チャンネル名に移動

Go to fox

(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

Va sur <ChannelName>

Va sur <ChannelName>

vai su <ChannelName>

vai a <ChannelName>

cambia a antena tres

<ChannelName>を検索

vá/vai/ir para o canal <ChannelName>

fox पर/पे जाओ/जाइए/जाना/चलो/चलना

ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。

1.0

チャンネル番号に移動

Go to channel thirteen

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>

va sur <ChannelNumber>

va sur <ChannelNumber>

vai al <ChannelNumber>

vai su <ChannelNumber>

cambia el canal a la dos

channel दस पर/पे जाओ/जाना/जाइए/चलो/चलना

ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。

1.0

チャンネルコールサインに移動

Go to channel k. c. p. q.

schalte/änder/geh zu/auf den fernsehsender <ChannelName>

geh zum (fernseh)kanal <ChannelName>

ändern den (fernseh)kanal zu/auf <ChannelName>

va sur <channel>

cambia canal a t. p. d.

vai su <Channel>

vai a <Channel>

cambia canal a t. p. d.

vá para o canal <CallSign>

channel sony पर/पे जाओ/जाना/जाइए/चलो/चलना

ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。

1.0

チャンネル名を視聴

Watch fox

<ChannelName> auf <AppName> ansehen

spiel den kanal <ChannelName> ab

mets <ChannelName>

joue <ChannelName>

mets <ChannelName>

joue <ChannelName>

guarda <ChannelName>

fammi vedere <ChannelName>

ver la sexta

pon la sexta

<ChannelName>を見せて

assistir/assiste/assista <ChannelName>Assistir/assiste/assistao <ChannelName>

fox देखो/देखिए/देखना/देखें

ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。

1.0

チャンネル番号を視聴

Watch channel thirteen

Zeige Kanal/Sender <channel number>

Kanal/Sender <channel number> anschauen

mets la chaîne<ChannelNumber>

joue la chaîne<ChannelNumber>

mets la chaîne<ChannelNumber>

joue la chaîne<ChannelNumber>

metti <ChannelNumber>

pon canal dos

チャンネル<ChannelNumber>を見せて

assitir canal <ChannelNumber>

channel बारह देखो/देखना/देखिए/देखें

ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。

1.0

ChangeChannelディレクティブの処理

ChangeChannelディレクティブを使用すると、ユーザーが音声コマンドを使用して特定のチャンネルに合わせることができます。ユーザーが「アレクサ、CNNに変えて」と言うと、LambdaでChangeChannelディレクティブを受け取ります。次に、ライブTVストリームを変更して、適切なチャンネルを表示する必要があります。

どのディレクティブがどのチャネルに対応しているかを理解するために、チャンネルリストのチャンネルごとに、使用される可能性のあるコールサインのリストを用意しました。

このリストに含まれていないチャンネルを追加でサポートする場合は、Amazonの担当者にお問い合わせください。適任者と協力して、その処理方法について必要な情報をご連絡します。

または、チャンネルを任意のチャンネルに変更するようにAlexa搭載デバイスに要求してから、Lambdaログで受け取ったディレクティブを調べて、コールサインを確認してください。その場合でも、Amazonの担当者にこれらのチャンネルについて連絡していただけると、そのチャンネルのAmazonの音声モデルにおける優先順位を判断できるため助かります。チャンネルのコールサインは、チャンネル変更ディレクティブのペイロード内のcallSignフィールドに格納されています。

ディレクティブではローカルチャンネルに関する情報は受け取りません。トップレベル名とコールサイン(たとえば「ABC」など)だけです。 ユーザー向けのローカリゼーションを実行するかどうかは、開発者しだいです。

ChangeChannelの例

ChangeChannelディレクティブの例を以下に示します。

{
  "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": "代替チャンネル名",
          "image": "urlToImage"
      }
    }
  }
}

ペイロードの詳細

フィールド 説明 必須
channel チャンネルの説明です。 オブジェクト
channel.number 指定されたチャンネルを識別する番号です(「5」や「12.1」など)。 文字列 ×
ただし、channel.numberchannelMetadata.namechannel.callSign
affiliateCallSignuriのいずれかを指定する必要があります。
channel.callSign PBSなどのコールサインでチャンネルを指定します。 文字列 ×
ただし、channel.numberchannelMetadata.namechannel.callSign
affiliateCallSignuriのいずれかを指定する必要があります。
channel.affiliateCallSign KCTS9といった地方系列局のコールサインでチャンネルを指定します。 文字列 ×
ただし、channel.numberchannelMetadata.namechannel.callSign
channel.affiliateCallSignchannel.uriのいずれかを指定する必要があります。
channel.uri チャンネルのURIです(「entity://provider/channel/12307」など)。 文字列 ×
ただし、channel.numberchannelMetadata.namechannel.callSign
channel.affiliateCallSignchannel.uriのいずれかを指定する必要があります。
channelMetadata 指定されたチャンネルの追加情報を指定します。 オブジェクト ×
channelMetadata.name チャンネルを識別する別の値です(「FOX」など)。 文字列 ×
ただし、channel.numberchannelMetadata.namechannel.callSign
channel.affiliateCallSignchannel.uriのいずれかを指定する必要があります。
channelMetadata.image チャンネルを表すイメージのURLです。 文字列 ×

レスポンスの例

チャンネル変更のリクエストが成功した場合は、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":{ }
 }
}

エラーレスポンス

何らかの理由でユーザーのリクエストを完了できない場合は、エラーレスポンスを返す必要があります。詳細については、エラー処理を参照してください。