結 — Alexa

Echo は耳。解釈は Alexa。結は家の機器を Discover して動かすだけ（ダイキンと同じ Smart Home）。

呼び方は 「アレクサ、電気消して」。スキル名は要らない。

結側（済み）

機器の出し方:

Custom /api/alexa/custom は残してあるが本線ではない。

もの	値
スキル	結ホーム（スマートホーム / ja-JP）
スキル ID	`<自分のスキル ID>`
ベンダー ID	`<自分のベンダー ID>`
ペイロード	v3
Lambda	`arn:aws:lambda:us-west-2:<自分の AWS アカウント>:function:yuihome-alexa`（自分の AWS アカウント）
Lambda のトリガー	Alexa Smart Home、上のスキル ID
認可 URI	`https://<自分のホスト>/api/alexa/oauth/authorize`
トークン URI	`https://<自分のホスト>/api/alexa/oauth/token`
Client ID	`<自分で決める Client ID>`
スコープ	`home`（結は検証しない）
リダイレクト URL	pitangui.amazon.com / layla.amazon.com / alexa.amazon.co.jp の `/api/skill/link/<自分のベンダー ID>` と `/spa/skill/account-linking-status.html?vendorId=<自分のベンダー ID>`

上記はすべて設定済みで、クオの Echo で実運用している（シークレット登録・アカウントリンク・デバイス検出まで完了）。

公式スキル「結ホーム」を Amazon の認定審査へ提出した（ステータス: 審査中）。

Lambda のタイムアウトは 8 秒（Alexa の上限）。既定の 3 秒では、Smart Life の操作（トークン→状態→コマンドの 3 往復）が入りきらない。

結で機器を足したり名前を変えたりしても、Alexa は自分から気付かない。 proactivelyReported はすべて false で、Alexa Event Gateway も使っていないため、 Alexa 側からもう一度取りに来させる必要がある。

注意が 2 つある。

Alexa アプリ側で名前を変えた機器は、結の名前で上書きされない。 Alexa は利用者が付けた名前を優先する。その場合は Alexa アプリ側で直す
機器が増えないときはスキルの接続を疑う。その他 → スキル・ゲーム → 有効なスキル → 「結ホーム」があるか

Lambda の CloudWatch ログ（/aws/lambda/yuihome-alexa）に結の応答がそのまま出る
invalid_client → クライアントシークレットが Amazon 側と .env で食い違っている
ログイン画面から Amazon へ戻らない → /login?next= を落としている
機器が 1 台も出ない → 結の機器が source: "live" でない（デモ機器は Alexa へ出さない）
特定の機器だけ動かない → 接続先ごとに実装が違う。Nature Remo はセンサー・エアコン（温度・モード・風量・風向）・照明・学習済み赤外線、SwitchBot はボット・コンセント・照明・カーテン・鍵・センサー・IR エアコン、Smart Life は機器が持つ DP（スイッチ・明るさ・カーテン・エアコンなど）。ダイキン直結は温度・モード・風量・風向（自動・固定・スイング）・自動運転の相対温度。表に無い機種と、結に kind が無い掃除機・加湿器は詳細操作を出さない。未対応は黙って成功を返さずエラーを出す
名前が古いまま → 再検出していないか、Alexa アプリ側で名前を変えたことがある（そちらが優先される）
オーデリック照明が出ない → 自宅の image だけの機能。YUI_ODELIC_BRIDGE_URL が要る。kind: "light" なので、機器として在れば Alexa には自動で出る