デバイステンプレートを使用して開発を始める


デバイステンプレートを使用して開発を始める

スマートホームAPIを使用すると、どのようなタイプのデバイスでも仮想的にAlexaに接続できます。デバイスのエンドポイントと機能は、Alexa検出についてで説明されている標準検出メカニズムを使用して指定します。検出応答で、各デバイスがサポートするスマートホームインターフェースを識別します。

まず、デバイステンプレートを確認してデバイスタイプに合ったものを見つけます。各テンプレートでは、デバイスのタイプに適したスマートホームインターフェースの実装を推奨します。デバイスのニーズに合わせてインターフェースの追加・削除を行い、これらのインターフェースを変更できます。すべてのテンプレートは必須の最上位のAlexaインターフェースを備えており、Alexa.EndpointHealthインターフェースを実装してデバイスの状態をAlexaにレポートすることを推奨します。また、各テンプレートでは表示カテゴリーを推奨します。表示カテゴリーによって、Alexaアプリに表示されるアイコンや配置が決まります。

スマートホームスキルの詳細については、スマートホームスキルを理解するを参照してください。Works with Alexa(WWA)認定に必要なインターフェースの詳細については、特定のデバイスタイプの要件を参照してください。

エアコン(AC)ユニット

ユーザーは、以下のような発話を使ってエアコンを操作できます。

Alexa, set the AC to twenty-five degrees for four hours.
Alexa, make it cooler in here.

Alexaスキルでは、表示カテゴリーとしてAIR_CONDITIONERを使用し、以下のインターフェースを実装することをお勧めします。エアコンに風速設定がある場合、Alexa.RangeControllerインターフェースも実装できます。検出応答の例については、エアコン用の検出応答の例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.ThermostatController

ユーザーが温度を制御するデバイスを操作できます。

Alexa.TemperatureSensor

デバイスが温度を感知してレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

空気清浄機

ユーザーは、以下のような発話を使って空気清浄機を操作できます。

Alexa, turn on the Air Purifier.
Alexa, turn off the Air Purifier.
Alexa, set the fan speed of my Air Purifier to seven.

Alexaスキルでは、表示カテゴリーとしてAIR_PURIFIERを使用し、以下のインターフェースを実装することをお勧めします。空気清浄機に風速設定やモード設定がある場合、Alexa.Alexa.RangeControllerインターフェースまたはAlexa.ModeControllerインターフェースを実装することもできます。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.InventoryLevelSensorまたはAlexa.InventoryLevelUsageSensor

スキルがデバイスの消耗品の残量またはデバイスに取り付けられている消耗品のおおよその使用状況をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

空気品質モニター

空気品質モニターを使用すると、ユーザーは空間の温度、湿度、粒子状物質を追跡、測定できます。

Alexaスキルでは、表示カテゴリーとしてAIR_QUALITY_MONITORTEMPERATURE_SENSORを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.TemperatureSensor

デバイスが温度を感知してレポートします。

Alexa.RangeController
(値の範囲)

空気の品質や湿度の測定値をレポートする範囲コントローラーを作成します。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ブラインドまたはシェード

プリビルドの音声対話モデルに加え、セマンティクスを使用することで追加の発話に対応できます。このブラインドの例では、モードコントローラーのセマンティクスを使用しているため、「開けて」「閉めて」「上げて」「下げて」と言ってブランドを制御できます。詳細については、semanticsオブジェクトを参照してください。

この例では、以下のような発話を使ってブラインドを操作できます。

Alexa, open the blinds.
Alexa, close the blinds.
Alexa, raise the blinds.
Alexa, lower the blinds.

Alexaスキルでは、表示カテゴリーとしてINTERIOR_BLINDまたはEXTERIOR_BLINDを使用することをお勧めします。

ブラインドが指定範囲で上げ下げできる場合、以下のインターフェースを実装することをお勧めします。検出応答の例については、ブラインドにセマンティクスを使用した例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ToggleController
(開閉)

ユーザーがブラインドを開閉できるように、Blind.Controlトグルコントローラーを作成します。

Alexa.RangeController
(位置の範囲)

ユーザーがブラインドの高さを制御できるように、Blind.Lift範囲コントローラーを作成します。たとえば、正と負の10段階のデルタ値の範囲でブラインドを上げ下げします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ブラインドが全開と全閉のみに対応する場合、以下のインターフェースを実装することをお勧めします。検出応答の例については、ブラインドにセマンティクスを使用した例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ModeController
(開閉)

Position.Up(開く)、Position.Down(閉じる)のモードを持つBlinds.Positionモードコントローラーを作成します。これにより、ユーザーはブラインドを開閉できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

カメラ

ユーザーは、以下のような発話を使ってカメラを操作できます。

Alexa, talk to my front door camera.
Alexa, show the last activity at my front door.

Alexaスキルでは、表示カテゴリーとしてCAMERAを使用し、以下のインターフェースを実装することをお勧めします。これらのインターフェースのサポートを含む検出応答の例については、パン、チルト、ズームをサポートするカメラの例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.CameraStreamController

ユーザーがカメラストリームを表示できます。

Alexa.RTCSessionController

ユーザーはカメラとリモート通信できます。

Alexa.RangeController
(パン)

物理的に左右のパンが可能なカメラの場合、Camera.Panという範囲コントローラーを作成してユーザーがカメラビューをパンできるようにします。

Alexa.RangeController
(チルト)

物理的に上下のチルトが可能なカメラの場合、Camera.Tiltという範囲コントローラーを作成してユーザーがカメラビューをチルトできるようにします。

Alexa.RangeController
(ズーム)

物理的にズームインとアウトが可能なカメラの場合、Camera.Zoomという範囲コントローラーを作成してユーザーがカメラビューをズームできるようにします。

Alexa.InventoryLevelSensor

スキルがデバイスのバッテリー残量をレポートします。バッテリー式カメラの場合にのみ必要です。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

衣類乾燥機

ユーザーは、以下のような発話を使って洗濯乾燥機を操作できます。

Alexa, what's the current dryer cycle?
Alexa, set the dryer temperature on the dryer to normal.

Alexaスキルでは、表示カテゴリーとしてDRYERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ToggleControllerまたはAlexa.PowerController

ユーザーは乾燥機を始動および停止できます。

Alexa.ModeController
(乾燥機の運転サイクル)

乾燥機がサポートする運転サイクルのタイプ(乾燥、クールダウン、完了など)を定義するDryer.CurrentDryerCycleモードコントローラーを作成します。

Alexa.ModeController
(温度設定)

乾燥機の温度設定を定義するDryer.Temperatureモードコントローラーを作成します。

Alexa.ModeController
(糸くずフィルター)

糸くずフィルター内の糸くずの量を定義するDryer.LintTrapモードコントローラーを作成します。

Alexa.ProactiveNotificationSource

乾燥が完了しました乾燥機の糸くずフィルターがいっぱいですなど、ユーザーへの通知を有効にします。

Alexa.InventoryUsageSensor

洗剤カプセルや柔軟剤など、デバイスに投入されている消耗品の使用状況をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

色が変化する電球

ユーザーは、以下のような発話を使って色が変化する電球を操作できます。

Alexa, turn on the Living Room Light.
Alexa, set the Living Room Light to blue.
Alexa, set the Living Room Light to fifty percent.
Alexa, make the Living Room Light warm white.

Alexaスキルでは、表示カテゴリーとしてLIGHTを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.ColorController

ユーザーが照明の色を制御できます。

Alexa.BrightnessController

ユーザーが照明の明るさを制御できます。

Alexa.ColorTemperatureController

ユーザーが照明の色温度を制御できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

接触センサー

ユーザーは、以下のような発話を使って接触センサーを操作できます。

Alexa, is the bedroom window open?

Alexaスキルでは、表示カテゴリーとしてCONTACT_SENSORを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ContactSensor

接触センサーデバイスが窓やドアの開閉をレポートします。

Alexa.InventoryLevelSensor

接触センサーデバイスがデバイスのバッテリー残量をレポートします。バッテリー式接触センサーの場合にのみ必要です。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

調光式電球

ユーザーは、以下のような発話を使って調光式電球を操作できます。

Alexa, turn on the Kitchen Light.
Alexa, set the Kitchen Light to eighty percent.

Alexaスキルでは、表示カテゴリーとしてLIGHTを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.BrightnessController

ユーザーが照明の明るさを制御できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

調光式スイッチ

ユーザーは、以下のような発話を使って調光式スイッチを操作できます。

Alexa, turn on the Bedroom Light.
Alexa, set the Bedroom Light to twenty percent.

Alexaスキルでは、表示カテゴリーとしてSWITCHを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.BrightnessController

ユーザーが照明の明るさを制御できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

食器洗い機

ユーザーは、以下のような発話を使って食器洗い機を操作できます。

Alexa, what's the current dishwasher cycle?
Alexa, set the wash setting on the dishwasher to normal.

Alexaスキルでは、表示カテゴリーとしてDISHWASHERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ToggleControllerまたはAlexa.PowerController

ユーザーは食器洗い機を始動および停止できます。

Alexa.ModeController
(洗浄モード)

食器洗い機がサポートする洗浄サイクルのタイプを定義するWashCycleモードコントローラーを作成します。

Alexa.ModeController
(温度設定)

水温設定を定義するWaterTemperatureモードコントローラーを作成します。

Alexa.ProactiveNotificationSource

食器洗いが完了しましたなど、ユーザーへの通知を有効にします。

Alexa.InventoryUsageSensor

デバイスに残量センサーが搭載されている場合、洗剤カプセルや柔軟剤など、デバイスに投入されている消耗品の使用状況をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

扇風機

この例では、以下のような発話を使ってタワー型扇風機を操作できます。

Alexa, turn on the Living Room Fan.
Alexa, turn on Oscillate on the Living Room Fan.
Alexa, set the Living Room Fan Speed to five.
Alexa, turn up the Speed on the Living Room Fan.
Alexa, set the air Speed on the Living Room Fan to Maximum.

Alexaスキルでは、表示カテゴリーとしてFANを使用し、以下のインターフェースを実装することをお勧めします。扇風機が首振りモードや風速をサポートする場合の検出応答の例については、範囲コントローラーとトグルコントローラーを両方使った例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.ToggleController
(首振り)

ユーザーが扇風機の首振り機能をオン/オフできるようOscillateトグルコントローラーを作成します。

Alexa.RangeController
(風量)

ユーザーが扇風機の風速を制御できるようFan Speed範囲コントローラーを作成します。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ゲーム機

ユーザーは、以下のような発話を使ってゲーム機を操作できます。

Alexa, turn on the Game Console.
Alexa, search for ABC on the Game Console.
Alexa, pause the Game Console.

Alexaスキルでは、表示カテゴリーとしてGAME_CONSOLEを使用します。次のインターフェースを実装することを推奨します。これらのインターフェースのサポートを含む検出応答の例については、エンターテイメントデバイスの例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.ChannelController

ユーザーがデバイスのチャンネルを変更できます。

Alexa.Launcher

ユーザーが、Prime Videoなどの指定したアプリの起動や、テレビの表示設定などのUIショートカットの呼び出しをAlexaにリクエストできます。

Alexa.PlaybackController

ユーザーがデバイスを再生、停止、一時停止できます。

Alexa.PlaybackStateReporter

デバイスの再生状態をAlexaにレポートします。

Alexa.RemoteVideoPlayer

ユーザーがビデオコンテンツの検索と再生をAlexaにリクエストできます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ガレージドアオープナー

プリビルドの音声対話モデルに加え、セマンティクスを使用することで追加の発話に対応できます。このガレージドアの例では、モードコントローラーのセマンティクスを使用しているため、「開けて」「閉めて」と言ってガレージドアを制御できます。詳細については、セマンティクスを使用して発話を追加するを参照してください。

この例では、以下のような発話を使ってガレージドアオープナーを操作できます。

Alexa, open the garage door.
Alexa, close the garage door.
Alexa, is the garage door open?

Alexaスキルでは、表示カテゴリーとしてGARAGE_DOORを使用します。ガレージドアオープナーには、次のインターフェースを実装することを推奨します。検出応答の例については、ガレージドアオープナーにセマンティクスを使用した例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ModeController

Position.UpPosition.Downのモードを持つGarageDoor.Positionモードコントローラーを作成します。これにより、ユーザーはガレージドアを開閉できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ギターアンプ

以下は、スマートギターアンプをAlexaに接続する方法です。この例では架空のデバイスを使っていますが、あらゆるデバイスをAlexaに接続する方法の例として参考にしてください。ほかのデバイスと同様、この例ではできる限り具体的なAlexa.PowerControllerAlexa.SpeakerAlexa.EqualizerControllerなどのインターフェースを選択しています。その後、Alexa.ToggleControllerAlexa.RangeControllerAlexa.ModeControllerのインターフェースの柔軟性を利用して、すべての機能をカバーできるようにしています。

この例では、以下のような発話を使ってギターアンプを操作できます。

Alexa, turn on the Awesome Amp.
Alexa, set the volume of the Awesome Amp to six.
Alexa, set the bass on the Awesome Amp to three.
Alexa, turn on overdrive on the Awesome Amp.
Alexa, set the gain on the Awesome amp to four.
Alexa, set the Awesome Amp to Metal.
Alexa, boost the gain.
Alexa, make me sound like Pearl Jam.
Alexa, what do all these dials do?

Alexaスキルでは、表示カテゴリーとしてSPEAKERを使用し、以下のインターフェースを実装することをお勧めします。これらのインターフェースのサポートを含む検出応答の例については、ギターアンプの例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.Speaker

ユーザーがデバイスの音量を設定、調整、ミュートまたはミュート解除できます。

Alexa.InputController

ユーザーがアンプの入力を変更できます。

Alexa.EqualizerController

ユーザーが、デバイスの低音域、中音域、高音域を設定・調整できます。

Alexa.ToggleController

ユーザーがアンプのオーバードライブ機能をオン/オフできるようOverdriveトグルコントローラーを作成します。

Alexa.RangeController

ユーザーがアンプのゲイン(ドライブ)を制御できるようGain範囲コントローラーを作成します。

Alexa.ModeController

ユーザーが定義済みまたは保存済みの設定を選択できるようPresetモードコントローラーを作成します。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

ロック

ユーザーは、以下のような発話を使ってロックを操作できます。

Alexa, lock the Front Door.
Alexa, unlock the Back Door.
Alexa, is my door locked?
Alexa, is my door unlocked?

Alexaスキルでは、表示カテゴリーとしてSMARTLOCKDOORのいずれかを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.LockController

ユーザーがデバイスをロック/ロック解除できます。

Alexa.InventoryLevelSensor

スキルがデバイスのバッテリー残量をレポートします。バッテリー式ロックの場合にのみ必要です。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

電子レンジ

電子レンジが、調理の開始と停止、調理モードの変更、時間による調理、調理の一時停止、調理の再開を実行できます。ユーザーは、以下のような発話を使って電子レンジを操作できます。

Alexa, is the microwave running?
Alexa, stop the microwave.
Alexa, defrost three pounds of meat in my microwave.

Alexaスキルでは、表示カテゴリーとしてMICROWAVEを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.Cooking

調理する食品や調理モードなど、基本的な調理の情報を指定します。すべての調理器具に必要です。

Alexa.Cooking.TimeController

ユーザーが、調理時間、温度、電力レベルを制御する調理器具を操作できます。

Alexa.TimeHoldController

ユーザーが調理器具を一時停止できます。

Alexa.Cooking.PresetController

ユーザーが、プリセットと呼ばれるカスタム設定で調理できる調理器具を操作できます。ポップコーンボタンを搭載した電子レンジなどです。

Alexa.ProactiveNotificationSource

レンジ内の食品の調理が終わりましたなど、ユーザーへの通知を有効にします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

モーションセンサー

モーションセンサーデバイスは、領域内の物理的な動きをレポートします。

Alexaスキルでは、表示カテゴリーとしてMOTION_SENSORを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.MotionSensor

モーションセンサーデバイスが、物理的な動きをAlexaにレポートします。

Alexa.InventoryLevelSensor

モーションセンサーデバイスがデバイスのバッテリー残量をレポートします。バッテリー式モーションセンサーの場合にのみ必要です。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

プラグまたは電源タップ

ユーザーは、以下のような発話を使ってプラグや電源タップを操作できます。

Alexa, turn on the End Table Lamp.

Alexaスキルでは、表示カテゴリーとしてSMARTPLUGを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

プリンター

ユーザーは、以下のような発話を使ってプリンターを操作できます。

Alexa, turn on the printer.
Alexa, print my Shopping List.

Alexaスキルでは、表示カテゴリーとしてPRINTERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.InventoryLevelSensor

プリンターが、デバイス内のインクの使用状況やその他のサプライ用品の残量をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

リモコンとボタン

ユーザーは、スマートボタンやリモコンのスイッチを手動で操作して、照明を25%暗くしてブラインドを閉めるなどの定型アクションをトリガーできます。これらのタイプのデバイスでは、ユーザーの発話はありません。

Alexaスキルでは、表示カテゴリーとしてREMOTEを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.SimpleEventSource

リモコンのボタンの押下や、居住者の入室などのステートレスイベントをモデル化します。ユーザーは、イベントをAlexa定型アクションに接続できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

セキュリティパネル

ユーザーは、以下のような発話を使ってセキュリティパネルを操作できます。

Alexa, arm my home in away mode.
Alexa, disarm my home.

Alexaスキルでは、表示カテゴリーとしてSECURITY_PANELSECURITY_SYSTEMのいずれかを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.SecurityPanelController

ユーザーはセキュリティシステムを起動/解除できます。

Alexa.SecurityPanelController.Alert

ユーザーは、Alexa搭載デバイスからの音でセキュリティシステムのエンドポイントを強化できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

サウンドバーやスピーカー

ユーザーは、以下のような発話を使ってサウンドバーやスピーカーを操作できます。

Alexa, mute speakers.
Alexa, set the volume of the soundbar to fifty.
Alexa, play device.

Alexaスキルでは、表示カテゴリーとしてSPEAKERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.Speaker

ユーザーが、オーディオスピーカーを搭載したエンターテイメントデバイスの音量を調整できます。

Alexa.PlaybackController

ユーザーが、オーディオコンテンツの再生、停止、再生ナビゲーションを実行できます。再生コントロールを搭載したデバイス用です。

Alexa.PlaybackStateReporter

エンドポイントの再生状態をAlexaにレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

スイッチ

ユーザーは、以下のような発話を使ってスイッチを操作できます。

Alexa, turn on the Bathroom Fan.

Alexaスキルでは、表示カテゴリーとしてSWITCHを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

テレビ

ユーザーは、以下のような発話を使ってテレビを操作できます。

Alexa, channel up on the TV.
Alexa, launch Prime Video.
Alexa, fast forward thirty seconds.
Alexa, search for soccer.
Alexa, record next episode of Jack Ryan.
Alexa, turn the volume down on Living Room TV.

Alexaスキルでは、表示カテゴリーとしてTVを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ChannelController

ユーザーが、ビデオデバイスのチャンネルを変更できます。

Alexa.InputController

ユーザーがテレビの入力を変更できます。

Alexa.Launcher

ユーザーが、Prime Videoなどの指定したアプリの起動や、テレビの表示設定などのUIショートカットの呼び出しをAlexaにリクエストできます。

Alexa.PlaybackController

ユーザーが、ビデオコンテンツの再生、停止、再生ナビゲーションを実行できます。

Alexa.PlaybackStateReporter

テレビの再生状態をAlexaにレポートします。

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。オプションで、デバイスがTurnOffディレクティブに応答し、掃除機をベースに戻すことができます。

Alexa.RemoteVideoPlayer

ユーザーがビデオコンテンツの検索と再生をAlexaにリクエストできます。

Alexa.VideoRecorder

ユーザーが指定したビデオ項目を検索して録画を予約できます。

Alexa.Speaker

ユーザーがオーディオスピーカーの音量を調整できます。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

掃除機

ユーザーは、以下のような発話を使って掃除機を操作できます。

Alexa, turn on the vacuum.
Alexa, return the vacuum to base.

Alexaスキルでは、表示カテゴリーとしてVACUUM_CLEANERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.PowerController

ユーザーがデバイスをオン/オフできます。オプションで、デバイスがTurnOffディレクティブに応答し、掃除機をベースに戻すことができます。

Alexa.ModeController

電源コントローラーの代わりに、掃除機のReturnToBaseモードコントローラーを作成します。

Alexa.ModeController(設定)

オプションで、毛足の短いカーペット、毛足の長いカーペット、床、タイルなどの設定が可能な掃除機のSettingsモードコントローラーを作成します。

お知らせのセマンティクスは、Alexa.ModeControllerまたはAlexa.RangeControllerでサポートされています。

掃除機の集塵ボックスがいっぱいまたは空の状態に対応してユーザーに事前にお知らせするためのBinコントローラーを作成します。

Alexa.ProactiveNotificationSource

掃除機が詰まっています掃除機の集塵ボックスがいっぱいですなど、ユーザーへの通知を有効にします。

Alexa.InventoryLevelUsageSensor

フィルターなど、デバイスに取り付けられている消耗品のおおよその使用状況をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

壁面サーモスタット

ユーザーは、以下のような発話を使って壁面サーモスタットを操作できます。

Alexa, set thermostat to 20.
Alexa, make it warmer in here.

Alexaスキルでは、表示カテゴリーとしてTHERMOSTATを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ThermostatController

ユーザーが温度を制御するデバイスを操作できます。

Alexa.TemperatureSensor

デバイスが温度を感知してレポートします。

Alexa.ThermostatController.Schedule

ユーザーは、週間スケジュールを設定できます。

Alexa.ThermostatController.Configuration

サーモスタットデバイスは、Alexaアプリでのインストールとセットアップをサポートしています。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

洗濯乾燥機

ユーザーは、以下のような発話を使って洗濯乾燥機を操作できます。

Alexa, what's the current washer cycle?
Alexa, set the wash setting on the washer to normal.

Alexaスキルでは、表示カテゴリーとしてWASHERを使用し、以下のインターフェースを実装することをお勧めします。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ToggleControllerまたはAlexa.PowerController

ユーザーは洗濯機を始動および停止できます。

Alexa.ModeController
(洗浄モード)

洗濯機がサポートする洗浄サイクルのタイプを定義するWashCycleモードコントローラーを作成します。

Alexa.ModeController
(温度設定)

水温設定を定義するWaterTemperatureモードコントローラーを作成します。

Alexa.ProactiveNotificationSource

洗濯が完了しましたなど、ユーザーへの通知を有効にします。

Alexa.InventoryUsageSensor

デバイスに残量センサーが搭載されている場合、洗剤カプセルや柔軟剤など、デバイスに投入されている消耗品の使用状況をレポートします。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

給湯器

給湯器を次のようにモデル化できます。この例ではAlexa.ToggleControllerを使用してAlexa hunches(日本未対応)をサポートします。Alexa Hunchesの詳細については、What Are Alexa Hunches?およびEnable Alexa to Proactively Act on Hunches Without Customers Needing to Askを参照してください。

この例では、Alexa.DeviceUsage.Meterを使用して、ユーザーがAlexaエネルギーダッシュボードでエネルギー使用量を管理できるようにしています。詳細については、Smart Home Energy Overviewを参照してください。

Alexaスキルでは、表示カテゴリーとしてWATER_HEATERを使用することをお勧めします。デバイスの動作に対応する、次の表のインターフェースを実装します。これらのインターフェースのサポートを含む検出応答の例については、給湯器の例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ThermostatController

ユーザーは、給湯器内の水の目標温度を1つ以上設定できます。

Alexa.TemperatureSensor

装置は、給湯器内の水の温度を感知し、レポートします。

Alexa.ToggleController

給湯器の省エネモードを制御するために、EnergySaverModeという名前のトグルコントローラーを作成します。

Alexa.DeviceUsage.Meter

ユーザーは、給湯器のエネルギー使用量の推定値を表示できます。

Alexa.PowerController

ユーザーが給湯器をオン/オフできます。

Alexa.EndpointHealth

給湯器の接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。

Wi-Fiルーター

ユーザーは、以下のような発話を使ってWi-Fiルーターを操作できます。

Alexa, turn on guest Wi-Fi.
Alexa, turn off guest Wi-Fi.
Alexa, turn on guest network.
Alexa, turn off guest network.
Alexa, is the guest Wi-Fi on?
Alexa, is the guest Wi-Fi off?
Alexa, is the guest network on?
Alexa, is the guest network off?

Alexaスキルでは、表示カテゴリーとしてOTHERを使用し、以下のインターフェースを実装することをお勧めします。これらのインターフェースのサポートを含む検出応答の例については、Wi-Fiルーターの例を参照してください。

Alexa機能インターフェース 用途 WWA認定に必要

Alexa.ToggleController

ユーザーがルーターをオン/オフできるようGuestWiFiトグルコントローラーを作成します。

Alexa.EndpointHealth

スキルがデバイスの接続ステータスをAlexaにレポートします。

Alexa

基本インターフェース。すべてのAlexaスキルに必要です。


このページは役に立ちましたか?

最終更新日: 2024 年 12 月 19 日