在 Azure IoT Central 解決方案中使用屬性

本操作指南說明如何使用 Azure IoT Central 應用程式中裝置範本中定義的裝置屬性。

屬性代表時間點值。例如，裝置可以使用屬性來報告其嘗試達到的目標溫度。根據預設，裝置屬性在 IoT Central 中是唯讀的。可寫入屬性使您能夠同步裝置和 Azure IoT Central 應用程式的狀態。

您也可以在 Azure IoT Central 應用程式中定義雲端屬性。雲端屬性值永遠不會與裝置交換，而且不在本文的範圍內。

若要瞭解 IoT Pug 和 Play 屬性慣例，請參閱 IoT 隨插即用慣例。

若要深入瞭解裝置與 IoT Central 交換的屬性資料，請參閱遙測、屬性和命令承載。

若要瞭解如何使用 IoT Central REST API 來管理屬性，請參閱如何使用 IoT Central REST API 來控制裝置。

若要瞭解如何在不使用裝置 SDK 的情況下在裝置中實作屬性，請參閱使用 MQTT 通訊協定與 IoT 中樞通訊。

定義您的屬性

屬性是代表裝置狀態的資料欄位。使用屬性來代表裝置的持久狀態，例如裝置的開啟/關閉狀態。屬性也可以代表基本裝置屬性，例如裝置的軟體版本。您可以宣告屬性為唯讀或可寫。

下列螢幕擷取畫面顯示 Azure IoT Central 應用程式中的屬性定義。

下表顯示屬性功能的配置設定。

領域	Description
顯示名稱	儀表版圖格和裝置表單上所用屬性值的顯示名稱。
名稱	屬性的名稱。 Azure IoT Central 會從顯示名稱產生此欄位的值，但您可以視需要選擇自己的值。此欄位必須是英數字元。裝置代碼使用此名稱值。
功能類型	財產。
語意類型	屬性的語意類型，例如溫度、狀態或事件。語意類型的選擇會決定下列哪些欄位可用。
Schema	屬性資料類型，例如 double、string 或 vector。語意類型會決定可用的選項。模式不適用於事件和狀態語義類型。
可寫	如果屬性不可寫入，裝置可以向 Azure IoT Central 報告屬性值。如果屬性是可寫入的，裝置可以向 Azure IoT Central 報告屬性值。然後，Azure IoT Central 可以將屬性更新傳送至裝置。
Severity	僅適用於事件語意類型。嚴重性為「錯誤」、「資訊」或「警告」。
狀態值	僅適用於狀態語意類型。定義可能的狀態值，每個狀態值都有顯示名稱、名稱、枚舉類型和值。
單位	屬性值的單位，例如 mph、 %或 °C。
顯示單元	儀表版圖格和裝置表單上使用的顯示單位。
評論	屬性功能的任何相關註解。
Description	屬性功能的描述。