デバイスシャドウの管理

シャドウを使用すると、断続的にオンラインになっているデバイスの設定を効果的に管理できます。

デバイスのシャドウには、デバイスのreportedおよびdesiredの状態オブジェクトが含まれており、reportedおよびdesiredのシャドウと呼ばれます。

desiredシャドウには、デバイスが使用する設定値と、オプションのカスタム設定値が含まれています。デバイスは取り込みリクエストに対するレスポンスとして、HERE Tracking APIからdesiredシャドウを受信します。

reportedシャドウにはデバイスが送信した最新の位置のほか、センサーの読み取り値と設定値が含まれています。報告されたシャドウには、デバイスに取り込まれたテレメトリーに基づいてHERE Trackingが生成した追加のプロパティが含まれている場合もあります。このようなプロパティは、シャドウのsystem.computedプロパティに保存されます。

最新のテレメトリーにすべてのフィールドが含まれていない場合、最後に確認された情報はシャドウに残ります。つまり、報告されたシャドウ内の最後に報告された温度やデバイスのファームウェアの情報などを参照できます。これは、デバイスが最新のテレメトリーでその情報を送信しなかった場合でも同様です。

📘
注
デバイスはシャドウのエンドポイントと直接通信するのではなく、ingestionエンドポイントにテレメトリーを送信します。ingestionエンドポイントではreportedシャドウが更新され、desiredシャドウが返されます。

アプリケーションはシャドウエンドポイントを介して、desiredシャドウにのみ書き込みを行い、reportedシャドウからのみ読み取りを行います。