Use Case（ユースケース）

Google音声コマンド経由でPCのシャットダウンを行います。

前提条件

• （Raspberry Piの）PHPが動作するWEBサーバがセットアップされている
• （Raspberry Piの）WEBサーバの公開設定が終わっている
  • DNSで名前解決ができる、固定IPやダイナミックDNSを利用　SynologyでValueDomain向けのDDNS設定方法
  • ルーターのNAT / Port Foward / Virtual Serverの設定が出来ており、インタネットからWEBサーバにアクセスできる　API連携プラットフォーム
  • （Raspberry Piの）https経由（SSL証明書）が設定済み
• （Raspberry Piの）WEBサーバよりSSH2が利用可能　Raspberry Pi 3 B +にPHPのSSH2インストール
• IFTTTサービスの利用登録が実施済みである
• IFTTTサービスにおいて、Webhooksが利用可能である　IFTTT（イフト）でWebhooksの利用
• 起動対象のPCにSSHサーバがインストールされている必要があります　Raspberry Pi 3 B +にPHPのSSH2インストール

全体の流れ

1. IFTTTのGoogle AssistantよりPCシャットダウン時の音声コマンドをトリガートリガー登録
2. IFTTTのWebhooksでPCシャットダウン時の音声コマンド受領時のアクションを実行（Raspberry PiのWEB APIへ発信）
3. WEB APIよりPCをシャットダウン（SSH2経由でシャットコマンドを実行）

トリガー

トリガー（this）にGoogle Assistantを選択し「Say a simple phrase」のトリガーを選択します。

音声コマンドを登録します。
「パソコンをシャットダウンして」
「パソコンの電源を切って」などを登録します。

コマンド受付時のGoogle Homeからのレスポンスも登録します。
「パソコンをシャットダウンします」

Lanuguage（言語）は、Japanese（日本語）を選択します。

アクション

IFTTTのWebhooksよりRaspberry PiのWEB APIへPUSH通知

IFTTT（イフト）でWebhooksの利用

• URL：準備したAPIのURLを指定します。外部からWEBアクセス可能なURLを指定する必要があります。また、APIトークンを送信するので、https:// での指定を強くオススメします。
• Method：今回は、POST受信に対応したPHPを用いるので、POSTを指定します。
• Content Type：application/x-www-form-urlencoded: キーと値は、その間に '=' がある形でキーと値の組になり、 '&' で区切られてエンコードされます。キーや値の英数字以外の文字は、パーセントエンコーディングされます。
• Body：準備したPHPの仕様に合わせて、３つのパラメータを設定します。
  • APIKEY=apikey
  • KEY=shutdownPC

APIKEY=apikey&KEY=shutdownPC

以下が、準備したサンプルのPHPスクリプトとなります。

//@HOME_API_LOG_NAME@　ログファイル名、書き込み権限が必要です//@HOME_API_KEY@　POST受信時の簡易的なAPI-KEYのトークン確認を行います//@WINDOWS_IP@ WindowsのIPアドレス//@WINDOWS_USER@ Windowsのユーザー名//@WINDOWS_PASS@ Windowsのパスワード//各種設定//ログのファイル名define("HOME_API_LOG_NAME","@HOME_API_LOG_NAME@");//home-api-keydefine("HOME_API_KEY","@HOME_API_KEY@");//Windows PCdefine("WINDOWS_IP","@WINDOWS_IP@");define("WINDOWS_USER","@WINDOWS_USER@");define("WINDOWS_PASS","@WINDOWS_PASS@");function shutdownPC($target_ip, $target_user, $target_pass) {logger("Start shutdown target_ip:".$target_ip." target_user:".$target_user,"INFO");$shutdown_time = 60;$comment = "シャットダウン開始します。キャンセル「－ａ」";$cmd = 'shutdown /s /f /t '.$shutdown_time.' /c '.$comment;$connection = ssh2_connect($target_ip);ssh2_auth_password($connection, $target_user, $target_pass);    $stream = ssh2_exec($connection, $cmd);    $errorstream = ssh2_fetch_stream($stream, SSH2_STREAM_STDERR);    stream_set_blocking($stream, true);    stream_set_blocking($errorstream, true);    $ok =  stream_get_contents($stream);   $ng =  stream_get_contents($errorstream); //エラーがあれば表示   echo $ok;   echo $ng;}function logger($text, $level) {$datetime = date('Y-m-d H:i:s');$date = date('Ym');$file_name = __DIR__ . "/log/log-home-{$date}.log";$text = "{$datetime} [{$level}] {$text}" . PHP_EOL;echo $text;if(!(file_exists($file_name))){touch($file_name);chmod($file_name, 0777);}return error_log(print_r($text, TRUE), 3, $file_name);}logger("Start API KEY=".$_POST['KEY'],"INFO");if(isset($_POST['KEY']) && strcmp($_POST['APIKEY'], HOME_API_KEY) == 0) {switch ($_POST['KEY']) {case 'shutdownPC':logger("Start shutdownPC","INFO");shutdownPC(WINDOWS_IP, WINDOWS_USER, WINDOWS_PASS);break;default:logger("This is private API. (in Default)","ERROR");}}else{logger("This is private API. (in else)","ERROR");}

アクション

準備したPHPファイルより「@WINDOWS_IP@：WindowsのIPアドレス、 @WINDOWS_USER@：Windowsのユーザー名、@WINDOWS_PASS@：Windowsのパスワード 」に設定したPCへSSH2用いてPCへログインし、シャットダウンコマンドを実行します。