Menggunakan S3 Transfer Utility - AWS Mobile SDK
InisialisasiTransferUtility(opsional) MengonfigurasiTransferUtilityMengunduh FileMeng-unggah sebuah file

AWS Mobile SDK for Xamarin sekarang disertakan dalam AWS SDK for .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Xamarin.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan S3 Transfer Utility

S3 Transfer Utility memudahkan kita untuk mengunggah dan mengunduh file ke S3 dari aplikasi Xamarin Anda.

InisialisasiTransferUtility

Buat klien S3, berikan objek kredensial AWS Anda pada klien tersebut, dan kemudian berikan klien S3 ke utilitas transfer, seperti ini:

var s3Client = new AmazonS3Client(credentials,region);
var transferUtility = new TransferUtility(s3Client);

(opsional) MengonfigurasiTransferUtility

Ada tiga properti opsional yang dapat Anda konfigurasi:

  • ConcurrentServicePermintaan- Menentukan berapa banyak utas aktif atau jumlah permintaan web bersamaan tak serempak yang akan digunakan untuk meng-unggah/mengunduh file. Nilai default adalah 10.

  • MinSizeBeforePartUnggah- Mendapat atau menetapkan ukuran bagian minimum untuk meng-unggah bagian dalam byte. Ukuran default-nya adalah 16 MB. Mengurangi ukuran bagian minimum menyebabkan unggahan multipart dibagi menjadi lebih banyak bagian yang lebih kecil. Mengatur nilai ini terlalu rendah akan mengakibatkan efek negatif terhadap kecepatan transfer, menyebabkan latensi tambahan dan komunikasi jaringan untuk setiap bagian.

  • NumberOfUploadThreads- Mendapat atau menetapkan jumlah utas yang menjalankan. Properti ini menentukan berapa banyak utas aktif yang akan digunakan untuk meng-unggah file. Nilai default-nya adalah 10 utas.

Untuk mengonfigurasi S3TransferUtilityklien, buat objek config, atur properti Anda, dan berikan objek untukTransferUtilitykonstruktor seperti:

var config = new TransferUtilityConfig();

config.ConcurrentServiceRequests = 10;
config.MinSizeBeforePartUpload=16*1024*1024;
config.NumberOfUploadThreads=10;

var s3Client = new AmazonS3Client(credentials);
var utility = new TransferUtility(s3Client,config);

Mengunduh File

Untuk mengunduh file dari S3, panggil Download pada objek Transfer Utility, yang memberikan parameter berikut:

  • file - Nama string dari file yang ingin Anda unduh

  • bucketName - Nama string dari bucket S3 tempat Anda ingin mengunduh file

  • key - Sebuah string yang mewakili nama objek S3 (dalam kasus ini, sebuah file) yang akan diunduh

transferUtility.Download(
  Path.Combine(Environment.SpecialFolder.ApplicationData,"file"),
  "bucketName",
  "key"
);

Meng-unggah sebuah file

Untuk meng-unggah file ke S3, panggil Upload pada objek Transfer Utility, yang memberikan parameter berikut:

  • file - Nama string dari file yang ingin Anda unggah

  • bucketName - Nama string dari bucket S3 untuk menyimpan file

transferUtility.Upload(
  Path.Combine(Environment.SpecialFolder.ApplicationData,"file"),
  "bucketName"
);

Kode di atas mengasumsikan bahwa ada file dalam direktori Environment.SpecialFolder.ApplicationData. Unggahan secara otomatis menggunakan fungsionalitas unggah multi-bagian S3 pada file large untuk meningkatkan throughput.