Works with Alexa認定の要件



Works with Alexa認定の要件

Works with Alexa（WWA）認定の対象となる製品は、厳格な要件を満たす必要があります。製品の認定を申請する前に、以下の要件を確認してください。

Works with Alexa認定プログラムの一般的なガイドラインや、テストのために製品を提出する方法については、Works with Alexa認定の概要を参照してください。

Works with Alexaプログラムガイドライン

Works with Alexa認定の申請資格を得るためには、製品がWorks with Alexaプログラムガイドラインに従っている必要があります。

モバイルアプリの要件

デバイスにセットアップ用およびアカウントリンク用のモバイルアプリがある場合、アプリはiOSとAndroidの両方をサポートする必要があります。ベストプラクティスとして、そのアプリからAlexaアプリへのアカウントリンクを追加します。詳細については、アプリ間アカウントリンクを参照してください。

Alexaスキルの要件

製品がスキルを使ってAlexaに接続する場合、製品のWWA認定を申請する前に、スキルが以下の要件を満たしていることを確認してください。

状態および変更レポートの要件

製品の状態レポートを使用すると、スマートホームデバイスの状態をAlexaアプリに正確に反映できるようになります。状態および変更レポートに関する一般的な情報は、状態および変更レポートについておよびイベントゲートウェイにイベントを送信するを参照してください。

スキルには、次のように状態および変更レポートを実装してください。

  • 検出の応答で、すべての機能プロパティをretrievableおよびproactivelyReportedに設定します。詳細については、Alexa.Discoveryを参照してください。
  • 制御ディレクティブに応答する際、Alexa.Responseイベントのコンテキストで、すべての機能プロパティ（EndpointHealthによって定義されたプロパティを含む）の状態を常にレポートします。詳細については、Alexa.Responseで状態をレポートするを参照してください。
  • ReportStateディレクティブにStateReportイベントで応答します。詳細については、StateReportで状態をレポートするを参照してください。
  • デバイスの状態が変更された場合、その理由にかかわらずChangeReportイベントを送信することで、デバイスの状態をプロアクティブにAlexaに知らせます。詳細については、ChangeReportで状態をレポートするを参照してください。
  • レポートされたプロパティの状態が変更された場合、変更から3秒以内に新しいプロパティ値を含むChangeReportを送信します。ChangeReportには、Alexa.EndpointHealthインターフェースで定義されるconnectivityプロパティの現在値も含めます。
  • デバイスのconnectivityがOKに変更された場合、3秒以内にレポートを送信します。
  • ChangeReportイベントが503、429、401のHTTPエラー、メッセージタイムアウトのいずれかで失敗した場合、ChangeReportの再送信を試行します。再送信の際、15秒以内の間隔を空けて2回以上試行してください。詳細については、イベントゲートウェイにイベントを送信するのエラーセクションを参照してください。

操作上の要件

スキルは以下の操作要件を満たし、維持する必要があります。

  • レイテンシー – Alexaがスキルにリクエストを送信した後、Alexaは1000ミリ秒間に90%（P90）、800ミリ秒間に50%（P50）の応答を受け取る必要があります。
  • 正確率 – ReportStateディレクティブへの応答がAlexaに最後に送信したChangeReportイベントに97%以上一致している必要があります。

製品がこれらの要件を下回ると、製品はWWA認定バッジの資格を失う可能性があります。スキルのパフォーマンスを確認するには、Alexa開発者コンソールのレポートページを参照してください。

製品のテスト

開発者ポータルでテスト対象のスキルを有効にし、Alexa搭載デバイスとAlexaアプリを使用して、デバイスでスキルをテストします。WWA認定プロセスに合格するには、スキルが速やかに応答し、エラーが適切に処理される必要があります。詳細については、スマートホームスキルのデバッグを参照してください。開発者コンソールでデバイスの状態をテストおよびデバッグするには、デバイスの状態を表示するを参照してください。

Zigbeeの要件

製品がZigbeeプロトコルを使ってAlexaに接続する場合、製品のWWA認定を申請する前に、製品が以下の要件を満たしていることを確認してください。Zigbeeプロトコルの詳細については、Zigbee Allianceの開発者向けリソース（英語）を参照してください。

デバイスの要件

デバイスは、製品がサポートする機能を実行するため、機能インターフェースを実装する必要があります。認定資格を満たすには、デバイスで指定された必須のインターフェースをサポートする必要があります。すべてのデバイスがデバイスの検出と状態レポートをサポートしている必要があります。詳細については、Alexa.Discoveryおよび状態レポートを理解するを参照してください。デバイスの種類によっては、必須の機能インターフェースがない場合もあります。

ベストプラクティスとして、検出応答のadditionalAttributesオブジェクトにmanufacturerとmodelを追加します。

サーモスタット

以下の表は、サーモスタットカテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
エアコン 温度の設定、現在の温度の照会 ThermostatController
エアフィルター 電源のオン、電源のオフ PowerController
空気清浄機 電源のオン、電源のオフ PowerController
扇風機 電源のオン、電源のオフ PowerController
空調ユニット 温度の設定、現在の温度の照会 ThermostatController
サーモスタット 温度の設定、現在の温度の照会 ThermostatController

製品が以下のサーモスタット機能のいずれかを任意でサポートする場合は、製品登録時にその機能を指定します。

エンターテイメント

以下の表は、エンターテイメントカテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
アンプ 音量の設定と調整、ミュート、ミュート解除、入力の選択 Speaker、InputController
プロジェクター 電源のオン、電源のオフ PowerController
受信器 音量の設定と調整、ミュート、ミュート解除、入力の選択 Speaker、InputController
リモコン チャンネルの設定、音量の設定と調整、ミュート、ミュート解除、電源のオン、電源のオフ ChannelController、InputController、PowerController
セットトップボックス チャンネルの設定、音量の設定と調整、ミュート、ミュート解除、電源のオン、電源のオフ ChannelController、InputController、PowerController
サウンドバー デバイスの再生、デバイスの停止、デバイスの一時停止、音量の設定と調整、ミュート、ミュート解除 PlaybackController、Speaker
スピーカー デバイスの再生、デバイスの停止、デバイスの一時停止、音量の設定と調整、ミュート、ミュート解除 PlaybackController、Speaker
サブウーファー イコライザーバンドの設定、サウンドモードの設定 EqualizerController
テレビ チャンネルの設定、音量の設定と調整、ミュート、ミュート解除、電源のオン、電源のオフ ChannelController、InputController、PowerController


以下の表は、エンターテイメントカテゴリーのデバイスに推奨される機能インターフェースの一覧です。認定を受ける際のベストプラクティスとして、これらのインターフェースを使用します。

デバイスの例 推奨の機能 推奨のAlexa機能インターフェース
セットトップボックス 検索と表示、検索と再生、アプリとショートカットの起動、状態レポート RemoteVideoPlayerのSearchAndDisplayResults、RemoteVideoPlayerのSearchAndPlay、LaunchTarget、PlaybackStateReporter
テレビ 検索と表示、検索と再生、アプリとショートカットの起動、状態レポート RemoteVideoPlayerのSearchAndDisplayResults、RemoteVideoPlayerのSearchAndPlay、LaunchTarget、PlaybackStateReporter

製品が以下のエンターテイメント機能のいずれかを任意でサポートする場合は、製品登録時にその機能を指定します。

ホームオフィス

以下の表は、ホームオフィスカテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
ルーター ネットワークアクセスの有効化、ネットワークアクセスの無効化 NetworkAccessController

製品が以下のホームオフィス機能のいずれかを任意でサポートする場合は、製品登録時にその機能を指定します。

ホームセキュリティ

以下の表は、ホームセキュリティカテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
カメラ カメラストリームの取得 CameraStreamController
インターホン ドアベルのイベントの捕捉 DoorbellEventSource
ドアロック ロックの設定、ロック解除 LockController
ガレージドアオープナー ガレージドアを開く、ガレージドアを閉める セマンティクスを使ったModeController
セキュリティパネル セキュリティシステムの有効化、セキュリティシステムの無効化 SecurityPanelController

製品が以下のセキュリティ機能のいずれかを任意でサポートする場合は、製品登録時にその機能を指定します。

家庭用品、パーソナルケア製品

以下の表は、家庭用品・パーソナルケア製品カテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
アロマディフューザー 電源のオン、電源のオフ PowerController
掃除機 電源のオン、電源のオフ、充電ベースに戻る PowerController
充電ベースに戻るアクションはPowerControllerのTurnOffディレクティブまたはModeControllerのセマンティクスを使用して実装してください。

キッチンと調理器具

以下の表は、キッチンおよび調理器具カテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
電子レンジ 調理を開始および停止、調理モードの変更、時間による調理、調理の一時停止、調理の再開 Cooking.TimeController、TimeHoldController

照明と電源

以下の表は、照明と電源カテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
ディマー 電源のオン、電源のオフ PowerController
ランプ 電源のオン、電源のオフ PowerController
電球 電源のオン、電源のオフ PowerController
蛍光灯 電源のオン、電源のオフ PowerController
電源タップ 電源のオン、電源のオフ PowerController
プラグ 電源のオン、電源のオフ PowerController
スイッチ 電源のオン、電源のオフ PowerController

製品が以下の機能のいずれかを任意でサポートする場合は、製品登録時にその機能を指定します。

センサー

以下の表は、センサーカテゴリーのデバイスに必須の機能インターフェースの一覧です。

デバイスの例 必須の機能 必須のAlexa機能インターフェース
接触センサー 接触を検出してレポートします。 ContactSensor
モーションセンサー 動きを検出してレポートします。 MotionSensor

バッジの要件

WWAバッジは、Amazonで販売することを目的とした製品のためにあります。WWA認定バッジをリクエストする前に、製品のWWA認定プロセス中に発生した更新や修正プログラムを適用してください。

WWAバッジを受け取るには、製品が以下の要件を満たしている必要があります。

  1. 製品にASINがあること。
  2. リクエストした国のAmazonでASINが入手でき、入手不可、無効、制限中でないこと。
  3. ASINのモデル番号がASINの詳細ページに記載された製品のモデル番号と一致すること。
  4. ハブを使って製品をAlexaに接続する場合、ハブのASINがWWA認定中にテストしたハブと同じであること。
  5. 製品がAlexaスキルを使用する場合、スキルがリクエストした国のAmazonで入手でき、入手不可、無効、制限中でないこと。

製品がこれらの要件を満たしていない場合、Amazonはバッジのリクエストを却下します。問題を修正し、認定を受けるために製品を再申請する必要があります。申請の手順については、製品の認定申請を参照してください。