即插即用裝置訊息承載

• 裝置傳送至服務的遙測。
• 裝置與服務同步的屬性。
• 服務在裝置上呼叫的命令。

本文說明裝置傳送和接收的 JSON 承載，用於 DTDL 裝置模型中定義的遙測、屬性和命令。

This indicates that the JSON carriers sent and received by the device are used to detect, attribute and command as defined in the DTDL device model.

本文不會說明每個可能類型的遙測、屬性和命令承載，但範例會說明關鍵類型。

This paper will not describe each possible type of remote, attribute and command carrying, but the example will describe the key type.

每個範例會顯示裝置模型的程式碼片段，其會定義類型和範例 JSON 承載，藉以說明裝置如何與 IoT Central 等隨插即用感知服務互動。

Each example displays a code snippet of the device model, which defines the type and example of JSON to be carried to explain how the device interacts with Iot Central and the like.

如果遙測是在繼承介面中定義，您的裝置就會傳送遙測，如同在根介面中定義一樣。 指定下列裝置型號：

If the remote is defined in the successor interface, your device will transmit the remote as defined in the root interface. Specify the following device types:

裝置會使用下列承載來傳送計量電壓遙測。 裝置不包含承載中的介面名稱：

Devices use the following loads to transmit measured voltage remotes. The device does not contain the interface name of the load:

本節說明裝置可串流的基本遙測類型範本。

This section describes the basic remote type samples for which the device can stream.

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示：

Device client should transmit remote measurements in the form of JSON, as shown in the following examples:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示：

Device client should transmit remote measurements in the form of JSON, as shown in the following examples:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示：

Device client should transmit remote measurements in the form of JSON, as shown in the following examples:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示：

Device client should transmit remote measurements in the form of JSON, as shown in the following examples:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示 - 類型的格式必須為 ISO 8061：

Device client should send remotes in the form of JSON, as shown in the following examples - the type must be formatted in ISO 8061:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示 - 持續時間的格式必須為 ISO 8601：

Device client should send remotes in the form of JSON, as shown in the following examples - the format of the duration must be ISO 8601:

本節說明裝置可串流的複雜遙測類型範本。

This section describes the complex remote type of device that can stream.

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示。 可能的值為 、 和 ，其在 IoT Central 中顯示為 、 和 ：

Device client should send remote measurements in the form of JSON, as shown in the following examples. Possible values are, and are shown in Iot Central as, and:

下列裝置模型的程式碼片段顯示 遙測類型的定義。 此物件有三個欄位，其類型為 、 和 ：

The following device models have code snippets showing the definition of the remote type. This object has three columns of type, and:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示。 類型必須符合 ISO 8061 規範。 的可能值為 、，且在 IoT Central 中會顯示為 、 和 ：

Device client should send remote measurements in the form of JSON, as shown in the following examples. Type must conform to ISO 8061. Possible values are, and will be shown in Iot Central as, and:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示：

Device client should transmit remote measurements in the form of JSON, as shown in the following examples:

下列裝置模型的程式碼片段顯示 遙測類型的定義：

Snippets of the following device models show the definition of the remote type:

裝置用戶端應以 JSON 的形式傳送遙測，如下列範例所示。 IoT Central 會顯示值作為地圖上的釘選：

Device client should send remote measurements in the form of JSON, as shown in the following examples. Iot Central displays values as nails on the map:

本節會顯示裝置傳送至 IoT Central 應用程式的遙測事件和狀態範例。

This section shows the remote event and status examples of the device sent to the Iot Central application.

下列裝置模型的程式碼片段顯示 事件類型的定義：

The following device models have code snippets showing the definition of the event type:

裝置用戶端應以 JSON 的形式傳送事件資料，如下列範例所示：

Device client should send event data in the form of JSON, as illustrated by the following examples:

下列裝置模型的程式碼片段顯示 狀態類型的定義：

The following device models have code snippets showing the definition of the status type:

裝置用戶端應以 JSON 的形式傳送狀態，如下列範例所示。 可能的整數狀態值為 、 或 ：

Device client should transmit the status in the form of JSON, as shown in the following examples. Possible integer status values are, or:

如果屬性是在元件中定義，請將屬性包裝在元件名稱中。 下列範例會設定 元件中的 。 標記 表示此區段會定義元件：

If properties are defined in widgets, package properties in widget names. The following examples are set in widgets. Marks indicate that this segment is defined in widgets:

本節說明裝置傳送至服務的基本屬性類型範圍。

This section describes the range of basic attributes that the device sends to the service.

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示。 類型必須符合 ISO 8061 規範：

Device client sends JSON to carry the report properties of the device as a response, as shown in the following examples. The type must conform to ISO 8061:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性 - 持續時間必須符合 ISO 8601 規範，如下列範例所示：

Device client sends JSON to carry the report properties in the device response - the continuous time must meet ISO 8601, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

本節說明裝置傳送至服務的複雜屬性類型範圍。

This section describes the range of complex attributes that the device sends to the service.

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示。 可能的值為 、，其在 IoT Central 中顯示為 、 和 ：

Device client sends JSON to carry the report properties of the device as a response, as shown in the following examples. Possible values are, in Iot Central, shown as, and:

下列裝置模型的程式碼片段顯示 屬性類型的定義。 此物件有兩個欄位，其類型為 和 ：

The code snippets of the following device models show the definition of the attribute type. This object has two columns of type and:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

下列裝置模型的程式碼片段顯示 屬性類型的定義：

The following device models have code snippets showing the definition of attribute type:

裝置用戶端應傳送 JSON 承載作為裝置對應項中的報告屬性，如下列範例所示：

Device client sends JSON to carry the report properties in the device response, as shown in the following examples:

本節說明裝置從服務接收的可寫入屬性類型範例。

This section describes writeable attributes examples that the device receives from the service.

如果可寫入的屬性是在元件中定義，所需屬性訊息會包含元件名稱。 下列範例顯示要求裝置更新 元件中 的訊息。 標記 表示此區段會定義元件：

If the properties that can be written are defined in a widget, the required attribute message will contain a widget name. The following examples show the messages in the requested device update widget. Mark indicates that this segment will define the widget:

• - 屬性的實際值 (通常接收的值，但裝置可能會決定報告不同的值)。
• - 使用 HTTP 狀態碼的確認代碼。
• - 參考所需屬性 的確認版本。 您可以在所需的屬性 JSON 承載中找到此值。
• - 選擇性確認描述。

下列裝置模型的程式碼片段顯示可寫入 屬性類型的定義：

Snippets of the following device models show the definition of the properties that can be written:

裝置會收到來自服務的下列承載：

The device will receive the following loads from the service:

裝置處理更新之後，應將下列 JSON 承載傳送至服務。 此訊行包含自服務所接收原始更新的版本號碼。

When the device is updated, the following JSON carriers should be sent to the service. This message line contains the original updated version number received by the service.

下列裝置模型的程式碼片段顯示可寫入 屬性類型的定義：

Snippets of the following device models show the definition of the properties that can be written:

裝置會收到來自服務的下列承載：

The device will receive the following loads from the service:

裝置處理更新之後，應將下列 JSON 承載傳送至服務。 此訊行包含自服務所接收原始更新的版本號碼。

When the device is updated, the following JSON carriers should be sent to the service. This message line contains the original updated version number received by the service.

如果命令是在元件中定義，裝置接收的命令名稱包含元件名稱。 例如，如果命令稱為 而元件稱為 ，則裝置會收到執行名為 命令的要求。

If the command is defined in a widget, the command name of the device receiving the command contains the widget name. For example, if the command is called and the widget is called, the device will be required to execute the command by the name of the command.

下列裝置模型的程式碼片段會顯示沒有參數且不會預期裝置傳回任何項目的命令定義：

The following device models have code snippets that show no parameters and do not expect the device to return the definition of the command for any item:

裝置會在要求中收到空白承載並應會在回應中傳回空白承載，其中包含 HTPP 回應碼來表示成功。

The device receives a blank load in the request and responds to the blank load in the response, which contains a HTPP response to indicate success.

下列裝置模型的程式碼片段會顯示具有整數參數且預期裝置傳送整數值的命令定義：

The code snippets of the following device models show the command definition with integer parameters and the expected integer value of the device:

裝置會收到整數值作為要求承載。 裝置應傳回整數值作為回應承載，其中包含 HTTP 回應碼以表示成功。

Device receives integer values as required. The device returns the integer values as a response. It contains a HTTP response to indicate success.

下列裝置模型的程式碼片段顯示具有物件參數且預期裝置傳回物件的命令定義。 在此範例中，兩個物件皆有整數和字串欄位：

The code snippets of the following device models show the command definition of objects with object parameters and the intended device returns the object. In this example, both objects have integer and string fields:

下列程式碼片段顯示傳送至裝置的範例要求承載：

The following examples of code snippets showing the transmission to the device are required to be carried:

下列程式碼片段顯示從裝置傳送的範例回應承載。 使用 HTTP 回應碼來表示成功：

The following code snippets show the examples sent from the device responding to the load. Use the HTTP response to indicate success: