بارگذاری رسانه

چندین روش میانای برنامه‌سازی کاربردی علاوه‌بر بدنه معمولی از بارگذاری رسانه پشتیبانی می‌کنند. در این حالت، روش درخواست معمولی برای دریافت Stream اضافی برای بارگذاری بیش‌ازحد بارگذاری می‌شود.

نمای کلی

برای هر Stream که می‌خواهید بارگذاری کنید، باید از بارگذاری رسانه قابل ازسرگیری استفاده کنید که امکان بارگذاری جاری‌سازی‌ها را در بخش‌های کوچک‌تر فراهم می‌کند. این ویژگی به‌ویژه زمانی مفید است که فایل‌های بزرگ را منتقل می‌کنید و احتمال قطع شدن شبکه یا برخی دیگر از خرابی‌های انتقال بالا است. همچنین می‌تواند مصرف پهنای باند شما را درصورت خرابی شبکه کاهش دهد زیرا مجبور نیستید بارگذاری فایل‌های بزرگ را از ابتدا بازراه‌اندازی کنید.

ResumableMediaUpload

«بارگذاری رسانه ازسرگرفتنی» از نسخه بتا ۱ .۲.۰ یکی از ویژگی‌های کتابخانه کارخواه Google API.NET بوده است. کتابخانه‌های مختص Google API حاوی روش‌های راحتی برای تعامل با این ویژگی هستند.

پروتکل بارگذاری رسانه ازسرگرفتنی، برای مثال، در صفحه بارگذاری رسانه برای Drive API شرح داده شده است. کلاس اصلی موردنظر ResumableUpload است. در این پیاده‌سازی، محتوای رسانه به‌صورت تکه‌تکه بارگذاری می‌شود.

اندازه پیش‌فرض تکه ۱۰ مگابایت است، اما می‌توانید آن را با تنظیم ویژگی ChunkSize در درخواست به هر مضربی از ۲۵۶ کیلوبایت تغییر دهید. اگر در درخواستی خطای سرور رخ دهد، از خط‌مشی عقب‌نشینی نمایی برای ارسال مجدد بایت‌هایی که با موفقیت بارگذاری نشده‌اند استفاده می‌شود. به‌طور پیش‌فرض، عقب‌گرد نمایی برای هر درخواست مشتری فعال است. می‌توانید رفتار پیش‌فرض را هنگام ساختن یک شیء سرویس جدید با تغییر دادن DefaultExponentialBackOffPolicy ویژگی در BaseClientService.Initializer و/یا تنظیم کردن HttpClientInitializer ویژگی برای پیاده‌سازی خودتان از IConfigurableHttpClientInitializer که برخی خط‌مشی‌های عقب‌نشینی را اضافه می‌کند تغییر دهید.

روش‌هایی که از بارگذاری رسانه پشتیبانی می‌کنند در اسناد مرجع برای اسناد خاص API شناسایی می‌شوند. برای این روش‌های API، روش‌های راحتی Upload و UploadAsync اضافه شده‌اند. این روش‌ها Stream را برای بارگذاری و نوع محتوای آن را به‌عنوان پارامتر درنظر می‌گیرند.

مطمئن شوید که موقعیت جریانی که بارگذاری می‌کنید 0 باشد، درغیراین‌صورت خطایی دریافت خواهید کرد، مانند «System.InvalidOperationException: سرصفحه داده‌شده پیدا نشد».

توجه داشته باشید که به‌دلیل رفتار کلاس HttpClient چارچوب، اگر بارگذاری با اتمام مهلت مواجه شود، TaskCanceledException ایجاد می‌شود. اگر این استثنا را می‌بینید، ویژگی Timeout را به‌صورت دستی در کارخواه مورداستفاده شیء سرویس خود افزایش دهید.

کد نمونه

// Create the service using the client credentials.
var service = new DriveService(new BaseClientService.Initializer()
{
    HttpClientInitializer = credential,
    ApplicationName = "Application_Name"
});

using var uploadStream = System.IO.File.OpenRead("Local_File_Name");

// Create the File resource to upload.
Google.Apis.Drive.v3.Data.File driveFile = new Google.Apis.Drive.v3.Data.File
{
    Name = "Drive_File_Name"
};
// Get the media upload request object.
FilesResource.CreateMediaUpload insertRequest = service.Files.Create(
    driveFile, uploadStream, "image/jpeg");

// Add handlers which will be notified on progress changes and upload completion.
// Notification of progress changed will be invoked when the upload was started,
// on each upload chunk, and on success or failure.
insertRequest.ProgressChanged += Upload_ProgressChanged;
insertRequest.ResponseReceived += Upload_ResponseReceived;

await insertRequest.UploadAsync();

static void Upload_ProgressChanged(IUploadProgress progress) =>
    Console.WriteLine(progress.Status + " " + progress.BytesSent);

static void Upload_ResponseReceived(Google.Apis.Drive.v3.Data.File file) =>
    Console.WriteLine(file.Name + " was uploaded successfully");