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

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

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

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

// 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) का इस्तेमाल करें.

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

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

प्रॉपर्टी टाइप Modifyable in 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 से फ़ाइलें मिटाने का तरीका जानें.