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プログラムガイドラインに従っている必要があります。

モバイルアプリの要件

デバイスに、設定用のモバイルアプリがある場合、アプリからAlexaアプリへのアカウントリンクを実装する必要があります。アプリは、iOS、Androidの両方をサポートする必要があります。詳細については、アプリ間アカウントリンクを参照してください。

Alexaスキルの要件

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

  • Alexaと製品の間で通信を行う場合、スマートホームモデルを使い、AWS Lambda関数にコードを追加すること。詳細については、スマートホームスキルAPIについて、スマートホームスキルの作成手順を参照してください。
  • スマートホームAPIがバージョン3であること。デバイスの検出でpayloadversionを3とし、各機能でversionを3に指定すること。詳細については、Alexa.Discoveryを参照してください。
  • 検出応答のadditionalAttributesオブジェクトにmanufacturerとmodelを追加すること。Alexaが一意のデバイスを識別できるよう、できるだけ多くのアトリビュートを追加してください。
  • 製品がサポートする機能を実行するのに必要な機能インターフェースを実装していること。検出応答でサポートされているすべての機能を返すようにしてください。必須の機能の詳細については、デバイスの要件を参照してください。
  • 状態および変更レポートの要件に従っていること。
  • Alexaにデバイスの健全性を通知する場合、EndpointHealthを実装すること。ベストプラクティスとして、できる限り多くのEndpointHealthプロパティをサポートすることをお勧めします。
  • アカウントリンクをサポートしていること。詳細については、アカウントリンクとはを参照してください。
  • プロアクティブ管理をサポートしていること。詳細については、プロアクティブにエンドポイントを管理するにはを参照してください。
  • スキル認定を受け、Alexaスキルストアに公開されていること。詳細については、スマートホームスキル公開のガイドを参照してください。

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

製品の状態レポートを使用すると、スマートホームデバイスの状態を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回以上試行してください。詳細については、イベントゲートウェイにイベントを送信するのエラーセクションを参照してください。

推奨されるパフォーマンス目標

ユーザーに最良のスマートホームエクスペリエンスを提供するため、Amazonでは、Alexaスキルが以下の運用パフォーマンス目標を満たし、維持することを推奨しています。

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

製品のテスト

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

Bluetooth Meshの要件

製品がBluetooth Low-Energy（BLE）Meshプロトコルを使ってAlexaに接続する場合、製品のWWA認定を申請する前に、製品が以下の要件を満たしていることを確認してください。BLE Meshプロトコルの詳細については、Bluetoothの仕様書・テスト資料一覧を参照してください。

  • 製品がBLE Mesh v1.1と以下の仕様をサポートすること。
    • Meshプロファイル1.0.1
    • Meshモデル1.0.1
    • Meshデバイスプロパティ1.1
    • Meshコンフィギュレーションデータベース1.0
  • 製品がデバイスをMeshに追加する静的帯域外（OOB）データプロビジョニングをサポートすること。
    静的OOB認証の詳細については、Meshプロファイル1.0.1仕様のセクション5.4.2、図5.12、オプション3cを参照してください。
  • 製品がBluetooth認証プロセスを完了していること。
  • 製品がBluetooth SIGメンバーCompany Identifier、および社内の製品を一意に識別する16ビットの16進数で表される製品番号を取得していること。
    ユーザーがAmazon Echoを使用してデバイスをプロビジョニングすると、デバイスとEcho間で交換されるメッセージにこれらの識別子が含まれます。
  • Amazonに製品情報を提供すること。
  • Echoデバイスとの間でBLE Mesh統合をテストすること。

Amazonへの製品情報の提供

Alexaアプリに製品が正しく表示されるためには、Alexa開発者向け問い合わせ窓口ページからAmazonに以下の製品情報を提供する必要があります。

  1. Bluetooth SIGメンバーCompany Identifierの会社識別子
    表内のDecimal列の値を提供してください。
  2. 製品ID
    自社内のBLE Meshデバイスを一意に識別する16ビットの16進数番号を提供してください。
  3. Alexaアプリに表示するメーカー名
  4. Alexaアプリに表示するデバイスのモデル名
  5. Alexaアプリに表示する製品説明
  6. Alexaアプリで使用する表示カテゴリー

Zigbeeの要件

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

デバイスの要件

製品のWWA認定を申請する前に、以下の要件を満たす必要があります。

  • デバイスは、製品がサポートする機能を実行するため、機能インターフェースを実装する必要があります。認定資格を満たすには、デバイスカテゴリーで指定された必須のインターフェースをサポートする必要があります。デバイスの種類によっては、必須の機能インターフェースがない場合もあります。詳細については、デバイスカテゴリーごとの必須インターフェースの表を参照してください。
  • すべてのデバイスがデバイスの検出と状態レポートをサポートしている必要があります。詳細については、Alexa.Discoveryおよび状態レポートを理解するを参照してください。
  • 検出応答のadditionalAttributesオブジェクトにmanufacturerとmodelを追加すること。Alexaが一意のデバイスを識別できるよう、できるだけ多くのアトリビュートを追加してください。
  • Alexaにデバイスの健全性を通知する場合、EndpointHealthを実装すること。ベストプラクティスとして、できる限り多くのEndpointHealthプロパティをサポートすることをお勧めします。

サーモスタット

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

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

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

エンターテイメント

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

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


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

ホームオフィス

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

デバイスの例 必須の機能 必須の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

窓の装飾

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

デバイスの例 必須の機能 必須のAlexa機能インターフェース

外装および内装ブラインド

ブライドを開閉します。

Alexa.ToggleController

シェード

シェードを開閉します。

Alexa.ToggleController

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

バッジの要件

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

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

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

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