【Google AIY Voice Kit】Google Assistant APIの設定からデモプログラムの実行まで

Google AIY Voice Kitの組み立て＆設定に関する記事が続いています。今回は、Google Assistant APIを有効化するお話しです。

さて、オーディオチェックとWifi接続を完了させたら、次はGoogle Cloud Platform(GCP)で、Google Assistant APIを有効化する作業へと移ります。

ここの部分は、日本語で説明した情報があまりなかったので、自分のメモという意味も込めて、少し詳しめに書いてみました。

今回の作業は、付属のマニュアルの第5章に該当します。

Google のAIY Projectsのサイトでは、こちらで説明してあります。

Voice

Do-it-yourself intelligent speaker. Experiment with voice recognition and the Google Assistant.

aiyprojects.withgoogle.com

Google Cloud Platformで基本的に行なうステップとしては以下の通りです。

Google Cloud Platformへアクセス

Google Cloud Platformにアクセスして使用したいアカウントでサインインします。

最初にGoogle Cloud Platformにアクセスすると、トップ画面で無料トライアルの文字が出てきます。

「えっ、あとで有料になるサービスなわけ？」とアセるわけですが、とりあえずここでは無料トライアルせずに、次へ進むことはできますので、画面右上のコンソールというリンクをクリックします。

上の図の無料トライアルのうえの水色の「コンソール」って文字をクリックです。するとポップアップメニューが出てくるので、

「すべてのサービスと関連 API について、適用される利用規約を遵守して利用することに同意します。」等にチェックを入れてクリックします。

プロジェクトを新規作成

そして、Google Cloud Platformのロゴ横にある「プロジェクトを選択」をクリックするとポップアップメニューが出てくるので…

右の＋（プラス）マークをクリックしてプロジェクトを新規作成します。

上の画面では「割り当てのプロジェクト数は残り８件です」なんて書いてありますが、最初は12件ありました…。私がミスしてプロジェクトを削除して…を繰り返してたら、結構減ってしまいました。

今思えば、エラーのドツボにはまってもプロジェクトは削除せずに、認証情報（Credentials)だけ変えれば良かったのかもしれません…。

Google Assistant APIの有効化

プロジェクトを作ったら、左側の三本線をクリックして、「APIとサービス」を選び、画面上部右の青字の「APIとサービスの有効化」をクリックします。

表示される検索ボックスに「Google Assistant API」と入れると…

１件、出てきました。「Google Assistant API」をクリックします。

そして、Google Assistant APIを「有効にする」をクリックします。

認証情報でOAuth クライアントIDを選択

すると、「この API を使用するには、認証情報が必要になる可能性があります。開始するには、[認証情報を作成] をクリックしてください。」と出てきていますが、ここでは、この青いボタンはクリックせず、左下「APIとサービス」のメニュー下に出てくる「認証情報」の文字（「ライブラリ」の下にある）をクリックします。

右側画面の青い「認証情報作成」をクリックすると、いろいろな選択肢が出てくるので、今回は「OAuth クライアント ID」を選択します。

すると、あれ？できないや。なんかメッセージが表示されます。

はじめて使用する場合、「OAuth クライアントを作成するには、まず同意画面でサービス名を設定する必要があります」と出てくるので、「同意画面を設定」をクリックします。

そして、認証情報の画面で、メールアドレスと、ユーザーに表示するサービス名を入力します。

ユーザーに表示するサービス名は、自分が判別可能なものを適当に付けるので大丈夫と思います。それで、「保存」ボタンを押します。

ふたたび、認証情報画面に戻りますと、

こんどは入力できるようになっているので、「アプリケーションの種類」から「その他」を選び、名前を入力します。名前は自分が判別できればなんでもOKです。そして、「作成」ボタンをクリックします。

すると「作成中…」という状態になり、間もなくポップアップウィンドウがあがってきます。こんな感じのウィンドウです。

これはこのまま、OKのボタンを押すと…

OAuth 2.0 クライアント IDが一つ出来上がりました。長々とクライアントIDというものが表示されている右側のダウンロードアイコン（↓）をクリックして、ファイルをダウンロードします。長々とした名前のJsonファイルがダウンロードされます。

Jsonファイルの名称変更＆移動

次はダウンロードしたファイルをassistant.jsonにリネームして、/home/pi/直下に移動させ、/home/pi/assistant.jsonという感じにします。その方法は、いろいろあるとは思うのですが、本家のマニュアルの説明に従いますと…

ターミナル画面を開いて、まずは認証情報ファイルの場所を確認してみます。おそらくDownloadsフォルダにダウンロードされているので、それを表示し、リスト化して見てみます。

cd Downloads
ls

とコマンドを打つと、Downloadsフォルダ内のファイルが表示されるので、その中に、client_secret…ではじまる長々とした名前のJsonファイルが出てくるはずです。

この名前を変更するには、

mv client_secret

まで入力して、TABキーを押すと、残りの長々としたファイル名が表示されます。そのあとに、/home/pi/assistant.jsonと続けます。つまり、

mv client_secret_782639341204-79lf5nguo121gvvt0kgu410b35okrni17.apps.googleusercontent.com.json /home/pi/assistant.json

という形で入力します。上の、長々したjsonの名前は、公式マニュアルから拝借したものです。実際は、ご自分のマシンにダウンロードされたものが表示されます。mvとclient_secret…と、.jsonと/home/の間にスペースを入れることを忘れずに！

これで、ダウンロードしたファイルの名前変更したものが、piフォルダの直下に移動したはずです。

さて、終わりが少しずつ見えてきました。

アクティビティ管理画面で有効化する項目

同じGoogle アカウントのアクティビティ管理画面へ行き、

• ウェブとアプリのアクティビティ（「Chrome の閲覧履歴と Google サービスを使用するウェブサイトやアプリでのアクティビティを含める」にチェックを入れる）
• 端末情報
• 音声アクティビティ

を有効にします。

なお、私の場合は最初からすべて有効になっていた情報でしたので、何もしませんでした。

デモプログラムを実行する

さて、ここでいったん、ブラウザを離れてラズベリーパイのデスクトップ画面に戻ります。

マシンのデスクトップ画面にある「Start dev terminal」のアイコンをダブルクリックするとターミナル画面が現れるので、そこに

src/assistant_library_demo.py

のコマンドを入力します。

（追記）

なお、2018年1月に確認したところ、Google Vision kitの登場によるフォルダの変更により、新OSをダウンロードした場合は、場所が変わっています。具体的には、

src/examples/voice/assistant_library_demo.py

です。ご自分のバージョンがどちらになっているかは、該当フォルダをチェックしてファイルが存在しているか確認してみましょう。

（追記）

なお、2019年12月に確認したところ、2019年6月28日よりGoogle Assistant Library for Pythonが廃止になり、Google Assistant Serviceになったためか、OKグーグルというホットワードで動かなくなり、assistant_library_demo.pyが機能しないようです。

テストする際には、assistant_library_demo.pyではなく、assistant_grpc_demo.pyで行なうとうまくいきます。

cd src/examples
./voice/assistant_grpc_demo.py

これこそ、デモのプログラムです。完了まであと一歩！

「Google Assistant API」の許可にOKする

すると、同じタイミングで、ウェブブラウザ（Google Chromium）のページが突然表示され、

「Google Assistant API」が次の許可をリクエストしてます…というメッセージが表示されます。

そこで、「許可」を選択すると…

ようやくOK Googleが使えるようになりました。終了したいときは、Ctrl-Cを入力すればOKです。

ちなみに、

src/assistant_grpc_demo.py

現在は、

cd src/examples
./voice/assistant_grpc_demo.py

のコマンドを入力すると、これは「OK Google」と言うかわりに、ボタンを押して質問するとGoogle さんが答えてくれるようになっています。こちらもCtrl-Cを入力して終了します。

さらに、

src/assistant_library_with_button_demo.py

のコマンドを入力すると、「OK　Google」と言っても、ボタンを押して質問するのも両方OKなバージョンになります。これが一番便利ですね。同じく、Ctrl-Cの入力で終了します。

ちなみにいずれの場合も、「OK Google」という代わりに、「Hey Google」と言っても反応してくれます。

（追記）

なお、2019年12月に確認したところ、先述と同様の理由で、assistant_library_with_button_demo.pyも機能しないようです。

メモ：私の場合…

思えば、最初にWindowsからリモート操作で設定した際には、最後に出てくるブラウザからのGoogle Assistant APIの許可画面に気づきませんでした。最初にエラーが出てしまったのは、Windows で設定したファイルだったからか、ここで「許可」に気づかなかったからか、厳密には原因は謎のままです。のようです。

（追記１)

認証ファイルは、他のパソコン上からでも設定可能です。

（追記２)

Google Assistant SDKのアップデートにより、日本語対応が可能となりました。かなり日本語版のGoogle Homeに近づきました(^^♪。こちらのページもご参照くださいませ。

https://kureuetan.com/web/raspberrypi/4677/

（追記3）

2018年2月21日のGoogle AIY Voice Kit OSのアップデートにより、日本語対応が可能になっています。こちらの記事もご参照くださいませ。

Google AIY Voice kitの日本語対応したOSが来たぞ。ボタンも光る！！

さて、ずいぶんとご無沙汰していたラズパイのGoogle AIY Voice Kitのテーマ。 スペインに帰ってきてから、新しいパソコンを設定したり、家族のことで追われたりしているうちにすっかり時間が過ぎてしまいました。 ...

kureuetan.com

2018.03.13

（追記4）

いつからかは謎なのですが、2019年12月現在では、ラズベリーパイ本体の言語設定を日本語にしていると、自動的に日本語対応になるようです。