Azure IoT Central ソリューションでプロパティを使用する
このハウツー ガイドでは、Azure IoT Central アプリケーションでデバイス テンプレートに定義されているデバイス プロパティを使用する方法について説明します。
プロパティは、特定の時点の値を表します。 たとえば、デバイスはプロパティを使用して、到達しようとしているターゲット温度を報告できます。 既定では、IoT Central でのデバイスのプロパティは読み取り専用です。 書き込み可能なプロパティを使用すると、デバイスと Azure IoT Central アプリケーションの間で状態を同期することができます。
Azure IoT Central アプリケーションで、クラウドのプロパティを定義することもできます。 クラウドのプロパティ値は、デバイスと交換されることはなく、この記事の範囲外です。
IoT プラグ アンド プレイ プロパティ規則の詳細については、「IoT プラグ アンド プレイ規則」を参照してください。
デバイスと IoT Central との間で交換されるプロパティ データの詳細については、「テレメトリ、プロパティ、およびコマンドのペイロード」を参照してください。
IoT Central REST API を使用してプロパティを管理する方法については、「IoT Central REST API を使用してデバイスを制御する方法」を参照してください。
デバイス SDK を使用せずにデバイスにプロパティを実装する方法については、「MQTT プロトコルを使用した IoT ハブとの通信」を参照してください。
プロパティを定義する
プロパティは、デバイスの状態を表すデータ フィールドです。 プロパティは、デバイスのオンまたはオフの状態など、デバイスの持続的状態を表すために使用します。 プロパティでは、デバイスのソフトウェア バージョンなど、デバイスの基本的なプロパティを表すこともできます。 プロパティを読み取り専用または書き込み可能として宣言します。
次のスクリーンショットは、Azure IoT Central アプリケーションでのプロパティ定義を示しています。
プロパティ機能の構成設定を次の表に示します。
| フィールド | Description |
|---|---|
| 表示名 | ダッシュボード タイルとデバイス フォームで使用されるプロパティ値の表示名。 |
| 名前 | プロパティの名前。 Azure IoT Central によって表示名からこのフィールドの値が生成されますが、必要に応じて独自の値を選択できます。 このフィールドは英数字にする必要があります。 デバイス コードでは、この [名前] 値を使用します。 |
| 機能の種類 | プロパティ。 |
| セマンティックの種類 | テレメトリのセマンティックの種類 (温度、状態、イベントなど)。 セマンティックの種類の選択によって、次のどのフィールドを使用できるかが決まります。 |
| スキーマ | プロパティのデータ型 (double、string、vector など)。 セマンティックの種類によって、使用できる選択肢が決まります。 スキーマは、イベントおよび状態のセマンティックの種類には使用できません。 |
| 書き込み可能 | プロパティが書き込み可能でない場合、デバイスから Azure IoT Central にプロパティ値を報告することができます。 プロパティが書き込み可能な場合、デバイスから Azure IoT Central にプロパティ値を報告することができます。 この場合は Azure IoT Central からデバイスにプロパティの更新を送信できます。 |
| 重大度 | イベントのセマンティックの種類にのみ使用できます。 重大度は、エラー、情報、または警告です。 |
| 状態の値 | 状態のセマンティックの種類にのみ使用できます。 考えられる状態の値を定義します。それぞれに表示名、名前、列挙型、および値があります。 |
| ユニット | プロパティ値の単位 (mph、%、°C など)。 |
| 表示単位 | ダッシュボード タイルとデバイス フォームで使用する表示単位。 |
| 解説 | プロパティ機能に関するコメント。 |
| 説明 | プロパティ機能の説明。 |
Azure IoT Central がデバイス テンプレートでプロパティを定義するために使用するデジタル ツイン定義言語 (DTDL) の詳細については、「IoT プラグ アンド プレイ規則」 > 「読み取り専用プロパティ」を参照してください。
表示名や説明などのオプション フィールドを使用すると、インターフェイスや機能に詳細を追加できます。
プロパティを作成するときには、Object や Enum などの複雑なスキーマ型を指定できます。
Object などの複雑なスキーマを選択するときには、オブジェクト スキーマを定義する必要があります。
読み取り専用プロパティを実装する
既定では、プロパティは読み取り専用です。 読み取り専用のプロパティを使用すると、デバイスによって、プロパティ値の更新が Azure IoT Central アプリケーションに報告されます。 Azure IoT Central アプリケーションでは、読み取り専用のプロパティの値を設定することはできません。
Azure IoT Central では、デバイス ツインを使用して、デバイスと Azure IoT Central アプリケーションの間でプロパティ値を同期します。 デバイスのプロパティ値では、デバイス ツインによってレポートされるプロパティが使用されます。 詳細については、デバイス ツインに関するページを参照してください。
デバイスは、プロパティの更新を JSON ペイロードとして送信します。 詳細については、「テレメトリ、プロパティ、およびコマンドのペイロード」を参照してください。
Azure IoT device SDK を使用して、Azure IoT Central アプリケーションにプロパティの更新を送信できます。
複数の言語での実装例については、「 クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続する」を参照してください。
Azure IoT Central アプリケーションの次のビューは、デバイスの読み取り専用プロパティを示しています。
書き込み可能なプロパティを実装する
IoT Central オペレーターは、書き込み可能なプロパティをフォームに設定します。 このプロパティは Azure IoT Central からデバイスに送信されます。 Azure IoT Central では、デバイスからの確認応答を待機します。
複数の言語での実装例については、「 クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続する」を参照してください。
応答メッセージには、ac フィールドと av フィールドが含まれている必要があります。 ad フィールドは省略可能です。 詳細については、「IoT プラグ アンド プレイ規則」 > 「書き込み可能なプロパティ」を参照してください。
オペレーターが Azure IoT Central UI で書き込み可能なプロパティを設定すると、アプリケーションではデバイス ツインによって必要とされるプロパティを使用して、デバイスに値を送信します。 次に、デバイスによってデバイス ツインの reported プロパティが使用され、応答が行われます。 Azure IoT Central は、reported プロパティの値を受け取ると、"承認済み" の状態でプロパティ ビューを更新します。
値を入力して [保存] を選択すると、初期状態は "保留中" になります。 デバイス側が変更を受け入れると、状態は "承認済み" に変わります。
割り当てられていないデバイスでプロパティを使用する
デバイス テンプレートに割り当てられていないデバイスの書き込み可能なプロパティを表示および更新できます。
割り当てられていないデバイスの既存のプロパティを表示するには、[デバイス] セクションでデバイスに移動し、[デバイスの管理]、[デバイスのプロパティ] の順に選択します。
このビューでは、書き込み可能なプロパティを更新できます。
次のステップ
Azure IoT Central アプリケーションでプロパティを使用する方法を習得したら、次は以下を参照してください。