'Firebase के लिए Cloud Storage' की मदद से, 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 में सेव की गई फ़ाइलों के लिए, मेटाडेटा को डाउनलोड और अपडेट किया जा सकता है.