4 落とし穴 1:同じ値は届かない
「アレクサ、照明つけて」が 1 回目は効くのに、2 回目からまったく反応しない ―― 元のプロジェクトで最初に起きた不具合です。
desired に {"sendSlot": 5} を書き、デバイスが処理して reported にも 5 を書き戻しました。 もう一度 desired に {"sendSlot": 5} を書くと、デバイスに delta は届くでしょうか?
4.1 実験する
ターミナル A でデバイス、B で watch を動かしたまま、ターミナル C で 素の数値 を 2 回送ります。
python device/send.py slot-raw 1
python device/send.py slot-raw 1desired を更新: {"sendSlot": 1} → version 6
desired を更新: {"sendSlot": 1} → version 8
デバイス(ターミナル A)には、1 回目しか届きません。
[ 13.8s] delta 受信(push): {"sendSlot": 1}
[ 13.8s] >>> 赤外線送信 #3: スロット 1「テレビ 音量+」
[ 13.8s] <<< reported 更新: {"sendSlot": 1}
2 回目の更新は 受け付けられて version も増えている のに、何も起きません。エラーも出ません。
4.2 なぜ届かないのか
delta は「desired のうち、reported と値が違う フィールド」でした(第 1 章の規則 3)。
| desired | reported | delta | |
|---|---|---|---|
| 1 回目の送信 | sendSlot: 1 |
(なし) | sendSlot: 1 → 届く |
| デバイスが書き戻した後 | sendSlot: 1 |
sendSlot: 1 |
なし |
| 2 回目の送信 | sendSlot: 1 |
sendSlot: 1 |
なし → 届かない |
Shadow は「状態 を同期するしくみ」です。「同じ状態にしてほしい」と言われても、すでにその状態なので何もしません。 ところが「ボタンを押す」は 状態ではなく、出来事(コマンド) です。押すたびに 1 回送信してほしいのに、値が同じなので「変化なし」と扱われてしまったのです。
エアコンでも同じことが起きます。
python device/send.py ac-raw --temp 27
python device/send.py ac-raw --temp 27 # 2 回目は届かない「もう一度 27 度に設定して」(リモコンの信号が届かなかったので送り直したい)が、届きません。
4.3 対策:毎回変わる値を混ぜる
4.3.1 コマンド型(ボタン):値そのものを毎回変える
desired = {"sendSlot": f"{slot}-{int(time.time() * 1000)}"} # "5-1791382552299"送るたびに値が変わるので、必ず delta になります。デバイスは - の前を取り出してスロット番号にし、受け取った文字列をそのまま reported に書き戻します。
4.3.2 状態型(エアコン):別のフィールド cmdId を足す
エアコンの temp: 27 を "27-時刻" にすると、温度の意味が壊れます。そこで、状態はそのままにして、毎回変わる cmdId を別のフィールドとして一緒に送ります。
desired = {"temp": 27, "cmdId": str(int(time.time() * 1000))}同じ温度でも cmdId が変わるので、delta に cmdId が入って届きます。デバイスは「cmdId だけが届いた」場合も、今の状態をもう一度送信する 指示として扱います。
python device/send.py ac --power on --temp 24
python device/send.py ac --power on --temp 24 # 2 回目も届く2 回目の delta には、power も temp も入らず、cmdId だけ が入ります(値が同じフィールドは delta に入らないため)。
[ 26.6s] delta 受信(push): {"cmdId": "1791382573706"}
[ 26.6s] >>> 赤外線送信 #5: エアコン {'power': True, 'mode': 'cool', 'temp': 24, 'fan': 'auto'}
元のプロジェクトでは、ボタンにも {"sendSlot": 5, "cmdId": "..."} を試しましたが、うまくいきませんでした。 sendSlot の値が前と同じだと delta に sendSlot が入らず cmdId だけ が届くので、「どのボタンか」が分からないのです。 ボタンのように「どれを実行するか」自体を伝えるコマンドは、値そのものを毎回変える 方式にします。
4.4 シミュレータで確かめる
「照明ボタン(素の 5)」を 2 回押すと、2 回目は delta が出ず、照明が切り替わりません。「照明ボタン(“5-時刻”)」なら毎回切り替わります。 エアコンも、「cmdId なし」は 2 回目が届かず、「cmdId つき」は毎回届きます。
- Shadow は 状態 の同期。desired と reported が同じ値なら、更新しても delta は出ない(エラーも出ない)
- コマンド型(ボタン)は、値そのものに時刻を混ぜて 毎回変える
- 状態型(エアコン)は、状態はそのままにして、毎回変わる cmdId を足す