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