Drive and Photo Service：Android SDK 簡介

接入 SDK

通過gradle引入SDK。

implementation 'com.aliyun.pds:android-sdk:0.1.4'

源碼地址 aliyun-pds-android-sdk。

初始化

在使用SDK之前，請確保您已經開通PDS服務，並且在控制台建立了執行個體，參見開始使用 PDS。

// 這個通用流程是你們登入自己的帳號系統後擷取，後端使用 PDS 平台申請的 appKey & appSecret 換取 token 返回給用戶端
val token = SDToken("you access token") 
// 請在PDS控制台擷取您的 api host
val apiHost = "you api host"            
val config = SDConfig.Builder(token, apiHost, 3600)
    // 是否支援妙傳，預設true (選填)
    .canFastUpload() 
    // 請求的ua (選填)
    .userAgent() 
    // 最大重試次數,預設3  (選填)
    .maxRetryCount()
    // 是否開啟偵錯模式,預設false (選填)
    .isDebug()
    // 下載分區大小,預設10M,不要填過小或者過大(選填)
    .downloadBlockSize() 
    // 上傳分區大小,預設4M,不要填過小或者過大(選填)
    .uploadBlockSize() 
    // 建立網路連接逾時設定,預設15s (選填)
    .connectTimeout()
    // 網路連接響應逾時設定,預設60s (選填)
    .readTimeout()
    // 網路傳輸響應逾時設定,預設60s (選填)
    .writeTimeout()         
    .build()
SDClient.instance.init(this, config)

任務進度回調

// currentSize 為當前的進度，注意回調不在主線程
interface OnProgressListener {
    fun onProgressChange(currentSize : Long)
}

任務結束回調

interface OnCompleteListener {
    fun onComplete(taskId: String, fileMeta : SDFileMeta, errorInfo: SDErrorInfo?)
}

其中fileMeta 為檔案相關資訊

class SDFileMeta(
    // 檔案id
    val fileId: String?,
    // 檔案名稱
    val fileName: String?,
    // 檔案路徑，上傳任務為要上傳檔案的路徑，下載任務為檔案儲存路徑
    val filePath: String?,
    // 上傳任務的 uploadId，不涉及相關業務可以忽略
    val uploadId: String? = "" 
)

class SDErrorInfo(
    // 相關錯誤碼
    val code: SDTransferError,
    // 錯誤描述
    val message: String,
    // 異常，用於查看堆棧, 以及錯誤處理
    val exception: Exception?,
    // 如果是後端請求相關錯誤，則會有該值用於和後端排查問題
    var requestId: String? = "" 
)

錯誤碼說明

SDTransferError.Unknown // 未知錯誤
SDTransferError.Network // 網路錯誤
SDTransferError.Server // 伺服器錯誤
SDTransferError.FileNotExist // 上傳時，本地檔案沒有找到
SDTransferError.SpaceNotEnough // 下載時，本地空間不足
SDTransferError.TmpFileNotExist // 下載時，本地臨時檔案不存在
SDTransferError.PathRuleError // 下載時，儲存路徑規則錯誤