הורדת מדיה

הורדת מדיה שניתנת לחידוש היא תכונה בספריית הלקוח .NET של Google API מגרסת בטא 1.4.0. הספריות הספציפיות ל-Google API מכילות שיטות נוחות לאינטראקציה עם התכונה הזו.

הפרוטוקול להורדת מדיה שניתן לחידוש, דומה לפרוטוקול של העלאת מדיה שניתן לחידוש, שמתואר למשל בדף העלאת המדיה עבור ה-API של Drive.

המחלקה העיקרית שמעניינת אותך היא MediaDownloader. ביישום זה של הורדת מדיה שניתנת לחידוש, תוכן המדיה מורד במקטעים (גודל הגוש ניתן להגדרה).

קוד לדוגמה

אם שיטות בספריות ספציפיות ל-API מכילות את הפרמטר "supportsMediaDownload" במסמך Discovery, שיטות הנוחות Download ו-DownloadAsync זמינות במחלקה של הבקשה. השיטות האלה מורידות את נתוני המדיה לאובייקט Stream שאתם מספקים. לדוגמה:

{
    // Create the service using the client credentials.
    var storageService = new StorageService(new BaseClientService.Initializer()
        {
            HttpClientInitializer = credential,
            ApplicationName = "APP_NAME_HERE"
        });
    // Get the client request object for the bucket and desired object.
    var getRequest = storageService.Objects.Get("BUCKET_HERE", "OBJECT_HERE");
    using (var fileStream = new System.IO.FileStream(
        "FILE_PATH_HERE",
        System.IO.FileMode.Create,
        System.IO.FileAccess.Write))
    {
        // Add a handler which will be notified on progress changes.
        // It will notify on each chunk download and when the
        // download is completed or failed.
        getRequest.MediaDownloader.ProgressChanged += Download_ProgressChanged;
        getRequest.Download(fileStream);
    }
}

static void Download_ProgressChanged(IDownloadProgress progress)
{
    Console.WriteLine(progress.Status + " " + progress.BytesDownloaded);
}