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"]
8 クラウドから操作する:Lambda と Alexa(解説)
このハンズオンでは send.py が desired を書きましたが、実際には Lambda などのクラウドのプログラムが書きます。 この章では、元のプロジェクトで作った 2 つの入口 ―― Alexa の音声操作 と Web ページ ―― のしくみと、つまずいた点を解説します。
どちらの入口も、やることは 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 を読んで、画面の状態を更新
関数 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 か所 で設定し、認証 を付ける