Unity के लिए Cloud Storage के साथ फ़ाइल मेटाडेटा का इस्तेमाल करना

Cloud Storage रेफ़रंस में फ़ाइल अपलोड करने के बाद, फ़ाइल का मेटाडेटा भी पाया और अपडेट किया जा सकता है. उदाहरण के लिए, कॉन्टेंट टाइप अपडेट करने के लिए. फ़ाइलों में, अतिरिक्त फ़ाइल मेटाडेटा के साथ कस्टम की/वैल्यू पेयर भी सेव किए जा सकते हैं.

ध्यान दें: डिफ़ॉल्ट रूप से, Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई कार्रवाई करने के लिए, Firebase Authentication को अनुमति की ज़रूरत होती है. कुछ खास मामलों में, पुष्टि किए बिना ऐक्सेस करने की अनुमति देने के लिए, Firebase Security Rules को Cloud Storage में बदला जा सकता है. हालांकि, ज़्यादातर मामलों में, हमारा सुझाव है कि आप ऐक्सेस पर पाबंदी लगाएं और सुरक्षा के सख्त नियम सेट अप करें. ऐसा खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए करें. ध्यान दें कि अगर Google App Engine का इस्तेमाल किया जाता है और आपके पास *.appspot.com नाम वाले फ़ॉर्मैट वाली डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि आपके सुरक्षा नियम, App Engine फ़ाइलों के ऐक्सेस पर कैसे असर डालते हैं.

फ़ाइल का मेटाडेटा पाना

फ़ाइल के मेटाडेटा में Name, SizeBytes, और ContentType जैसी सामान्य प्रॉपर्टी होती हैं. इन्हें अक्सर MIME टाइप कहा जाता है. इसके अलावा, ContentDisposition और CreationTimeMillis जैसी कुछ कम सामान्य प्रॉपर्टी भी होती हैं. इस मेटाडेटा को GetMetadataAsync तरीके का इस्तेमाल करके, Cloud Storage रेफ़रंस से वापस पाया जा सकता है.

// Create reference to the file whose metadata we want to retrieve
StorageReference forestRef =
    storageRef.Child("images/forest.jpg");

// Get metadata properties
forestRef.GetMetadataAsync().ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // do stuff with meta
    }
});

फ़ाइल का मेटाडेटा अपडेट करना

फ़ाइल अपलोड होने के बाद, किसी भी समय फ़ाइल का मेटाडेटा अपडेट किया जा सकता है. इसके लिए, UpdateMetadataAsync तरीके का इस्तेमाल करें. यह तरीका MetadataChange ऑब्जेक्ट लेता है. किन प्रॉपर्टी को अपडेट किया जा सकता है, इस बारे में ज़्यादा जानकारी के लिए पूरी सूची देखें. मेटाडेटा में बताई गई प्रॉपर्टी ही अपडेट की जाती हैं. बाकी सभी प्रॉपर्टी में कोई बदलाव नहीं किया जाता.

// Create reference to the file whose metadata we want to change
StorageReference forestRef = storageRef.Child("images/forest.jpg");

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.CacheControl = "public,max-age=300";
newMetadata.ContentType = "image/jpeg";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        // access the updated meta data
        StorageMetadata meta = task.Result;
    }
});

खाली स्ट्रिंग पास करके, लिखने लायक मेटाडेटा प्रॉपर्टी मिटाई जा सकती हैं:

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.ContentType = "";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // meta.ContentType should be an empty string now
    }
});

गड़बड़ियां ठीक करना

मेटाडेटा पाने या अपडेट करने पर गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना या उपयोगकर्ता के पास अपनी पसंद की फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी पाने के लिए, दस्तावेज़ों के गड़बड़ियों को मैनेज करें सेक्शन पर जाएं.

कस्टम मेटाडेटा

कस्टम मेटाडेटा को Dictionary<string, string> के तौर पर सेट किया जा सकता है.

var newMetadata = new MetadataChange {
    CustomMetadata = new Dictionary<string, string> {
        {"location", "Yosemite, CA, USA"},
        {"activity", "Hiking"}
    }
};

// UpdateMetadataAsync

कस्टम मेटाडेटा में, हर फ़ाइल के लिए ऐप्लिकेशन से जुड़ा डेटा सेव किया जा सकता है. हालांकि, हमारा सुझाव है कि इस तरह के डेटा को सेव और सिंक करने के लिए, किसी डेटाबेस (जैसे, Firebase Realtime Database) का इस्तेमाल करें.

फ़ाइल मेटाडेटा प्रॉपर्टी

किसी फ़ाइल में मौजूद मेटाडेटा प्रॉपर्टी की पूरी सूची यहां दी गई है:

प्रॉपर्टी	टाइप	MetadataChange में बदलाव किया जा सकता है
Bucket	string	नहीं
Generation	string	नहीं
MetadataGeneration	string	नहीं
Path	string	नहीं
Name	string	नहीं
SizeBytes	long	नहीं
CreationTimeMillis	long	नहीं
UpdatedTimeMillis	long	नहीं
CacheControl	string	YES
ContentDisposition	string	YES
ContentEncoding	string	YES
ContentLanguage	string	YES
ContentType	string	YES
DownloadUrl	Uri	नहीं
DownloadUrls	IList<Uri>	नहीं
CustomMetadataKeys	IEnumerable<string>	YES

अगले चरण

फ़ाइलों को अपलोड करना, डाउनलोड करना, और अपडेट करना ज़रूरी है. हालांकि, उन्हें हटाना भी उतना ही ज़रूरी है. आइए, Cloud Storage से फ़ाइलें मिटाने का तरीका जानें.