スマートホームスキルに適用されるWorks with Alexaの要件



Works with Alexa認定スキルの要件

どのようなデバイスのスキルでも、Works with Alexa(WWA)バッジを取得するには、一般的なスマートホームスキルの認定を受ける場合よりも厳しい要件を満たす必要があります。

スキル開発を開始する

developer.amazon.comにログインしてAlexaスキルの開発を開始します。スマートホームモデルの使用をお勧めします。スキルでは、Lambda関数のコードによってAlexaと製品が対話します。スマートホームモデルを使用するスキルの作成についての詳細は、スマートホームスキルAPIについてを参照してください。以下では、WWA固有の要件について説明します。

Alexaスキルの要件

Works with Alexa認定を取得するには、以下の要件を満たす必要があります。

  • スマートホームAPIがバージョン3であること。デバイスの検出でpayloadversionを3とし、各機能でversionを3に指定すること。詳細については、Alexa.Discoveryを参照してください。
  • 検出応答に含まれるすべてのモデルでサポートされている、すべての機能を返すこと。カスタムインテントを使用したスマートホームAPIの組み合わせをサポートするスキルも必要です。スマートホームAPIについてはAlexa.Discovery、カスタムインテントについては、Alexa.CustomIntent(パブリックプレビュー)参照してください。
  • アカウントリンクをサポートしていること。詳細については、アカウントリンクとはをご覧ください。
  • プロアクティブ管理をサポートしていること。詳細については、プロアクティブにエンドポイントを管理するにはを参照してください。
  • EndpointHealthを実装していること。詳細については、状態レポートの要件を参照してください。

状態レポートを実装する

状態レポートを使用すると、スマートホームデバイスの状態をAlexaアプリに正確に反映できるようになります。このセクションを読み進める前に、状態レポートの一般的な情報を確認しておく必要があります。状態レポートとはイベントゲートウェイにイベントを送信するを参照してください。

状態レポートの要件

WWAの要件を満たすには、デバイスで使用するスキルが以下を行う必要があります。

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

これらの要件は以下の機能に適用されます。

状態レポートをテストする

開発ポータルでテスト対象のスキルを有効にし、Alexaが使えるデバイスまたはアプリを使用して、製品でスキルをテストします。製品が速やかに応答しない場合や、エラーが適切に処理されない場合は、認定されません。詳細については、スマートホームスキルのデバッグを参照してください。

スキルの認定を申請する

Works with Alexa認定を完了するには、Alexaスキルストアでスキルを公開する必要があります。スキルを公開するには、スキルが認定されなければなりません。認定を申請するには、開発者コンソールかASK CLIを使用します。Works with Alexa認定は別のプロセスとなります。

その他の情報

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