Amazonサポートフォーラムテクニカルドキュメント一覧Amazonアプリストア公式ブログAlexa開発者ブログAlexa.ChannelControllerインターフェースAlexa.ChannelControllerインターフェースユーザーがチャンネル変更の発話(「アレクサ、チャンネルをPBSに変えて」など)を行うと、Alexa.ChannelControllerインターフェースはChangeChannelディレクティブを送信して、チャンネルの変更が必要であることを示します。これらのディレクティブが送信されるのは、ユーザーがチャンネル名、コールサイン、チャンネル番号のいずれかを指定したときです。ChannelControllerインターフェースを実装するのではなく、ライブTVの統合を行うことをお勧めします。タブや番組表の統合など、より多くのメリットがあります。TVのパートナーに推奨されているアプローチです。ChannelControllerディレクティブの発話ChangeChannelディレクティブの例ペイロードの定義エクスペリエンスタイプChangeChannelディレクティブの処理レスポンスの例ChannelControllerディレクティブの発話ユーザーが以下の発話をすると、AlexaはChannelControllerインターフェースを介してLambdaにChangeChannelディレクティブを送信します。foxビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。thirteenビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。q.ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。foxビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。thirteenビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。d.ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。chaîne[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[channel]ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。chaîne[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。anビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。abビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。anschauenビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。जाओ/जाइए/जाना/चलो/चलनाビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。जाओ/जाना/जाइए/चलो/चलनाビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。जाओ/जाना/जाइए/चलो/चलनाビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。देखो/देखिए/देखना/देखेंビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。देखो/देखना/देखिए/देखेंビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[Channel]ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須[ChannelName]を検索ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須[ChannelName]を見せてビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須チャンネル[ChannelNumber]を見せてビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。認定に必須ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。[CallSign]ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelName]ビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。[ChannelNumber]ビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。tresビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。dosビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。d.ビューが指定されたチャンネルコールサインに切り替わり、そのチャンネルのコンテンツが再生されます。sextaビューが指定されたチャンネル名に切り替わり、そのチャンネルのコンテンツが再生されます。dosビューが指定されたチャンネル番号に切り替わり、そのチャンネルのコンテンツが再生されます。ChangeChannelディレクティブの例ChangeChannelディレクティブの例を以下に示します。payloadpayloadの内容は以下のとおりです。検索結果の表示を最適化するオブジェクトです。詳細については、エクスペリエンスタイプを参照してください。チャンネルの説明です。指定されたチャンネルを識別する番号です(「5」や「12.1」など)。×ただし、channel.number、channelMetadata.name、channel.callSign、affiliateCallSign、uriのいずれかを指定する必要があります。PBSなどのコールサインでチャンネルを指定します。×ただし、channel.number、channelMetadata.name、channel.callSign、affiliateCallSign、uriのいずれかを指定する必要があります。KCTS9といった地方系列局のコールサインでチャンネルを指定します。×ただし、channel.number、channelMetadata.name、channel.callSign、channel.affiliateCallSign、channel.uriのいずれかを指定する必要があります。チャンネルのURIです(「entity://provider/channel/12307」など)。×ただし、channel.number、channelMetadata.name、channel.callSign、channel.affiliateCallSign、channel.uriのいずれかを指定する必要があります。指定されたチャンネルの追加情報を指定します。チャンネルを識別する別の値です(「FOX」など)。×ただし、channel.number、channelMetadata.name、channel.callSign、channel.affiliateCallSign、channel.uriのいずれかを指定する必要があります。チャンネルを表す画像のURLです。×エクスペリエンスタイプexperienceオブジェクトを使用すると、検索に使用されたデバイスに基づいて、検索結果の表示を最適化できます。TVリモコンを使用して検索した場合、ユーザーはリモコンを使用して結果を閲覧できるため、experienceオブジェクトによって多数の検索結果が表示されます。TVとペアリングされたEchoを使用して検索リクエストが行われた場合は、experienceオブジェクトによって表示される結果の数と表示方法が制限され、ユーザーはリモコンを使用せずに結果を確認できます。experienceオブジェクトは、検索結果の表示方法を決定するmodeオブジェクトで構成されています。VOICE_OPTIMIZEDとDEFAULTの2つの値を取ります。音声専用デバイス向けに最適化された表示方法です。リモコンを使用せずに音声で操作できる検索結果のリストが表示されます。検索に使用されたデバイスに関係なく、すべての検索結果をリスト形式で表示する、デフォルトの表示方法です。上位互換性を確保するため、modeで不明な値を受け取った場合は、失敗とするのではなく、DEFAULTにフォールバックするようにしてください。ChangeChannelディレクティブの処理ChangeChannelディレクティブを使用すると、ユーザーが音声コマンドを使用して特定のチャンネルに合わせることができます。ユーザーが「アレクサ、CNNに変えて」と言うと、LambdaでChangeChannelディレクティブを受け取ります。次に、ライブTVストリームを変更して、適切なチャンネルを表示する必要があります。どのディレクティブがどのチャネルに対応しているかを理解するために、チャンネルリストのチャンネルごとに、使用される可能性のあるコールサインのリストを用意しました。このリストに含まれていないチャンネルを追加でサポートする場合は、Amazonの担当者にお問い合わせください。適任者と協力して、その処理方法について必要な情報をご連絡します。チャンネルを任意のチャンネルに変更するようにAlexa搭載デバイスに要求してから、Lambdaログで受け取ったディレクティブを調べて、コールサインを確認してください。その場合でも、Amazonの担当者にこれらのチャンネルについて連絡していただけると、そのチャンネルのAmazonの音声モデルにおける優先順位を判断できるため助かります。チャンネルのコールサインは、チャンネル変更ディレクティブのペイロード内のcallSignフィールドに格納されています。ディレクティブではローカルチャンネルに関する情報は受け取りません。トップレベル名とコールサイン(たとえば「ABC」など)だけです。ユーザー向けのローカリゼーションを実行するかどうかは、開発者しだいです。レスポンスの例チャンネル変更のリクエストが成功した場合は、Responseイベントを送信する必要があります。レスポンスには、リクエスト完了後のチャンネルを報告するコンテキストオブジェクトを含める必要があります。}}何らかの理由でユーザーのリクエストを完了できない場合は、エラーレスポンスを返す必要があります。詳細については、エラー処理を参照してください。無断複写·転載を禁じます。