Google Home Developer Center へようこそ。スマートホームアクションの開発方法を学習できます。注: アクションの構築は、引き続き Actions Console で行います。

このページは Cloud Translation API によって翻訳されました。

アプリをテストしてデバッグする

前述の手順を使用してローカルフルフィルメントアプリをビルドしてから、次の手順を使用して独自のホスティング環境でスマートホーム統合をテストすることをおすすめします。

独自のホスティング環境で、ローカルフルフィルメントアプリを実行する HTML ページを用意します。次のスニペットは、ローカルフルフィルメントアプリを実行する静的 HTML ファイルの例です。
```
<html>
  <head>
    
    <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
    
    <script src="local_execution.js"></script>
  </head>

</html>
```
デバイス制御をテストします。
Chrome からデバッグします。ブレークポイントとログを使用して統合のトラブルシューティングを行います。
TypeScript コードを修正してコンパイルしてから、これらの手順を繰り返します。

このビルド＆テストのプロセスを繰り返すことで、アクションの変更をすばやく確認し、コードの問題を簡単に見つけてデバッグすることができます。

デバイス制御をテストする

Actions Console で、ウェブアプリの URL を指定する必要があります。この URL で、ローカルフルフィルメント中に Google Home または Google Nest デバイスに読み込まれる HTML を提供します。

ローカルフルフィルメントを使用してデバイス制御をテストする手順は次のとおりです。

Chrome

Actions Console でスマートホームプロジェクトを開きます。
左側のナビゲーションで、[Actions]（アクション）をクリックします。
[Configure local home SDK (optional)] > [Enter your testing URL for Chrome]（Chrome 用のテスト URL を入力）で、ローカルフルフィルメントアプリを実行する HTML を提供する開発用サーバーの URL を指定します。
[Save]（保存）をクリックします。Google がコンソールの変更を反映するまでに最大 30 分ほどかかることがあります。
テスト用の Google Home または Google Nest デバイスを再起動します。
スマートデバイスにコマンドを発行します。たとえば、デバイスが OnOff トレイトを実装している場合は、「OK Google, ライトをつけて」と話しかけます。

Node.js

Actions Console でスマートホームプロジェクトを開きます。
左側のナビゲーションで、[Actions]（アクション）をクリックします。
[Configure local home SDK (optional)] > [Enter your testing URL for Node]（Node 用のテスト URL を入力）で、ローカルフルフィルメントアプリを実行する JavaScript を提供する開発用サーバーの URL を指定します。
[Save]（保存）をクリックします。Google がコンソールの変更を反映するまでに最大 30 分ほどかかることがあります。
テスト用の Google Home または Google Nest デバイスを再起動します。
スマートデバイスにコマンドを発行します。たとえば、デバイスが OnOff トレイトを実装している場合は、「OK Google, ライトをつけて」と話しかけます。

デバイスで使用されているランタイムの詳細については、サポートされているデバイスをご覧ください。

Chrome からデバッグする

ローカルフルフィルメントアプリをデバッグするには Chrome DevTools を使用します。デバッグの前に、環境が正しく設定されていることを確認してください。

コンソール内の開発用 URL が Google Home デバイスまたは Google Nest デバイスからアクセスできる URL に設定されている（ローカルエリアネットワーク上かインターネット経由のどちらか）。
マシンが、テストしている Google Home または Google Nest デバイスと同じローカルエリアネットワークに接続されている。
ネットワークがデバイス間のパケットをブロックしていない。
Actions Console 上と Google Home デバイスまたは Google Nest デバイス上で同じ Google アカウントを使用してログインしている。
クラウドフルフィルメントで SYNC レスポンスが更新されている。otherDeviceIds フィールドで少なくとも 1 つの有効な値が返されます。
Actions Console で正しいスキャン設定情報が入力されている。

ローカルフルフィルメントアプリを Chrome DevTools デバッガに接続する手順は次のとおりです。

Chrome

ローカルの開発用マシンに、Google Chrome ブラウザをインストールして起動します。
Chrome ブラウザのアドレス欄に、「chrome://inspect#devices」と入力して Chrome インスペクタを起動します。ページにデバイスのリストが表示され、テスト対象の Google Home デバイスまたは Google Nest デバイスの名前の下に HTML ファイルが表示されます。
HTML の下にある青色の検査リンクをクリックして Chrome DevTools を起動します。Console タブに切り替えます。ローカルホームプラットフォームが、アプリのバージョンと Local Home SDK バージョンをコンソールログに出力します。ログが表示された場合は、アプリが正常に読み込まれて接続できる状態になっています。ログが表示されない場合は、Google Home または Google Nest デバイスを再起動してください。

Node.js

ローカルの開発用マシンに、Google Chrome ブラウザをインストールして起動します。
テストデバイスのローカル IP アドレスを確認します。
Chrome ブラウザのアドレス欄に、「chrome://inspect#devices」と入力して Chrome インスペクタを起動します。
[Configure]（設定）を選択して [Target discovery settings]（ターゲット検出の設定）を開きます。

リストに DEVICE_IP_ADDRESS:9222 と入力して、[Done]（完了）をクリックします。
スクリプトの下にある青色の検査リンクをクリックして Chrome DevTools を起動します。 Console タブに切り替えます。ローカルホームプラットフォームが、アプリのバージョンと Local Home SDK バージョンをコンソールログに出力します。ログが表示された場合は、アプリが正常に読み込まれて接続できる状態になっています。ログが表示されない場合は、Google Home または Google Nest デバイスを再起動してください。

デバイスで使用されているランタイムの詳細については、サポートされているデバイスをご覧ください。

デバッグのヒント

デバッグ中は次の点に注意してください。

テストアカウントに、同じローカルネットワーク上の複数の Google Home デバイスまたは Google Nest デバイスをリンクさせないようにしてください。ローカルフルフィルメントコマンドのターゲットを、どの Google Home デバイスまたは Google Nest デバイスにするかを制御することはできません。
Chrome DevTools でページを更新し、ローカルフルフィルメントアプリコンテナを再読み込みして、開発用 URL からの最新のコードを確認します。これによってローカルホームプラットフォームがリセットされることはありません。なお、リセットは、ローカルフルフィルメントアプリでプラットフォームインテント（IDENTIFY など）を再トリガーするために必要になることがあります。ローカルホームプラットフォームをリセットするには、Google Home デバイスまたは Google Nest デバイスを再起動します。
JavaScript アプリがエラーなしで読み込まれていることを確認します。これを行うには、DevTools ページのコンソールセクションを確認してください。問題がある場合は、「Uncaught TypeError: Cannot read property ‘open’ of null.」などのメッセージが表示されます。
IDENTIFY レスポンスからの verificationId は、SYNC レスポンスからの otherDeviceIds のいずれかと一致する必要があります。
EXECUTE ハンドラの場合は、HTTP、TCP、UDP のコマンドがデバイスで受信され、正常に動作することを確認します。
ハンドラから Promise が返されることを確認します。
メモリ内でグローバルな状態を維持しないようにします。詳しくは、アプリケーションのライフサイクルをご覧ください。
ローカルフルフィルメントアプリによってスローされたエラーは、プロジェクトのエラーログに表示されます。

本番環境の準備と本番環境へのリリース

スマートホームアクションをリリースする準備が整ったら、次の手順を行います。

ターミナルを開きます。プロジェクトディレクトリで、npm run build コマンドを実行します。このコマンドは、dist ディレクトリに、アプリ用の次の JavaScript バンドルを生成します。
```
project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
```
コンソールで、[Develop]（開発）> [Actions]（アクション）の順にクリックして、JavaScript アプリをアップロードします。[Configure Local Home SDK]（Local Home SDK の設定）で、[Upload JavaScript files]（JavaScript ファイルのアップロード）をクリックします。

図 3: JavaScript アプリをアップロードします。
[Upload files]（ファイルのアップロード）ダイアログで、以前に生成したバンドルファイルをアップロードします。必ずバンドルファイルの両方のバージョン（ノード、ウェブ）をアップロードして、ローカルフルフィルメントがサポートするすべてのランタイム環境で正しく動作するようにアクションを設定します。
1. [Upload your JavaScript targeting Node.js]（Node.js をターゲットとする JavaScript をアップロード）: dist/node ディレクトリから bundle.js ファイルをアップロードします。
2. [Upload your JavaScript targeting Chrome (browser)]（Chrome（ブラウザ）をターゲットとする JavaScript をアップロード）: dist/web ディレクトリから bundle.js ファイルをアップロードします。
アシスタント搭載デバイスでアクションをテストし、本番環境で想定どおり動作することを確認します。詳細については、スマートホームアクションのテストと共有をご覧ください。
アクションの動作に問題がなければ、スマートホームアクションをリリースする手順に沿って、本番環境にデプロイするために Google に提出します。これには、セルフテストと認定申請の手順が含まれます。

Implement local fulfillment app