本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在设备中使用 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基于文件传输的错误

针对两者DescribeStream发送到设备的错误响应，GetStreamAPIs其中包含客户端令牌、错误代码和错误消息。典型的错误响应类似于以下示例。

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