Cloud Storage for Firebase की मदद से, Firebase की ओर से उपलब्ध कराई गई और मैनेज की जाने वाली Cloud Storage बकेट से, फ़ाइलों को तुरंत और आसानी से डाउनलोड किया जा सकता है.
रेफ़रंस बनाना
किसी फ़ाइल को डाउनलोड करने के लिए, सबसे पहले उस फ़ाइल का Cloud Storage रेफ़रंस बनाएं जिसे डाउनलोड करना है.
Cloud Storage बकेट के रूट में चाइल्ड पाथ जोड़कर रेफ़रंस बनाया जा सकता है. इसके अलावा, Cloud Storage में मौजूद किसी ऑब्जेक्ट का रेफ़रंस देने वाले किसी मौजूदा gs:// या https:// यूआरएल से भी रेफ़रंस बनाया जा सकता है.
// Create a reference with an initial file path and name
StorageReference pathReference =
storage.GetReference("images/stars.jpg");
// Create a reference from a Google Cloud Storage URI
StorageReference gsReference =
storage.GetReferenceFromUrl("gs://bucket/images/stars.jpg");
// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
StorageReference httpsReference =
storage.GetReferenceFromUrl("https://firebasestorage.googleapis.com/b/bucket/o/images%20stars.jpg");
फ़ाइलें डाउनलोड करना
रेफ़रंस मिलने के बाद, Cloud Storage से फ़ाइलें चार तरीकों से डाउनलोड की जा सकती हैं:
- किसी यूआरएल से डाउनलोड करना
- बाइट कलेक्शन में डाउनलोड करना
- स्ट्रीम की मदद से डाउनलोड करना
- किसी लोकल फ़ाइल में डाउनलोड करना
फ़ाइलों को वापस पाने का तरीका इस बात पर निर्भर करेगा कि आपको अपने गेम में डेटा का इस्तेमाल कैसे करना है.
किसी यूआरएल से डाउनलोड करना
अगर आपको Unity के WWW या UnityWebRequest के साथ यूआरएल का इस्तेमाल करना है, तो GetDownloadUrlAsync() को कॉल करके, किसी फ़ाइल का डाउनलोड यूआरएल पाया जा सकता है.
// Fetch the download URL
reference.GetDownloadUrlAsync().ContinueWithOnMainThread(task => {
if (!task.IsFaulted && !task.IsCanceled) {
Debug.Log("Download URL: " + task.Result);
// ... now download the file via WWW or UnityWebRequest.
}
});
बाइट कलेक्शन में डाउनलोड करना
GetBytesAsync() तरीके का इस्तेमाल करके, फ़ाइल को मेमोरी में बाइट बफ़र में डाउनलोड किया जा सकता है.
इस तरीके से, आपकी फ़ाइल का पूरा कॉन्टेंट मेमोरी में लोड हो जाएगा.
अगर आपने ऐसी फ़ाइल का अनुरोध किया है जिसका साइज़, आपके ऐप्लिकेशन में उपलब्ध मेमोरी से ज़्यादा है, तो आपका ऐप्लिकेशन क्रैश हो जाएगा.
मेमोरी से जुड़ी समस्याओं से बचने के लिए, ऐप्लिकेशन के लिए डाउनलोड किए जाने वाले डेटा का ज़्यादा से ज़्यादा साइज़, उतना ही सेट करें जितना आपके ऐप्लिकेशन के लिए सही हो. इसके अलावा, डाउनलोड करने का कोई दूसरा तरीका भी इस्तेमाल किया जा सकता है.
// Download in memory with a maximum allowed size of 1MB (1 * 1024 * 1024 bytes)
const long maxAllowedSize = 1 * 1024 * 1024;
reference.GetBytesAsync(maxAllowedSize).ContinueWithOnMainThread(task => {
if (task.IsFaulted || task.IsCanceled) {
Debug.LogException(task.Exception);
// Uh-oh, an error occurred!
}
else {
byte[] fileContents = task.Result;
Debug.Log("Finished downloading!");
}
});
स्ट्रीम के ज़रिए डाउनलोड करना
स्ट्रीम की मदद से फ़ाइल डाउनलोड करने पर, डेटा लोड होने के साथ-साथ उसे प्रोसेस किया जा सकता है.
इससे, डाउनलोड करने के दौरान आपको ज़्यादा सुविधाएं मिलती हैं. GetStreamAsync() को कॉल करें और पहले आर्ग्युमेंट के तौर पर अपना स्ट्रीम प्रोसेसर पास करें.
इस डेलिगेट को स्ट्रीम के साथ बैकग्राउंड थ्रेड पर कॉल किया जाएगा. इससे, आपको डिस्क पर कॉन्टेंट सेव करने जैसे ज़्यादा इंतज़ार वाले ऑपरेशन या कैलकुलेशन करने की सुविधा मिलती है.
// Download via a Stream
reference.GetStreamAsync(stream => {
// Do something with the stream here.
//
// This code runs on a background thread which reduces the impact
// to your framerate.
//
// If you want to do something on the main thread, you can do that in the
// progress eventhandler (second argument) or ContinueWith to execute it
// at task completion.
}, null, CancellationToken.None);
GetStreamAsync(), स्ट्रीम प्रोसेसर के बाद वैकल्पिक आर्ग्युमेंट लेता है. इनकी मदद से, प्रोसेस को रद्द किया जा सकता है या प्रोसेस की स्थिति की सूचना मिल सकती है.
किसी लोकल फ़ाइल में डाउनलोड करना
GetFileAsync() तरीके से, फ़ाइल को सीधे किसी लोकल डिवाइस पर डाउनलोड किया जाता है. अगर आपके उपयोगकर्ताओं को ऑफ़लाइन रहने के दौरान फ़ाइल का ऐक्सेस चाहिए या किसी दूसरे ऐप्लिकेशन में फ़ाइल शेयर करनी है, तो इसका इस्तेमाल करें.
// Create local filesystem URL
string localUrl = "file:///local/images/island.jpg";
// Download to the local filesystem
reference.GetFileAsync(localUrl).ContinueWithOnMainThread(task => {
if (!task.IsFaulted && !task.IsCanceled) {
Debug.Log("File downloaded.");
}
});
डाउनलोड की प्रोग्रेस पर नज़र रखने के लिए, डाउनलोड किए जा रहे एपिसोड के साथ दर्शकों को अटैच किया जा सकता है. लिसनर, स्टैंडर्ड System.IProgress<T>
इंटरफ़ेस का इस्तेमाल करता है. प्रोग्रेस टिक के लिए कॉलबैक के तौर पर अपना Action<T> उपलब्ध कराने के लिए, StorageProgress क्लास के किसी इंस्टेंस का इस्तेमाल किया जा सकता है.
// Create local filesystem URL
string localUrl = "file:///local/images/island.jpg";
// Start downloading a file
Task task = reference.GetFileAsync(localFile,
new StorageProgress<DownloadState>(state => {
// called periodically during the download
Debug.Log(String.Format(
"Progress: {0} of {1} bytes transferred.",
state.BytesTransferred,
state.TotalByteCount
));
}), CancellationToken.None);
task.ContinueWithOnMainThread(resultTask => {
if (!resultTask.IsFaulted && !resultTask.IsCanceled) {
Debug.Log("Download finished.");
}
});
गड़बड़ियां ठीक करना
डाउनलोड करते समय गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना या उपयोगकर्ता के पास फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी पाने के लिए, दस्तावेज़ों के गड़बड़ियों को मैनेज करें सेक्शन पर जाएं.
अगले चरण
Cloud Storage में सेव की गई फ़ाइलों के लिए, मेटाडेटा पाया और अपडेट भी जा सकता है.