カスタムスキルの機能テスト

---

機能テストでは次のことを検証します。

• スキルの基本機能がAmazon Alexaアプリのスキルの詳細カードに表示される情報と一致していること。このデータは、開発者コンソールのスキルの公開ページで入力します。

  このカードの定義についての詳細は、スキルストアの詳細と公開範囲を定義するを参照してください。

• スキルの主な機能が正常に動作し、Amazon Alexaアプリに有効なカードが表示されること。

このテストでは、Amazon Alexaアプリを使用します。Alexaアプリは、Fire OS、Android、iOS、およびウェブブラウザで使用できます。Alexaアプリには、公開中のスキルだけでなく、現在開発中のスキルもすべて表示されます。

テストの概要チェックリストを確認するには、カスタムスキルの認定要件を参照してください。

3.1.サンプルフレーズの確認とテスト

サンプルフレーズは、ユーザーがスキルとの対話方法を理解できるよう、Alexaアプリのスキルの詳細ページに表示されます。確実にスキルを呼び出せるよう、サンプルフレーズはサンプル発話の中から選択します。

ユーザーがスキルと初めて対話するときに最も言う可能性が高いフレーズがサンプルフレーズです。このため、これらのフレーズが適切に機能し、良好な結果が得られることを確認します。

公開ページでサンプルフレーズを入力すると、いくつかの基準に基づいて自動で検証が行われます。エラーや警告が出た場合には、修正を行ってから申請します。この検証は起こりうる問題すべてを確認するものではないため、下記のテストも実施します。

	テスト	想定される結果
1.	Alexaアプリを開いてスキルをクリックし、スクロールまたは検索してスキルを選択します。 スキルの詳細ページを確認します。スキルの詳細ページに記載されているすべてのサンプルフレーズをチェックします。	サンプルフレーズが少なくとも1つ表示されています。 最初のフレーズにスキルの使用を開始する方法が明確に示されており、ウェイクワード「アレクサ」と呼び出し名の両方が含まれています。 ウェイクワード「アレクサ」と呼び出し名を含むサンプルフレーズは、スキルの呼び出しでサポートされている形式に従っている必要があります。サポートされる形式の一覧については、ユーザーによるカスタムスキルの呼び出しを参照してください。 サンプルフレーズに、ユーザーが言う必要のない余分な情報は含まれていません。サンプルフレーズは、記載のとおりに機能する必要があります。 呼び出し名が2語以上で構成されています。 サンプルフレーズに絵文字や記号が含まれておらず、文法の間違いもありません。 サンプルフレーズがすべて句点で終わっています。 サンプルフレーズはスキルの起動方法を示しています。このフレーズは、音声でスキルを有効にする方法を示していません。たとえば、「アレクサ、＜スキル名＞を有効にして」のようなフレーズは認められません。 サンプルフレーズはすべて、Alexaアカウントで使用するのと同じ言語で記載されています。たとえば、日本語に設定したアカウントでは、フレーズが日本語で記載されている必要があります。
2.	開発者コンソールを使用してスキルを編集します。サンプル発話はインテントで定義します。インテントをクリックして発話を確認し、選択したサンプルフレーズが既存のサンプル発話と一致しているか検証します。 サンプルフレーズの定義についての詳細は、スキルストアの詳細と公開範囲を定義する： カスタムスキルのサンプルフレーズを参照してください。 サンプルフレーズにビルトインインテントの発話を使用する場合は、その発話をサンプル発話に含める必要はありません。ただし、発話は十分にテストし、スキルが有効な応答を返すことを確認します。	すべてのサンプルフレーズがサンプル発話に明確に含まれています。 たとえば、次のようなサンプルフレーズがあるとします。 アレクサ、潮汐情報にシアトルの満潮はいつか聞いて。 この場合、次のような発話が必要になります。 OneshotTideIntent {City}の満潮はいつ サンプルフレーズのすべてのスロット（この例ではシアトル）に、有効なスロット値の例が入力されている必要があります。この例では、Cityはカスタムスロットタイプであり、「シアトル」がこのCityタイプに対して明確に定義された値となります。
3.	作成したサンプルフレーズのそれぞれを使用してスキルを起動します。	すべてのサンプルフレーズで、エラーがなく文脈に合った応答が返されます。

3.2.スキルの説明と詳細のページ

スキルの説明は、ユーザーにスキルの機能と使用方法を伝えるためのものです。ユーザーが利用可能なスキルを表示すると、この説明がAlexaアプリの「このスキルについて」に表示されます。公開ページで詳細を定義します。

• アラビア語（SA）
• 英語（すべて）
• フランス語（すべて）
• ドイツ語（DE）
• ヒンディー語（IN）
• イタリア語（IT）
• 日本語（JP）
• ポルトガル語（BR）
• スペイン語（すべて）

3.3.カード

カードはAlexaアプリに表示されるカードで、対話の内容または対話をより充実させるための情報を提供します。

	テスト	想定される結果
1.	各インテントを呼び出し、スキルの機能を実際にテストします。カードが含まれる応答ごとに、Alexaアプリでホームカードを確認します。（Alexaアプリを開いてアクティビティページに移動します。）	各カードで以下を確認します。 カードのタイトルと内容がスキルの機能に合っています。 カードのタイトルと内容にコードが記載されておらず、文法の間違いがありません。 カードタイトルとコンテンツがAlexaでサポートされている言語で書かれています。 カードに画像が含まれる場合、その画像が正常に表示されています。
2.	URLの記載されたカードがある場合、ブラウザで各URLにアクセスし、ページが問題なく表示されることを確認します。	カードに表示されるすべてのURLが次を満たしていることを確認します。 ブラウザでページが問題なく表示されます。 ページがAlexaでサポートされている言語で表示されています。

通常、スキルがユーザーのリクエストした情報を応答で返す際、カードのみを返すことに注意してください。ユーザーに追加情報を求める補助的なプロンプトには、カードは通常含まれません。

カードはスキルの開発およびデバッグに役立つツールですが、スキルの申請前に不要なデバッグ用のカードがあれば必ず削除します。

3.4.アカウントリンク

このテストでは、スキルでエンドユーザーのIDと別のシステムのユーザーとの関連付け（アカウントリンク）が必要な場合に、カスタムスキルのアカウントリンクの説明にあるソリューションがスキルに適切に実装されていることを確認します。概要レベルでは、これは以下のことを意味します。

• ユーザーが認可の必要なインテントを呼び出すと、スキルは正常に認証を行い、リクエストを完了します。
• ユーザーが認可の必要なインテントを呼び出したがアカウントがまだリンクされていない場合、スキルはLinkAccountカードに戻ります。

認定を申請する前にテスト用認証情報でスキルをリンクする

スキルの認定を申請する際、自動の検証で認定の際によくある問題がないかチェックします。スキルがこれらのテストに合格できるように、申請の前にAmazon開発者アカウントを使ってほかのシステムのテストアカウントにスキルをリンクします。

1. ほかのシステムで、スキルに使うテストアカウントを作成してください。たとえば、スキルが「タクシー予約」サービスに接続する場合、タクシー予約のテストアカウントが必要です。認定チームとこのアカウントの認証情報を共有する必要があるため、必ずテストアカウントを使用するようにしてください。

2. Alexaアプリにスキルの作成に使ったAmazon開発者アカウントでログインします。

   重要： このステップではAmazon開発者アカウントを使用する必要があります。
3. Alexaアプリでスキルを有効にして、アカウントリンクフローを開始しします。
4. ステップ1のテストアカウントを使って、アカウントリンクフローを完了します。前の例を続行し、テスト用認証情報を使って「タクシー予約」にスキルをリンクします。
5. スキルがほかのサービスに正常にリンクされることをテストします。これで、Amazon開発者アカウントがほかのサービスのテストアカウントに接続されました。
6. スキルの認定を申請する際、テスト手順の説明フィールドにテストアカウントの認証情報（アカウントとパスワード）を入力します。

スキルでアカウントリンクを使用しない場合、このテストは省略できます。

	テスト	想定される結果
1.	開発者コンソールでスキルのアカウントリンクページを開き、アカウントリンクが適切に設定されていることを確認します。	ユーザーがアカウントや既存アカウントへのリンクを作成することを許可しますか？オプションが有効です。 認証画面のURIがリンク先のサービスのログインページに設定されています。
2.	Alexaアプリで、スキルの詳細ページを確認します。スキルの説明に、スキルを使用するには別のシステムへのログインが必要であると明記されていることを確認します。	説明に、アカウントを関連付けるために必要な手順と情報が明記されています。
3.	スキルをまだ有効にしていないAlexaユーザーとしてAlexaアプリにログインするか、ログイン後にスキルを無効にします。 スキルを有効にします。ただし、アカウントリンクは行わず、スキルがリンクされないままにしておきます。 認証が不要なインテントを呼び出して、正常に動作することを確認します。 認証の必要なインテントを呼び出し、スキルがLinkAccountカードと適切なプロンプトを送信することを確認します。	認証の不要なすべてのインテントが、アカウントがリンクされていない状態でも正常に動作します。 認証の必要なすべてのインテントで、音声でユーザーに必要な操作が説明され、LinkAccountカードが返されます。Alexaアプリでカードを確認します。
4.	スキルを無効にするか、スキルをまだ有効にしていないAlexaユーザーとしてAlexaアプリにログインします。 スキルを有効にします。スキルのログインページが表示されたら、すべてのリンクをクリックし、各リンクで新しいページが表示されることを確認します。	ログインページのクリック可能なすべてのリンクで、新しいページが表示されます。 リンクをクリックしても、JavaScriptの警告やポップアップウィンドウが表示されません。
5.	スキルを無効にするか、スキルをまだ有効にしていないAlexaユーザーとしてAlexaアプリにログインします。 スキルを有効にします。スキルのログインページが表示されたらログインし、アカウントリンクの手順を確認します。	スキルのログインページが正常に表示されます。 サービスのアカウントを使用して正常にログインできます。 アカウントへの接続後、認証が必要なインテントを正常に呼び出すことができます。

3.5.オーディオ再生

スキルでAudioPlayerインターフェースを使用して音声をストリーミングしている場合は、以下のテストを行います。

• アラビア語（SA）
• 英語（すべて）
• フランス語（すべて）
• ドイツ語（DE）
• ヒンディー語（IN）
• イタリア語（IT）
• 日本語（JP）
• ポルトガル語（BR）
• スペイン語（すべて）

3.6 画面表示とナビゲーション

スキルでAlexa Presentation Languageまたは廃止されたDisplayインターフェースを使用して画面付きのAlexa搭載デバイスにコンテンツを表示する場合は、次のテストを行います。スキルの音声、タッチ、オーディオ、ビデオによる対話に特に注意します。

	テスト	想定される結果
1.	画面付きのAlexa搭載デバイスを使用してスキルを開き、ユーザーエクスペリエンスに特に注意しながら数分間スキルと対話します。	静的なテンプレート形式とビデオ形式のどちらの場合でも、GUIコンテンツはすべて、トリガーとなる音声またはタッチ入力から10秒以内にロードされる必要があります。 GUIコンテンツ（画像およびビデオ）が引き伸ばされておらず、不鮮明でなく、ピクセル化されていません。 GUIコンテンツの内容は、GUIコンテンツとともに提供される音声コンテンツ（テキスト読み上げまたはオーディオ）と矛盾していない必要があります。GUIコンテンツは音声コンテンツと厳密に一致していなくてもかまいませんが、音声コンテンツを補足するものである必要があります。 すべてのGUIコンテンツが、トリガーとなる音声またはタッチ入力に関連している必要があります。 画面にリストを表示しない場合、GUIコンテンツに含まれる1画面あたりのアクションは2つ以下にする必要があります。 また、GUIに表示されるアクションはすべて音声リクエストでアクセスできる必要があります。つまり、アクションはインテントとして実装され、言語モデルの対応するサンプル発話が設定されている必要があります。
2.	Echo ShowまたはFire TV Cubeの場合、デバイスを2メートル離れた場所に置きます。数分間にわたりスキルと対話します。	Echo ShowまたはFire TV Cubeの場合、すべてのGUIコンテンツを2メートルの距離から判読できる必要があります。
3.	画面にタッチ画面入力が表示されている状態で、「停止」または「キャンセル」と言いスキルを終了します。	スキルの終了後、タッチ入力が表示されなくなります。

3.7.ビデオ再生

スキルでVideoAppインターフェースを使用してビデオをストリーミングする場合は、ビデオにも適用される一部の画面表示要件に加えて、以下のテストも実施します。

	テスト	想定される結果
1.	デバイスの音量を3に設定し、ビデオをストリーミングするインテントを呼び出します。音声を数分間聞きます。	音量レベル3でビデオ再生を聞き取ることができます。 オーディオ再生の音量が、Alexaの通常の読み上げとほとんど変わりません。数分間の再生の間、音量は一定です。 オーディオコンテンツに語句や音声が含まれる場合、コンテンツがAlexaでサポートされている言語で再生されます。現在サポートされている言語は英語、日本語、フランス語、ドイツ語です。 ビデオ再生時のバッファリング時間は、ビデオの総再生時間の10%以下である必要があります。たとえば、1分間のビデオ再生では、バッファリングが6秒を超えてはいけません。 ビデオ再生中に、オーディオとビデオが同期されている必要があります。 ビデオが鮮明であり、画質が荒かったり、ピクセル化していたり、ノイズが含まれたりしていません。
2.	ビデオの再生中に、タッチ画面の進行バーを使用して前後に移動します。	ビデオが問題なく再生されることを確認します。

3.8.サンプルやテンプレートの複製

スキルが、Amazonの提供するサンプルおよびテンプレートをそのまま複製したものでないことを確認します。サンプルとテンプレートをスキルのひな形として使用することは認められていますが、完成したスキルは別物である必要があります。

たとえば、Triviaサンプルを使用してトリビアスキルを作成する場合、スキルは次の要件を満たしている必要があります。

• 別の名前
• 別の質問セット

サンプルやテンプレートはGitHubで入手できます。

• Javascript/Node.js： Alexa organization（英語のみ）
• Java：amzn/alexa-skills-kit-java

3.9 デバイス位置情報API

スキルでDevice Settings APIを使用してユーザーデバイスの位置情報を取得する場合は、次のテストを行います。

	テスト	想定される結果
1.	スキルを有効化し、要求されたデバイスの位置情報に関するアクセス権限をスキルに付与します。デバイスの位置情報を使用する機能をテストして、応答を確認します。	スキルの応答がすべて、デバイスの位置情報に対応しています。たとえば、デバイスの位置情報を使用する天気予報スキルでは、デバイスの位置情報で指定された都市の天気情報が提供される必要があります（ユーザーが発話で別の場所を指定した場合を除く）。 スキルがユーザーにデバイスの位置情報を返す場合、その情報が指定したデバイスの位置に一致しています。
2.	デバイスの位置情報に関する権限を与えずに、スキルを有効にします。 位置情報が不要なインテントを呼び出して、正常に動作することを確認します。 位置情報が必要なインテントを呼び出して、応答を確認します。	デバイスの位置情報の不要なインテントすべてが、位置情報の権限を付与しなくても正常に動作します。 デバイスの位置情報が必要なインテントすべてで、権限を付与するように求める音声と権限カードが返されます。Alexaアプリでカードを確認します。
3.	必要に応じて、デバイスの位置をスキルが対応していない場所またはアドレスに変更し、スキルを有効にしてアクセス権限を付与します。デバイスの位置情報が必要なインテントを呼び出します。 たとえば、デバイスで特定の都市でのフードデリバリーを提供する場合は、デバイスの位置を配達エリア外のアドレスに設定して、デリバリーを注文するインテントを呼び出します。	スキルが、その場所に対応していないことを通知します。エラーは返されません。

3.11 スキルのテスト

認定申請を行うAlexaスキルは、テスト版、試用版、サンプル、開発中のスキルのいずれでもなく、フル機能を備えたスキルである必要があります。開発者コンソールの公開セクションの最新情報に、スキルが試用版やサンプルスキルであると書かれていないことを確認します。スキルのテストの詳細については、スキルのテストを参照してください。

3.12 Customer Profile API

スキルでAlexa Customer Profile APIを使用してユーザーの連絡先情報を取得する場合は、次のテストを行います。

スキルがCustomer Profile APIを使用しない場合、この権限が無効になっていることを確認します。

1. 開発者コンソールを使用して、スキルを編集します。
2. ビルド＞アクセス権限ページに移動します。
3. 各項目をオフにします。
   • ユーザーのEメールアドレス
   • 電話番号
   • ユーザー名

	テスト	想定される結果
1.	スキルを有効にして、ユーザー名、ユーザーのEメールアドレス、電話番号などリクエストされた権限をスキルに付与します。ユーザーの連絡先情報を使用する機能をテストして、応答を確認します。	スキルの応答がすべて、ユーザーの連絡先情報に対応しています。たとえば、リクエストされた天気情報が正しいEメールアドレスに送信されています。（スキル内で必要な権限に基づきます。）
2.	ユーザーの連絡先情報に関する権限を与えずに、スキルを有効にします。 ユーザー連絡先情報が不要なインテントを呼び出して、正常に動作することを確認します。 ユーザーの連絡先情報が必要なインテントを呼び出して、応答を確認します。	ユーザーの連絡先情報権限の不要なインテントすべてが、連絡先情報の権限を付与しなくても正常に動作します。 ユーザーの連絡先情報権限が必要なインテントすべてで、権限を付与するように求める音声と権限カードが返されます。Alexaアプリでカードを確認します。 たとえば、スキルが「<ユーザーのリクエスト>を完了するには、<skill_name>がEメールアドレスにアクセスする必要があります。続行するにはAlexaアプリのホーム画面でスキルに権限を付与してください。」と読み上げます。
3.	ユーザーの連絡先情報を変更してから、スキルを有効にして権限を付与します。ユーザーの連絡先情報の権限が必要なインテントを呼び出します。	スキルの応答がすべて、更新されたユーザーの連絡先情報に対応しており、エラーメッセージが一切返されません。

関連トピック

• ポリシーテスト
• セキュリティテスト
• 音声インターフェースとユーザーエクスペリエンスのテスト
• スキルをテストして認定を申請する
• カスタムスキルのビルド手順

---

---

最終更新日: 2022 年 01 月 19 日