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 1
desired を更新: {"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'}
警告cmdId を別フィールドにする方法は、ボタンには使えなかった

元のプロジェクトでは、ボタンにも {"sendSlot": 5, "cmdId": "..."} を試しましたが、うまくいきませんでした。 sendSlot の値が前と同じだと delta に sendSlot が入らず cmdId だけ が届くので、「どのボタンか」が分からないのです。 ボタンのように「どれを実行するか」自体を伝えるコマンドは、値そのものを毎回変える 方式にします。

4.4 シミュレータで確かめる

「照明ボタン(素の 5)」を 2 回押すと、2 回目は delta が出ず、照明が切り替わりません。「照明ボタン(“5-時刻”)」なら毎回切り替わります。 エアコンも、「cmdId なし」は 2 回目が届かず、「cmdId つき」は毎回届きます。

重要この章のまとめ
  • Shadow は 状態 の同期。desired と reported が同じ値なら、更新しても delta は出ない(エラーも出ない)
  • コマンド型(ボタン)は、値そのものに時刻を混ぜて 毎回変える
  • 状態型(エアコン)は、状態はそのままにして、毎回変わる cmdId を足す