スマートホームスキルのテストとデバッグ
Alexaスマートホームスキルを開発する際に、状態やイベントのテストやデバッグを行うさまざまなツールが用意されています。
-
デバイス状態の確認 – スキルと開発者アカウントに関連付けられたスマートホームデバイスのすべてのプロパティについて、現在の値と、現在の値が
StateReportリクエストからのものか、あるいはChangeReportなどのプロアクティブな状態の更新によるものかを確認できます。 -
スマートホームデバッガー – Alexaがスキルから受け取る
ChangeReport、AddOrUpdateReport、DeleteReportといったイベントを確認できます。JSONや処理エラーも含まれます。 -
WebRTCスキル向けスマートホームデバッガー – AlexaスキルにAlexa.RTCSessionControllerインターフェースを実装する場合、スマートホームデバッガーを使ってWebRTCセッションのログをリアルタイムで確認できます。
-
スマートホームテストツール – スキルにディレクティブを送信し、状態が正しく設定されているかを確認するテストを自動化できます。最も一般的なAlexa機能インターフェースで利用できます。
-
Alexaシミュレーター – Alexa開発者コンソールでAlexaシミュレーターを使うことで、デバイスを使わずにスキルをテストできます。
-
スマートホームスキル評価REST APIリファレンス – スマートホームスキル評価REST APIを使用すると、プログラムで評価を開始し、評価の結果を取得できます。
-
Alexa Skills Kit（ASK）コマンドラインインターフェース（CLI） –
create-smarthome-capability-evaluationコマンドを使用することで、機能評価を作成して開始できます。
最小コンフィギュレーションの確認
スキルのエンドツーエンドのフローをテストするには、スマートホームスキルの最小コンフィギュレーションを完了する必要があります。開発者コンソールのビルドページの左側のナビゲーションを使用して、設定項目に移動します。
- スマートホームでは、スマートホームスキルに次の項目を定義する必要があります。
- バージョンv3のスマートホームAPI
- 有効なAWS Lambda ARNサービスエンドポイント
スマートホームスキルには、複数のモデルを含めることができます。カスタムモデルとスマートホームモデルのエンドポイントを指定します。
- アカウントリンクで、必須フィールドを設定します。
- スキルが
ChangeReportなどのイベントをサポートする場合は、アクセス権限で、Alexaイベントを送るを有効にします。
スキルをテストして公開するには、デバイス制御クラウド用に設定したアカウントと、そのアカウントで検出可能なデバイスが必要です。
スキルコードをデプロイする
開発者コンソールでスキルの最小コンフィギュレーションを確認したら、スキルコードLambda関数をデプロイします。詳細については、Lambda関数を追加するを参照してください。
必ずスキルの言語とロケールに関連付けられたAWSリージョンでLambda関数をデプロイしてください。そうしないと、デバイスの検出が、スキルのある言語バージョンでは成功しても、別の言語では失敗する可能性があります。詳細については、Lambda関数を複数のリージョンにデプロイするを参照してください。
開発者コンソールでスキルを有効にする
開発者コンソールでスキルをテスト用に有効にするのステップを完了します。
Alexaアプリでスキルを有効にする
iOSまたはAndroidモバイルデバイスにインストールされたAlexaアプリでスキルを有効にするには、次の手順を実行します。
スキルを有効にしてデバイスを検出するには
- 開発者アカウントと同じ認証情報を使用してAlexaアプリにサインインします。
- Alexaアプリでスキルを見つけるには、その他をタップし、スキル・ゲームをタップします。
- スキル・ゲームで、有効なスキルをタップします。
- スキルの種類を右にスクロールし、開発をタップします。
- スクロールしてスキルを見つけます。
- スキル名をタップし、有効にして使用するをタップします。
- 画面の指示に従って、デバイス制御クラウドアカウントの認証情報を入力します。
- スキルへのアクセスを許可するには、権限の内容を確認し、アクセス権限を保存をタップします。
注： アカウントリンクを完了できない場合、デバイス制御クラウドアカウントの有効な認証情報を使用していることを確認します。それでも完了できない場合、開発者コンソールで提供したアカウントリンク情報に問題がある可能性があります。アカウントリンクの問題については、アカウントリンクのトラブルシューティングを参照してください。
- スキルが有効になり、リンクされると、Alexaはコネクテッドデバイスに関する情報を取得するために、
Discoverリクエストをスキルに送信します。スキルは、デバイスの詳細情報と共に検出応答を返します。 - Alexaがデバイスを検出できない場合は、Lambda関数のログを確認してください。ログを使用して問題を解決します。よくある問題としては、検出応答が正しい形式でないなどがあります。
アカウントリンクの設定や検出応答を変更する場合は、スキルでスキルを無効にします。
関連トピック
- ファイアウォールの背後からスキルをテストする
- Alexa開発者コンソールを使用してスキルをテストする
- Alexaスキルのベータテストを行う
- スキルストアに公開する詳細を定義する
- スマートホームスキルの作成手順
- Works with Alexa認定の概要
最終更新日: 2024 年 12 月 19 日