本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在裝置中使用 AWS IoT MQTT型檔案交付

如要啟動資料傳輸程序，裝置必須接收初始資料集，其至少包含串流 ID。在任務文件中含括初始資料集，您可使用 AWS IoT 任務 來排程裝置的資料傳輸任務。當裝置收到初始資料集時，應該開始與 AWS IoT MQTT型檔案交付的互動。若要與 AWS IoT MQTT型檔案交付交換資料，裝置應：

您可選擇性地在初始資料集中包含串流檔案 ID 和串流版本。將串流檔案 ID 傳送至裝置可簡化裝置韌體/軟體的程式設計，因為其不需要提出 DescribeStream 請求來取得此 ID。裝置可指定 GetStream 請求中的串流版本，強制執行一致性檢查，以防串流意外更新。

使用 DescribeStream 取得串流資料

AWS IoT MQTT型檔案交付提供DescribeStreamAPI將串流資料傳送至裝置的 。由此傳回的串流資料API包括串流 ID、串流版本、串流描述和串流檔案清單，每個檔案都具有檔案 ID 和以位元組為單位的檔案大小。裝置可利用此資訊來選取任意檔案以啟動資料傳輸程序。

請依照下列步驟提出 DescribeStream 請求。

DescribeStream 請求

中的典型DescribeStream請求JSON如下所示。

{
    "c": "ec944cfb-1e3c-49ac-97de-9dc4aaad0039"
}

DescribeStream 回應

中的DescribeStream回應JSON如下所示。

{
    "c": "ec944cfb-1e3c-49ac-97de-9dc4aaad0039",
    "s": 1,
    "d": "This is the description of stream ABC.",
    "r": [
        {
            "f": 0,
            "z": 131072
        },
        {
            "f": 1,
            "z": 51200
        }
    ]
}

從串流檔案取得資料區塊

您可以使用 ，GetStreamAPI讓裝置可以在小型資料區塊中接收串流檔案，因此可以讓對處理大型區塊大小有限制的裝置使用。如要接收整個資料檔案，裝置可能需要傳送或接收多個請求和回應，直至所有資料區塊已接收並加以處理為止。

GetStream 請求

請依照下列步驟提出 GetStream 請求。

中的典型GetStream請求JSON如下所示。

{
    "c": "1bb8aaa1-5c18-4d21-80c2-0b44fee10380",
    "s": 1,
    "f": 0,
    "l": 4096,
    "o": 2,
    "n": 100,
    "b": "..."
}

GetStream 回應

對於請求的每個資料區塊， 中的GetStream回應JSON看起來像此範例。

{
    "c": "1bb8aaa1-5c18-4d21-80c2-0b44fee10380",
    "f": 0,
    "l": 4096,
    "i": 2,
    "p": "..."
}

建立 GetStream 請求的點陣圖

您可使用 GetStream 請求中的點陣圖欄位 (b)，從串流檔案獲取非連續區塊。這有助於RAM容量有限的裝置處理網路交付問題。裝置僅能請求那些未接收或未正確接收的區塊。點陣圖決定將會傳回的串流檔案區塊。對於點陣圖中設定為 1 的每個位元，會傳回串流檔案相對應的區塊。

下列範例說明如何在 GetStream 請求中指定點陣圖及其支援欄位。例如，您想要以 256 個位元組 (區塊大小) 的區塊接收串流檔案。將每個 256 個位元組的區塊視為具有一個數字，指定其在檔案中的位置，從 0 開始。所以區塊 0 是檔案中第一個 256 個位元組的區塊，區塊 1 是第二個區塊，依此類推。您想要從該檔案請求區塊 20、21、24 和 43。

處理 AWS IoT MQTT型檔案交付的錯誤

同時傳送至裝置的錯誤回應，DescribeStreamGetStreamAPIs其中包含用戶端權杖、錯誤碼和錯誤訊息。典型的錯誤回應看似下列範例所示。

{
    "o": "BlockSizeOutOfBounds", 
    "m": "The block size is out of bounds", 
    "c": "1bb8aaa1-5c18-4d21-80c2-0b44fee10380" 
}