From 8d4f17b821fffa33939a3eb25cfe970c88d15363 Mon Sep 17 00:00:00 2001 From: jp-96 Date: Thu, 12 Apr 2018 23:11:08 +0900 Subject: [PATCH 1/9] Update README.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先を修正 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 446c5b4..ca04962 100644 --- a/README.md +++ b/README.md @@ -7,13 +7,13 @@ 初めてここに訪れ、これからAlexaのスキル開発に取り組もうとする方や、より詳細なガイダンスが必要な方は、下の「Get started!」ボタンをクリックしてください。 - + 下記の追加のリソースにも必ず目を通してください。 ##概要 -**補足**:このReadmeは、すでに利用を開始できる開発環境があり、CLI(コマンドラインインターフェース)ツールや、[AWS](https://aws.amazon.com/jp/)、[ASK開発者ポータル](https://developer.amazon.com/ja/alexa)の使用経験のある方を想定しています。もし該当しない場合は、[こちら](instruction/0-intro.md)をクリックしてより詳細なチュートリアルから始めてください。 +**補足**:このReadmeは、すでに利用を開始できる開発環境があり、CLI(コマンドラインインターフェース)ツールや、[AWS](https://aws.amazon.com/jp/)、[ASK開発者ポータル](https://developer.amazon.com/ja/alexa)の使用経験のある方を想定しています。もし該当しない場合は、[こちら](instructions/0-intro.md)をクリックしてより詳細なチュートリアルから始めてください。 ### 使い方 From 082660b5a4c9e9a09261b1456d3e63b60cdabdb8 Mon Sep 17 00:00:00 2001 From: jp-96 Date: Thu, 12 Apr 2018 23:17:26 +0900 Subject: [PATCH 2/9] Update 1-voice-user-interface.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 --- instructions/1-voice-user-interface.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/instructions/1-voice-user-interface.md b/instructions/1-voice-user-interface.md index 346d0c5..c542d70 100644 --- a/instructions/1-voice-user-interface.md +++ b/instructions/1-voice-user-interface.md @@ -56,7 +56,7 @@ Alexaスキルは２つの部分からできています。一つは [音声ユ 8. スキルビルダーの左上にある **Dashboard** の下の「Code Editor」をクリックします。 -9. 表示されたテキストフィールドで、[Interaction Model](../InteractionModel.json) が提供するコードに既存のコードを置き換えて、「Apply Changes」または「Save Model」をクリックします。 +9. 表示されたテキストフィールドで、[Interaction Model](../models/ja-JP.json) が提供するコードに既存のコードを置き換えて、「Apply Changes」または「Save Model」をクリックします。 10. **Save Model** ボタンをクリックしてから、 **Build Model** ボタンをクリックします。 From 16164f3fabeefc36655c9eade138bac889a08d03 Mon Sep 17 00:00:00 2001 From: jp-96 Date: Thu, 12 Apr 2018 23:51:09 +0900 Subject: [PATCH 3/9] Update 2-lambda-function.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 --- instructions/2-lambda-function.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/instructions/2-lambda-function.md b/instructions/2-lambda-function.md index 6e6b37d..c0169f2 100644 --- a/instructions/2-lambda-function.md +++ b/instructions/2-lambda-function.md @@ -36,7 +36,7 @@ ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/2-7-configure-your-function._TTH_.png) -8. **Lambda関数用のロールを設定します。** ロールがまだない場合は、[初めてLambda用ロールを作成する場合の手順](../lambda-role.md)を参考に作ってください。この手順に沿って作成したロールが既にある場合は、**既存のロール** の値を「lambda\_basic\_execution」に設定してください。 +8.  **Lambda関数用のロールを設定します。** ロールがまだない場合は、[初めてLambda用ロールを作成する場合の手順(英語)](https://github.com/alexa/alexa-cookbook/tree/master/aws/lambda-role.md)を参考に作ってください。この手順に沿って作成したロールが既にある場合は、**既存のロール** の値を「lambda\_basic\_execution」に設定してください。 ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/2-9-lambda-function-role._TTH_.png) @@ -56,10 +56,10 @@ ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/2-11-1-select-lamda._TTH_.png) -12. **Lambda関数コード**のコード編集ボックスに、 [提供されたコード](../lambda/index.js) を**コピー＆ペースト**してください。このソースコードは、[GitHub](../lambda/index.js)にあります。 +12.  **Lambda関数コード**のコード編集ボックスに、 [提供されたコード](../lambda/custom/index.js) を**コピー＆ペースト**してください。このソースコードは、[GitHub](../lambda/custom/index.js)にあります。 ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/2-12-copy-lambda-code._TTH_.png) - + 13. 今回はその他の項目は設定する必要はありません。画面右上の **保存** ボタンをクリックしてください。 ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/2-10-save-button._TTH_.png) From 024da0737974c0679c7edd7fc7e390240abf945b Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 00:03:04 +0900 Subject: [PATCH 4/9] Update 4-testing.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 --- instructions/4-testing.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/instructions/4-testing.md b/instructions/4-testing.md index 46defcc..1d3a8bc 100644 --- a/instructions/4-testing.md +++ b/instructions/4-testing.md @@ -3,9 +3,9 @@ ## Alexaスキルのテスト -ここまでで、私たちは[音声ユーザーインターフェース](1-voice-user-interface.md)と[Lambda関数](2-lambda-function.md)を作成し、 [それらを接続](3-connect-vui-to-lambda.md)しました。 これであなたのスキルをテストする準備が整いました。 +ここまでで、私たちは[音声ユーザーインターフェース](1-voice-user-interface.md)と[Lambda関数](2-lambda-function.md)を作成し、 [それらを接続](3-connect-vui-to-code.md)しました。 これであなたのスキルをテストする準備が整いました。 -1. **[Amazon開発者ポータル](https://developer.amazon.com/edw/home.html#/skills/list)**に戻り、あなたが作ったスキルを一覧から選択します。このチュートリアルを冒頭から始めていれば、ブラウザーのタブに残っていることでしょう。 +1. **[Amazon開発者ポータル](https://developer.amazon.com/edw/home.html#/skills/list)** に戻り、あなたが作ったスキルを一覧から選択します。このチュートリアルを冒頭から始めていれば、ブラウザーのタブに残っていることでしょう。 2. 左側にある**「テスト」**タブを開きます。 @@ -77,7 +77,7 @@ 2. **その他のテスト方法の検討** * [Echosim.io](https://echosim.io) はブラウザベースのAlexaスキルテストツールです。物理デバイスを持ち運ぶことなくどこでも使えるので、手軽にスキルをテストできます。 - * [Unit Testing with Alexa](../unit-testing.md) は [Postman](http://getpostman.com) と [Amazon API Gateway](http://aws.amazon.com/apigateway) を使用したモダンなユニットテストのアプローチです. +    *  [Unit Testing with Alexa(英語)](https://github.com/alexa/alexa-cookbook/tree/master/testing/postman/README.md) は [Postman](http://getpostman.com) と [Amazon API Gateway](http://aws.amazon.com/apigateway) を使用したモダンなユニットテストのアプローチです. 7. サンプルスキルが正常に動作することを確認できたら、このスキルを**カスタマイズ**しましょう。 From b5ae24f2315914eefc04f12d0233c4c2edcc550b Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 00:07:28 +0900 Subject: [PATCH 5/9] Update 4-testing.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 箇条書きの修正 --- instructions/4-testing.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/instructions/4-testing.md b/instructions/4-testing.md index 1d3a8bc..78d4cd7 100644 --- a/instructions/4-testing.md +++ b/instructions/4-testing.md @@ -77,7 +77,8 @@ 2. **その他のテスト方法の検討** * [Echosim.io](https://echosim.io) はブラウザベースのAlexaスキルテストツールです。物理デバイスを持ち運ぶことなくどこでも使えるので、手軽にスキルをテストできます。 -    *  [Unit Testing with Alexa(英語)](https://github.com/alexa/alexa-cookbook/tree/master/testing/postman/README.md) は [Postman](http://getpostman.com) と [Amazon API Gateway](http://aws.amazon.com/apigateway) を使用したモダンなユニットテストのアプローチです. + * [Unit Testing with Alexa](https://github.com/alexa/alexa-cookbook/tree/master/testing/postman/README.md) は [Postman](http://getpostman.com) と [Amazon API Gateway](http://aws.amazon.com/apigateway) を使用したモダンなユニットテストのアプローチです. + 7. サンプルスキルが正常に動作することを確認できたら、このスキルを**カスタマイズ**しましょう。 From cbe63436f8dd12874de9c8d7744b0334972c19d2 Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 01:00:50 +0900 Subject: [PATCH 6/9] Update 5-customization.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 段落の修正 --- instructions/5-customization.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/instructions/5-customization.md b/instructions/5-customization.md index 4594ce4..cd62645 100644 --- a/instructions/5-customization.md +++ b/instructions/5-customization.md @@ -9,7 +9,7 @@ 1. **新しいデータ** 日本の47都道府県**以外の**新しいクイズ用のデータセットを作成してください。ネタ探しには、[Wikipedia 一覧の一覧](https://ja.wikipedia.org/wiki/%E4%B8%80%E8%A6%A7%E3%81%AE%E4%B8%80%E8%A6%A7) などが参考になるでしょう。 - 1. **index.jsのコピーを開きます。** まだコードをダウンロードしていない場合は、[GitHubからダウンロードできます。](../src/index.js). [Atom](http://atom.io)、[Sublime Text](http://sublimetext.com)、[VSCode](http://code.visualstudio.com) などのシンプルで軽量なエディタでコードを修正することもできますが、Lambda関数をブラウザ画面上で直接編集することもできます。 + 1. **index.jsのコピーを開きます。** まだコードをダウンロードしていない場合は、[GitHubからダウンロードできます。](../lambda/custom/index.js). [Atom](http://atom.io)、[Sublime Text](http://sublimetext.com)、[VSCode](http://code.visualstudio.com) などのシンプルで軽量なエディタでコードを修正することもできますが、Lambda関数をブラウザ画面上で直接編集することもできます。 2. **「TODO: このデータをあなたのものと置き換えてください。」 というコメントを検索してください。** これがスキルのデータ部分です。各行が **PrefectureName** 、 **Romanization** 、 **PrefecturalOfficeLocation** 、 **PrefectureFlower** 、 **PrefectureOrder** という5個の値からなるデータセットであることがわかります。 @@ -17,7 +17,7 @@ * [ビデオゲーム](../data/videogames.js) * [書籍](../data/books.js) - * [都道府県](,,/data/prefectures.js) + * [都道府県](../data/prefectures.js) * [徳川将軍](../data/monarchs.js) 3. **ビルトインスロットの値を使うことを検討してください。** Amazonが提供するビルトインスロットの値からデータを抽出することをお勧めします。ビルトインスロットを使ったとしてもデータセット全体を構築する必要がありますが、ビルトインスロットの値を使用することで、次のいくつかのステップの作業が簡単になります。いくつかの例を次に示しますが、[ビルトインスロットの値の一覧はこちら](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference#list-types) です。 @@ -29,12 +29,12 @@ | AMAZON.FirstName | 日本語を話すユーザーが一般的に使用する数千個の名前。このスロットタイプは、拡張して、値を追加することができます。| アオイ（葵）
カナ（佳奈）
ソウタ（壮太）
ハルカ（遥河）
ユウト（湧人）|日本語|利用可能| |AMAZON.Region|日本語を話すユーザーが一般的に使用する都道府県や郡を認識します。このスロットタイプは、拡張して、値を追加することができます。| 京都府
北海道
南魚沼郡
東京都
福岡県 | 日本語 | 利用可能 | - 4. オリジナルのデータを用意したら、次に進む前に覚えておいたほうがよいヒントをいくつか紹介します。 + 4. オリジナルのデータを用意したら、次に進む前に覚えておいたほうがよいヒントをいくつか紹介します。 - * **Alexaはデータのプロパティ名を読むので、各プロパティ名が質問の中で読まれるようにしてください。** これらの名前はAlexaアプリの **カード** でも使われますので、各単語の最初の文字、または各単語を大文字にする必要があります。スキルは自動的に単語を区切り、必要に応じてスペースを追加します。 - * **各項目の最初のプロパティは、通常、質問に使用されます。** たとえば、日本の都道府県のデータでは、ほとんどの質問が「神奈川県の県庁所在地は何ですか?」のような形をとります。「県庁所在地 (PrefecturalOfficeLocation)」はプロパティ名からきています。そして、「神奈川県 (PrefectureName)」が最初のプロパティでした（これは、オリジナルのスキルのためにカスタマイズできます）。そうでなければ、順序はまったく重要ではありません。 + * **Alexaはデータのプロパティ名を読むので、各プロパティ名が質問の中で読まれるようにしてください。** これらの名前はAlexaアプリの **カード** でも使われますので、各単語の最初の文字、または各単語を大文字にする必要があります。スキルは自動的に単語を区切り、必要に応じてスペースを追加します。 + * **各項目の最初のプロパティは、通常、質問に使用されます。** たとえば、日本の都道府県のデータでは、ほとんどの質問が「神奈川県の県庁所在地は何ですか?」のような形をとります。「県庁所在地 (PrefecturalOfficeLocation)」はプロパティ名からきています。そして、「神奈川県 (PrefectureName)」が最初のプロパティでした（これは、オリジナルのスキルのためにカスタマイズできます）。そうでなければ、順序はまったく重要ではありません。 - 5. **index.jsのデータを置き換えたら、ファイルの内容をLambda関数にコピーします。** テキストをコピーペーストするだけなので、とても簡単です。 + 5. **index.jsのデータを置き換えたら、ファイルの内容をLambda関数にコピーします。** テキストをコピーペーストするだけなので、とても簡単です。 2. **AnswerIntentのための新しい対話モデル。** データを変更した場合、ユーザーから受け取るデータのタイプも変更しなければなりません。 @@ -42,9 +42,9 @@ ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/5-2-1-interaction-model._TTH_.png) - 2. **インテントスキーマのAnswerIntentのスロット値を更新します。** [オリジナルのインテントスキーマ](../speech-assets/intent-schema.json) では、データの各プロパティのスロットを定義して、スロットにはデータのプロパティと完全に同じ名前をつけていました。あなたのオリジナルのインテントスキーマでも同じことをする必要があります。 + 2. **インテントスキーマのAnswerIntentのスロット値を更新します。** オリジナルのインテントスキーマでは、データの各プロパティのスロットを定義して、スロットにはデータのプロパティと完全に同じ名前をつけていました。あなたのオリジナルのインテントスキーマでも同じことをする必要があります。 - ### インテントスキーマのヒント + ### インテントスキーマのヒント * **用意したデータのすべてのプロパティに対応するスロットがあることを確認してください。** * **できる限りビルトインスロットの値を使用してください。** これが一般的に簡単な方法ですが、カスタムスロットが必要な場合は[簡単に作ることができます](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/alexa-skills-kit-interaction-model-reference#custom-slot-syntax)。都道府県クイズでは、都道府県のローマ字表記と県の花のために、2個のカスタムスロットを作成しました。 @@ -53,17 +53,17 @@ 4. **サンプル発話を更新します。** 作成したデータタイプごとに、AnswerIntentのためのサンプル発話が必要でます。元のデータに代わるオリジナルのデータ構造を表現するために、この発話のリストを更新する必要があります。 - * **英語以外の言語でこのスキルを作成している場合は、サンプル発話を英語ではなくその言語で記述する必要があることに留意してください。 + * **英語以外の言語でこのスキルを作成している場合は、サンプル発話を英語ではなくその言語で記述する必要があることに留意してください。** - 5. 完了したら **「Save Model」** ボタンと**「Build Model」ボタン**を順にクリックします。 + 5. 完了したら **「Save Model」** ボタンと **「Build Model」** ボタンを順にクリックします。 3. **ユーザーへの応答文** いくつかの文章と応答は、あなたのスキル用にカスタマイズしたほうがよいでしょう。 - 1. **[index.js]((../lambda/src/index.js))** のコピーに戻ります。 + 1. **[index.js](../lambda/custom/index.js)** のコピーに戻ります。 - 2. **「TODO: このコメント以下の項目に注意してください。」** というコメント行を探してください。そこがカスタマイズするべきセクションの最初の箇所です。すべてをドキュメント化する代わりに、カスタマイズする部分の目的を理解する助けになるように [index.js]((../lambda/src/index.js)) にコメントを残しました。 + 2. **「TODO: このコメント以下の項目に注意してください。」** というコメント行を探してください。そこがカスタマイズするべきセクションの最初の箇所です。すべてをドキュメント化する代わりに、カスタマイズする部分の目的を理解する助けになるように [index.js]((../lambda/custom/index.js)) にコメントを残しました。 3. **index.js** をファイルの下の方まで読むと、どの部分を変更すべきかおよそ察しがつくでしょう。 From aeaa21ea7bdd01df0d77d52c81ce4f6c0155cdcd Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 01:01:57 +0900 Subject: [PATCH 7/9] Update 5-customization.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 --- instructions/5-customization.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/instructions/5-customization.md b/instructions/5-customization.md index cd62645..0397e9a 100644 --- a/instructions/5-customization.md +++ b/instructions/5-customization.md @@ -63,7 +63,7 @@ 1. **[index.js](../lambda/custom/index.js)** のコピーに戻ります。 - 2. **「TODO: このコメント以下の項目に注意してください。」** というコメント行を探してください。そこがカスタマイズするべきセクションの最初の箇所です。すべてをドキュメント化する代わりに、カスタマイズする部分の目的を理解する助けになるように [index.js]((../lambda/custom/index.js)) にコメントを残しました。 + 2. **「TODO: このコメント以下の項目に注意してください。」** というコメント行を探してください。そこがカスタマイズするべきセクションの最初の箇所です。すべてをドキュメント化する代わりに、カスタマイズする部分の目的を理解する助けになるように [index.js](../lambda/custom/index.js) にコメントを残しました。 3. **index.js** をファイルの下の方まで読むと、どの部分を変更すべきかおよそ察しがつくでしょう。 From 86ed2346476c25e30626b93ae711ae42b253d69a Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 01:09:37 +0900 Subject: [PATCH 8/9] Update 0-intro.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit リンク先の修正 --- instructions/0-intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/instructions/0-intro.md b/instructions/0-intro.md index 007c043..b91f965 100644 --- a/instructions/0-intro.md +++ b/instructions/0-intro.md @@ -16,7 +16,7 @@ * [GitHub](https://github.com/alexa/skill-sample-nodejs-quiz-game)上のサンプルコード * シンプルなGUIエディタ * スキルのユーザに出題する面白いクイズデータ (すくなくとも25問分)。 - * 例: [米国の州](./data/prefectures.js), [ビデオゲーム](./data/videogames.js), [本](./data/books.js), [徳川将軍](./data/monarchs.js) + * 例: [ビデオゲーム](../data/videogames.js), [書籍](../data/books.js), [都道府県](../data/prefectures.js), [徳川将軍](../data/monarchs.js) ## クイズゲームスキルがおこなうこと 私たちは皆、頭の中に興味深いデータを持っています。それは、たとえば、子供時代に遊んだアクションフィギュアのリストであったり、日本の都道府県の詳細な情報であったり、贔屓の野球チームの歴史的な名投手のリストであったりすることでしょう。私たちは友人といる時に、こういったカテゴリの情報についてお互いにクイズを出しあうこともあります。それは、私たちの知識を共有し、好きなトピックについてより学ぶための楽しくインタラクティブな方法です。 From 6d0e6fa44cb73c140c166d17a45c6ac924b23d87 Mon Sep 17 00:00:00 2001 From: jp-96 Date: Fri, 13 Apr 2018 12:59:47 +0900 Subject: [PATCH 9/9] Update 1-voice-user-interface.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 段落修正 --- instructions/1-voice-user-interface.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/instructions/1-voice-user-interface.md b/instructions/1-voice-user-interface.md index c542d70..913e77e 100644 --- a/instructions/1-voice-user-interface.md +++ b/instructions/1-voice-user-interface.md @@ -62,7 +62,7 @@ Alexaスキルは２つの部分からできています。一つは [音声ユ ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/1-12-skill-builder-build-save-model._TTH_.png) -11. 対話モデルのビルドに成功したら、**Configuration ボタン** を押してコンフィギュレーションに移動します。このガイドの次のステップでは、AWS開発者コンソールからLambda関数を作成します。このブラウザのタブは開いたままにしておいてください。[3ページ: VUIとコードを接続する](3-connect-vui-to-code.md)で再びこの画面に戻ってきます。 +11. 対話モデルのビルドに成功したら、**Configuration ボタン** を押してコンフィギュレーションに移動します。このガイドの次のステップでは、AWS開発者コンソールからLambda関数を作成します。このブラウザのタブは開いたままにしておいてください。[3ページ: VUIとコードを接続する](3-connect-vui-to-code.md)で再びこの画面に戻ってきます。 ![](https://m.media-amazon.com/images/G/01/mobile-apps/dex/alexa/alexa-skills-kit/jp/tutorials/quiz-game/1-13-skill-builder-configuration._TTH_.png)