Drive and Photo Service:Ikhtisar SDK Android

Integrasikan SDK

Impor SDK menggunakan Gradle.

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

Kode sumber: aliyun-pds-android-sdk.

Inisialisasi

Sebelum menggunakan kit pengembangan perangkat lunak (SDK), pastikan Anda telah mengaktifkan Drive and Photo Service dan membuat instans di Konsol. Untuk informasi selengkapnya, lihat Memulai PDS.

// Dapatkan token akses dari sistem akun Anda. Backend Anda menggunakan AppKey dan AppSecret dari platform PDS untuk meminta token dan mengembalikannya ke client.
val token = SDToken("your access token") 
// Dapatkan host API Anda dari Konsol PDS.
val apiHost = "your API host"            
val config = SDConfig.Builder(token, apiHost, 3600)
    // Menentukan apakah transfer file instan diaktifkan. Default: true. (Opsional)
    .canFastUpload() 
    // User-Agent untuk permintaan. (Opsional)
    .userAgent() 
    // Jumlah maksimum percobaan ulang. Default: 3. (Opsional)
    .maxRetryCount()
    // Menentukan apakah mode debug diaktifkan. Default: false. (Opsional)
    .isDebug()
    // Ukuran shard unduhan. Default: 10 MB. Jangan atur nilai ini terlalu kecil atau terlalu besar. (Opsional)
    .downloadBlockSize() 
    // Ukuran shard unggahan. Default: 4 MB. Jangan atur nilai ini terlalu kecil atau terlalu besar. (Opsional)
    .uploadBlockSize() 
    // Periode timeout untuk menetapkan koneksi jaringan. Default: 15s. (Opsional)
    .connectTimeout()
    // Periode timeout untuk respons koneksi jaringan. Default: 60s. (Opsional)
    .readTimeout()
    // Periode timeout untuk respons transmisi jaringan. Default: 60s. (Opsional)
    .writeTimeout()         
    .build()
SDClient.instance.init(this, config)

Callback progres tugas

// currentSize adalah progres saat ini. Perhatikan bahwa callback tidak berada di thread utama.
interface OnProgressListener {
    fun onProgressChange(currentSize : Long)
}

Callback penyelesaian task

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

Parameter fileMeta berisi informasi file.

class SDFileMeta(
    // ID file.
    val fileId: String?,
    // Nama file.
    val fileName: String?,
    // Path file. Untuk task unggahan, ini adalah path file yang diunggah. Untuk task unduhan, ini adalah path tempat file disimpan.
    val filePath: String?,
    // uploadId untuk task unggahan. Anda dapat mengabaikan ini jika tidak relevan dengan bisnis Anda.
    val uploadId: String? = "" 
)

class SDErrorInfo(
    // Kode kesalahan.
    val code: SDTransferError,
    // Deskripsi kesalahan.
    val message: String,
    // Exception, digunakan untuk melihat stack dan menangani kesalahan.
    val exception: Exception?,
    // Jika terjadi kesalahan permintaan backend, nilai ini dikembalikan untuk membantu troubleshooting.
    var requestId: String? = "" 
)

Kode kesalahan

SDTransferError.Unknown // Kesalahan tidak dikenal.
SDTransferError.Network // Kesalahan jaringan.
SDTransferError.Server // Kesalahan server.
SDTransferError.FileNotExist // Saat unggah, file lokal tidak ditemukan.
SDTransferError.SpaceNotEnough // Saat unduh, storage space lokal tidak mencukupi.
SDTransferError.TmpFileNotExist // Saat unduh, file sementara lokal tidak ada.
SDTransferError.PathRuleError // Saat unduh, aturan path penyimpanan tidak valid.