背景信息

設(shè)備端完成文件上傳能力開(kāi)發(fā)的具體操作，請(qǐng)參見(jiàn)文件上傳（MQTT）。

若選擇將文件上傳至您自己的OSS空間，設(shè)備上傳文件后，您可以在OSS中訪問(wèn)文件。

若將文件上傳至阿里云物聯(lián)網(wǎng)平臺(tái)空間，設(shè)備上傳文件后，您可以在物聯(lián)網(wǎng)平臺(tái)控制臺(tái)查看、下載、刪除文件。具體操作，請(qǐng)參見(jiàn)文件管理。

設(shè)備請(qǐng)求上傳文件

• 請(qǐng)求Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init。
• 響應(yīng)Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/init_reply。

請(qǐng)求數(shù)據(jù)格式：

{
    "id":"123456",
    "params":{
        "fileName":"abc.bin",
        "fileSize":123455,
        "conflictStrategy":"overwrite",
        "ficMode":"crc64",
        "ficValue":"0205d7***",
        "initUid":"ab1***34",
        "extraParams":{
            "ossOwnerType":"device-user",
            "serviceId":"device1.bucket",
            "fileTag":{
                "tagKey1":"tagValu1",
                "tagKey2":"tagValue2"
            }
        }
    }
}

響應(yīng)數(shù)據(jù)格式：

{
    "id": "123456",
    "code": 200,
    "message": "this is error msg when code is not 200",
    "data":{
        "fileName": "abc.bin",
        "uploadId": "03d9151e-6***",
        "offset": 123123
    }
}

設(shè)備上傳文件分片

• 請(qǐng)求Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send。
• 響應(yīng)Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/send_reply。

請(qǐng)求數(shù)據(jù)格式：

• 結(jié)構(gòu)如下圖：

  結(jié)構(gòu)項(xiàng)	說(shuō)明
  Header Length	表示請(qǐng)求Header中JSON字符串對(duì)應(yīng)的字節(jié)數(shù)組長(zhǎng)度，必須占位2個(gè)字節(jié)，高位字節(jié)在前，低位字節(jié)在后。 例如，Header的JSON字符串使用UTF-8編碼轉(zhuǎn)碼成字節(jié)數(shù)組的長(zhǎng)度為十進(jìn)制的87，對(duì)應(yīng)十六進(jìn)制57，則高位字節(jié)為0x00，低位字節(jié)為0x57。
  Header String Bytes	表示請(qǐng)求Header中JSON字符串對(duì)應(yīng)的字節(jié)數(shù)組，編碼格式為UTF-8。具體內(nèi)容，請(qǐng)參見(jiàn)下文的“Header的JSON數(shù)據(jù)格式”。
  File Block Bytes	表示當(dāng)前文件分片的字節(jié)數(shù)組，字節(jié)順序按照相對(duì)于文件頭的偏移量從小至大排列。
  CRC16/IBM	表示文件分片的校驗(yàn)值，僅支持CRC16/IBM，占位2個(gè)字節(jié)，低位字節(jié)在前，高位字節(jié)在后。 例如，文件分片的校驗(yàn)值為0x0809，則低位字節(jié)為0x09，高位字節(jié)為0x08。

• Header的JSON數(shù)據(jù)格式：

  {
      "id":"123456",
      "params":{
          "uploadId":"03d9151e-6***",
          "offset":34344,
          "bSize":123455,
          "isComplete":true
      }
  }

響應(yīng)數(shù)據(jù)格式：

{
    "id":"123456",
    "code":200,
    "message":"this is error msg when code is not 200",
    "data":{
        "uploadId":"03d9151e-6***",
        "offset":34344,
        "bSize":123455,
        "complete":true,
        "ficMode":"crc64",
        "ficValueClient":"0205d7***",
        "ficValueServer":"0205d7***"
    }
}

設(shè)備取消上傳文件

• 請(qǐng)求Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/cancel。
• 響應(yīng)Topic：/sys/${productKey}/${deviceName}/thing/file/upload/mqtt/cancel_reply。

請(qǐng)求數(shù)據(jù)格式：

{
    "id":"123456",
    "params":{
        "uploadId":"03d9151e-6***"
    }
}

響應(yīng)數(shù)據(jù)格式：

{
    "id":"123456",
    "code":200,
    "message":"uploading task for upload-id xxxx does not exist.",
    "data":{
        "uploadId":"03d9151e-6***"
    }
}

相關(guān)文檔

設(shè)備端接收的錯(cuò)誤碼信息，請(qǐng)參見(jiàn)設(shè)備上傳文件相關(guān)錯(cuò)誤碼。