創建上傳文件到服務器任務 · anychat_sdk_java_doc

### **創建上傳文件任務** AnyChatUploadTask.createFileUploadTask(AnyChatFileUploadOpt uploadOpt, AnyChatFileUploadEvent e) #### 接口說明：創建文件上傳到服務器的任務（注：需要初始化） #### 返回值：上傳任務對象 #### 接口參數簡介： | 名稱 | 類型 | 說明 | 是否必須 | | --- | --- | --- | --- | | uploadOpt| AnyChatFileUploadOpt | 文件上傳配置類 | 是 | | e | AnyChatFileUploadEvent | 文件上傳狀態與結果回調 | 是 | #### AnyChatFileUploadOpt 文件上傳配置類簡介： | 名稱 | 類型 | 說明 | 是否必須 | | --- | --- | --- | --- | | localPath| String| 要上傳文件的絕對路徑 | 是 | | intervalTime| int| 返回文件上傳狀態時間間隔，單位：s | 否 | | filename| Stringt | 指定文件上傳后的目標文件名 | 否 | | category| String | 表示文件上傳分類子目錄,通過設置改字段可將文件上傳到不同分類子目錄中 | 否 | | encryptionKey| String | 上傳一個已加密錄像視頻文件(參考錄制章節)，在上傳到服務器時，該文件將自動被解密。根據加密的錄像視頻文件的加密秘鑰，設置相同的解密密鑰 | 否 | | strJson | String | 文件上傳用戶自定義參數(標準json字符串形式) | 否 | #### AnyChatUploadTask任務類簡介： | 方法 | 說明 | 返回參數 | | --- | --- | --- | | start（） | 開始傳輸 | void | | cancel（） | 取消傳輸 | void | | getStatus（） | 主動查詢發送狀態 | AnyChatTaskState 對象 AnyChatTaskState.process 傳輸進度 (0.0-100.0) AnyChatTaskState.bitRate 傳輸碼率,單位為 bps AnyChatTaskState.status 1--準備; 2--傳輸中; 3--完成; 4--任務被取消 | #### AnyChatFileUploadEvent回調簡介： | 返回值 | 名稱 | 參數(類型):說明 | 接口說明 | 備注 | | --- | --- | --- | --- | --- | | void | onFileUploadDone | result(AnyChatResult) :執行結果 JsonData(JSONObject):返回數據 | 文件上傳成功通知事件 | AnyChatResult.code: 0表示成功，其他表示錯誤代號 AnyChatResult.msg: 錯誤描述 JsonData.getString("fileName"):文件名 JsonData.getInt("dwUserid"): 用戶id,指示發送用戶 JsonData.getString("TempFilePath"):接收完成后，SDK 保存在本地的臨時文件（包含完整路徑） JsonData.getInt("dwFileLength"):文件總長度 JsonData.getInt("dwTaskId"):該文件所對應的任務編號 | | void | OnTaskStatusChanged | JsonData(JSONObject):返回數據 |文件上傳過程狀態通知事件 |JsonData.getString("taskId") 任務ID JsonData.getInt("process") 傳輸進度 (0.0-100.0) JsonData.getInt("bitRate") 傳輸碼率,單位為 bps JsonData.getInt("status") 1--準備; 2--傳輸中; 3--完成; 4--任務被取消 | #### 示例代碼： ``` //文件上傳配置類 AnyChatFileUploadOpt uploadOpt = new AnyChatFileUploadOpt(); //設置上傳文件的絕對路徑信息 uploadOpt.setLocalPath(filePath); //設置返回文件上傳狀態時間間隔，單位：s uploadOpt.setIntervalTime(1); //創建文件上傳任務 AnyChatUploadTask uploadTask = (AnyChatUploadTask) instance.createFileUploadTask(uploadOpt, new AnyChatFileUploadEvent() { @Override public void onFileUploadDone(AnyChatResult result, JSONObject json) { } @Override public void OnTaskStatusChanged(JSONObject json) { } }); //開始上傳 uploadTask.start(); ```