Upload
others
View
3
Download
0
Embed Size (px)
Citation preview
Docomo AI エージェント
Android 版ハンズオン クイックスタートガイド for Windows
(2019 年 8 月 22 日作成)
日本仮想化技術株式会社
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
本書について本ドキュメントは Docomo AI エージェント Android 版ハンズオンを実施するために必要な、事前準備すべき Windows 環境のセットアップ手順をまとめたものです。
本家チュートリアル資料とともにお使いください。
本書の記述について
本書では、次のような表記規則に従って記述しています。
• ボタンについては「OK」ボタンのように記述します。• ウィンドウについては「サーバーマネージャー」ウィンドウのように記述します。• 画面上の選択項目については、要素をかっこで括って表記します。• 大きな画面では、画面全体の左側を「左ペイン」、中央を「中央ペイン」、右側を「右ペイン」
と表記します。• ウィザードの画面遷移については、「次へ」ボタンをクリックするといった一般的に操作され
るであろうボタンや項目の操作については省略しています。
要件
ハンズオンを Windows で実施する場合は、次のソフトウェアおよびハードウェアが必要です。
• Git クライアント
• Android Studio
• Android 端末
本書では、Git クライアントとして Git for Windows を利用しています。Android 端末はハンズオンで用意されている端末を使いますが、手元の Android 端末を使いたい場合は次の条件にマッチする端末を用意する必要があります。
• Android 5.x から 9.0
• 開発者オプションを有効にする
• 開発者オプションの USB デバッグ機能
詳細は以下で公開されている、ユーザーガイドをご覧ください。
https://github.com/docomoDeveloperSupport/speak-android-sdk
2
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
1. Git for Windows
まずは GitHub からソースをクローンするための環境を整えます。Windows 向けの Git クライアントはいくつか存在しますが、本書では Git for Windows を使った例で解説します。
1-1 Git for Windows のインストール
1. Git for Windows をダウンロードします
https://gitforwindows.org/
2. Git for Windows インストーラーを実行します
3. 「このアプリがデバイスに変更を加えることを許可しますか?」ウィンドウが表示されます。「はい」ボタンをクリックします
4. インストーラーが起動します。ライセンスが表示されます。確認して「Next」
5. インストールするパスを設定して「Next」
6. インストールするコンポーネントを指定して「Next」
7. スタートメニューフォルダーを指定して「Next」
8. デフォルトのエディターの指定を「Use Vim」を設定して「Next」
9. 「...PATH environment」は「Use Git from Git Bash Only」を設定して「Next」
10.「...HTTPS transport backend」は「Use the OpenSSL Library」を設定して「Next」
11.「...line ending conversions」は「Checkout Windows-style, commit Unix-stile line endings」を設定して「Next」
12.「Terminal emulator」の選択では、「Use MinTTY」を設定して「Next」
13.「Configure extra options」は「Enable file system cahing , Enable Git CredentialManager」を設定して「Next」
14.「Configure expermental options」は設定せずに「Install」ボタンをクリックしてインストール開始
15.「Completing the Git Setup Wizard」が表示されたら「Finish」ボタンをクリックしてセットアップ終了
3
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
1-2 Git for Windows を使ったソースのクローン
Git for Windows をインストールすると、「Git Bash」というアプリケーションが追加されます。このアプリケーションをスタートメニューから選ぶか、スタートメニュー横の検索から探して起動します。
Git Bash を実行すると、次のような端末が起動します。
Git Bash 起動後、チュートリアル資料で示された Git ソースをクローンしてください。
% git clone -b trial https://github.com/docomoDeveloperSupport/speak-android-sample.git
(Git リポジトリーパスは 2019 年 8 月 22 日現在)
クローンしたソースは、「c:¥Users/<User>/speak-android-sample」ディレクトリー配下にソースがクローンされます。パスを確認するには pwd コマンドを実行してください。このパスをコピーしておきます。
4
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
2. Android Studio
Android Studio は Android デバイスで動かすアプリケーションの開発で利用します。
2-1 Android Studio のインストール
1. Android Studio をダウンロードします
https://developer.andriod.com/studio/
2. ライセンスを確認した後、「I have read and agree with the abobe terms and conditions」にチェックを入れたあと、「Download Android Studio for Windows」ボタンをクリックします
3. ダウンロードが始まります
4. Android Studio インストーラーを実行します
5. 「このアプリがデバイスに変更を加えることを許可しますか?」ウィンドウが表示されます。「はい」ボタンをクリックします
6. 「Welcome」画面で「Next」
7. 「Choose Components」画面で「Next」
8. 「Android Studio Install Locations」画面でパスを設定(デフォルトのままでも構いません)して「Next」
9. 「Choose Start Menu Folder」画面でフォルダ名を設定(デフォルトのままでも構いません)して「Install」ボタンをクリックすると、インストール開始
10.「Installation Complete」と表示されたら「Next」
11.次のような画面が現れたらインストール完了
12.「Import Android Studio Settings From」画面が表示されます。初めて起動する場合は「Do not import settings」を選択して「OK」
13.「Android Studio」が起動します
5
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
14.「Data Sharing」画面でいずれかを選択する。送りたくない場合は「Don't send」ボタンをクリック
15.「Android Studio Setup Wizard」が表示される
2-2 Android Studio Setup Wizard の実行
1. 「Welcome」画面で「Next」
2. 「Install Type」で「Standard」を選択して「Next」
3. 「Select UI Theme」で好みの配色を選択して「Next」
4. 「Verify Settings」で確認して「Finish」(SDK などのバージョンについてはインストール後に変更します。そのまま次に進んでください)
5. Android Studio コンポーネントのインストールが始まります。終わるまで待ちます
6. 終わったら Wizard の「Finish」ボタンをクリック
2-3 Android Studio SDK の設定
1. スタートメニューなどから「Android Studio」を起動します
2. 「Welcome to Android Studio」ウィンドウが表示されます
3. ウィンドウの「Configure」ボタンをクリックします
4. メニューから「SDK Manager」をクリックします
5. 「SDK Platforms」は「Android 8.0 Oreo」を選択します。新しいものは念の為にチェックを外します
6. 「SDK Tools」は次のコンポーネントを選択します。それ以外については必要に応じてチェックを外します
◦ Android SDK Build-Tools
◦ Android SDK Platform-Tools
◦ Android SDK Tools
◦ Google USB Driver(Windows 版のみ)
6
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
7. 「Comfirm Change」画面が表示されたら確認して「OK」ボタンをクリックします
「SDK Platforms」の画面で「Android 8.0 Oreo」を選択すると、それに対応するバージョンの Android SDK がインストールされます。デフォルトでは最新の SDK がインストール済みですので、チェックを外すと不要な Android SDK コンポーネントが削除対象としてマークされます。
8. 「SDK ライセンス」が表示されます。ライセンスを確認したあと「Accept」にチェックし、「Next」ボタンをクリック
9. 指定したコンポーネントがセットアップされます。終了するまで待ちます
10.全て終わったらインストーラーの「Finish」ボタンをクリック
7
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
2-4 Android Studio を使ったソースの表示
1. 「Android Studio」ウィンドウの中のメニューで「Open an existing Android Studio project」(上から 2個目)をクリック
2. クローンしたソースを一覧から選択します
3. Android Studio が起動して、ソースのビルドに必要な Gradle のダウンロードの処理が始まります
8
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
4. 次のようなダイアログが表示されます。「アクセスを許可する」ボタンをクリックします(利用しているセキュリティ対策ソフトのファイアーウォールによって異なります。次の例はWindows ファイアーウォールを使っている場合の例です)
5. ソースのビルドが始まります。終わるのを待ちます
6. ハンズオンで指示された部分にデバイス ID を設定します
7. 書き換え後、PCと Android 端末を接続します
8. アプリのビルドを行うと、アプリが PCと USB接続した Android 端末に転送されます
9. 「検証アプリ」を起動します。初回起動で認証が必要です。Google アカウントか d アカウントで認証してください(アカウントに 2 ファクター認証を設定している場合は、認証用の端末が必要)
9
Docomo AI エージェント Android 版ハンズオンクイックスタートガイド for Windows
10.マイクをタップしてミュートを解除して、話しかけてみましょう
◦ こんにちは
◦ 名前はXXです
11.もし反応がない場合は、次を確認してください
◦ Android 端末がインターネット接続されているか
◦ 「キャンセル」とマイク入力した場合に反応があるか
◦ AgentCraft のエージェントに設定したルールを確認し、エージェントのテストを再度実行する
◦ Android 端末のマイクがミュートになっていないか、ボリュームは適切か
◦ Android 端末でテキスト入力して、エージェントが適切に反応するか
10