ServiceAlexa開発者フォーラムAlexaデザインガイドAlexaスキルマーケティングガイドラインAlexa.ColorControllerインターフェース﻿Alexa.ColorControllerインターフェースAlexa.ColorControllerインターフェースには、色が変化する電球などのエンドポイントの色を変化させて、レポートに使用するメッセージが含まれます。ColorControllerインターフェースでサポートされているロケールについては、機能インターフェースの一覧を参照してください。発話ディレクティブSetColorプロパティとイベントプロパティ応答ErrorResponseその他のサンプルコード関連インターフェース発話Alexa.ColorControllerインターフェースを使用する場合、音声対話モデルは既にビルドされています。以下に、ユーザーの発話の例を示します。blue.アレクサ、玄関の電気を青色にして。アレクサ、寝室の電気を赤色にして。アレクサ、キッチンの色を青色にして。ユーザーがこのような発話をしたら、Alexaがそれに対応するディレクティブをスキルに送信します。ディレクティブSetColorエンドポイントに照明の色を設定するようリクエストします。照明に設定する色を示します。HSBカラーモデル(hue:色相、saturation:彩度、brightness:輝度)で指定します。SetColorディレクティブの輝度の値はユーザーがリクエストした色に連動しますが、ユーザーエクスペリエンスの観点では、色を変更する際にターゲットエンドポイントの現在の輝度設定を維持する必要があります。電球が輝度50%(0.5)の白に設定されており、ユーザーが色を赤に変更するようにリクエストしたとすると、SetColorディレクティブは色相、彩度、輝度の値をそれぞれ0、1、1に指定します。輝度が100%になります。この場合はディレクティブの輝度の値を無視して、現在の輝度設定の0.5を維持します。プロパティとイベントこの機能では、次のいずれかの応答を使用する必要があります。同期的に、Lambda関数からAlexaにResponseイベントを送信します。非同期的に、AlexaイベントゲートウェイにResponseイベントを送信します。非同期的に応答する場合、認可トークンにscopeを含めてユーザーを識別し、相関トークンを含めて応答先のディレクティブを識別する必要があります。応答を送信する場合、メッセージのcontextにインターフェースのプロパティの状態を含めます。ColorControllerとColorTemperatureControllerインターフェースをサポートする照明エンドポイントでは、エンドポイントに色が設定されたときはcolorの状態を、エンドポイントに白の色調が設定されたときはcolorTemperatureInKelvinの状態をレポートします。照明に設定する色を示します。HSBカラーモデル(hue:色相、saturation:彩度、brightness:輝度)で指定します。colorプロパティは電球がHSBカラーに設定されている場合にのみレポートされます。応答SetColorディレクティブの処理が成功した場合、Responseイベントにより応答する必要があります。メッセージのcontextにcolorプロパティの状態を含めます。応答の例HSBカラーをサポートするエンドポイント、またはHSBカラーと色温度をサポートするが現在はHSBカラーに設定されているエンドポイントの応答の例を次に示します。}}ErrorResponse何らかの理由によりユーザーのリクエストを完了できない場合、エラー応答を返す必要があります。詳細については、Alexa.ErrorResponseを参照してください。その他のサンプルコードリクエストと応答のサンプルについては、AlexaスマートホームのGitHubリポジトリで以下を参照してください。調整可能な照明エンドポイントの色温度を設定します。