8  クラウドから操作する:Lambda と Alexa(解説)

このハンズオンでは send.py が desired を書きましたが、実際には Lambda などのクラウドのプログラムが書きます。 この章では、元のプロジェクトで作った 2 つの入口 ―― Alexa の音声操作 と Web ページ ―― のしくみと、つまずいた点を解説します。

flowchart LR
  E["Echo<br>「照明つけて」"] --> AL["Alexa クラウド"]
  AL --> L1["Lambda<br>(Smart Home スキル)"]
  W["Web ページ"] --> L2["Lambda<br>(Function URL)"]
  L1 -- "desired を更新" --> S[("Device Shadow")]
  L2 -- "desired を更新" --> S
  S -- "delta" --> D["ESP32"]

どちらの入口も、やることは send.py と同じ 「desired を書くだけ」 です。デバイス側は、命令がどこから来たかを気にしません。

8.1 Lambda から Shadow を書く

Node.js(AWS SDK v3)では、次のようになります。

const { IoTDataPlaneClient, UpdateThingShadowCommand } = require("@aws-sdk/client-iot-data-plane");
const iot = new IoTDataPlaneClient({ region: "ap-northeast-1" });

async function updateDesired(desired) {
  await iot.send(new UpdateThingShadowCommand({
    thingName: process.env.THING_NAME,
    payload: Buffer.from(JSON.stringify({ state: { desired } })),
  }));
}

// ボタン:値そのものを毎回変える(第 4 章)
await updateDesired({ sendSlot: `${slot}-${Date.now()}` });
// エアコン:変えたいフィールド + 毎回変わる cmdId(文字列)
await updateDesired({ temp: 26, cmdId: String(Date.now()) });

Lambda の実行ロールには、その Thing の Shadow だけを読み書きできる権限(iot:UpdateThingShadow, iot:GetThingShadow)を付けます。

8.2 Alexa Smart Home スキル

「アレクサ、○○つけて」のような家電操作には、Alexa の Smart Home スキル を使います。Alexa が決まった形式の命令(ディレクティブ)を Lambda に送ってくるので、それを desired に変換します。

Alexa のディレクティブ 発話の例 desired への変換
Alexa.Discovery (機器の検出) Shadow の reported から、操作できる機器の一覧を返す
Alexa.PowerController 「照明つけて」「消して」 ボタン:{sendSlot: "5-時刻"}、エアコン:{power: true, cmdId}
Alexa.SceneController (シーンの実行。照明以外のボタン) {sendSlot: "<slot>-時刻"}
Alexa.ThermostatController 「エアコンを 26 度にして」 {temp: 26, cmdId}
Alexa.ReportState (アプリで状態表示) Shadow の reported を読んで返す

8.2.1 つまずいた点

  • Lambda を置けるリージョンが決まっている:日本(Alexa の極東リージョン)向けのスキルの Lambda は、米国西部(オレゴン、us-west-2) に置く必要があります。IoT Core は東京のままでよく、Lambda の中で region: "ap-northeast-1" を指定して、リージョンをまたいで Shadow を書きます
  • アカウントリンクが必須:Smart Home スキルは、ユーザーのアカウントとのひも付け(OAuth 2.0)が必要です。自前で OAuth サーバーを書く代わりに、Amazon Cognito のユーザープールを使いました
  • トグル式の照明は、状態が分からない:「つけて」でも「消して」でも、学習した同じ信号を送るしかありません。壁のスイッチで操作されると、Alexa が思っている状態と実際がずれます。照明の電源状態は Alexa に「取得できない」(retrievable: false)と申告しています
  • Alexa の温度モードに除湿・送風がない:ThermostatController の標準モードは自動・冷房・暖房などで、除湿・送風は音声では操作できません(Web ページ側で操作)

8.3 Web ページから操作する

外出先からブラウザで操作できるように、Lambda の関数 URL(Lambda に直接 HTTPS の URL を付ける機能)を使った小さな API も作りました。

  • ブラウザ → 関数 URL → Lambda → Shadow の desired
  • 5 秒ごとに Shadow の reported を読んで、画面の状態を更新
警告CORS ヘッダーを 2 か所で付けない

関数 URL に CORS の設定(許可するオリジンなど)をすると、AWS がレスポンスに CORS ヘッダーを 自動で付けます。 Lambda のコードでも Access-Control-Allow-Origin を返すと、同じヘッダーが 2 つ になり、ブラウザに拒否されます。どちらか一方(関数 URL の設定)にまとめます。

ヒント認証は簡易でも必ず付ける

関数 URL を「認証なし」で公開すると、URL を知っている人は誰でも家電を操作できます。 元のプロジェクトでは、Lambda の中でパスワードを照合する簡易な方式にしています。より厳密には、IAM 認証や Cognito を使います。

重要この章のまとめ
  • クラウド側は desired を書くだけ。Alexa も Web も、send.py と同じ変換規則(毎回変わる値・cmdId)を守る
  • 日本向け Alexa Smart Home スキルの Lambda は us-west-2。Shadow はリージョンをまたいで書ける
  • 関数 URL の CORS は 1 か所 で設定し、認証 を付ける