Dateimetadaten mit Cloud Storage for Unity verwenden

Nachdem Sie eine Datei in Cloud Storage hochgeladen haben, können Sie auch die Metadaten der Datei abrufen und aktualisieren, z. B. um den Inhaltstyp zu aktualisieren. In Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten gespeichert werden.

Dateimetadaten abrufen

Dateimetadaten enthalten neben einigen weniger häufigen Attributen wie ContentDisposition und CreationTimeMillis auch allgemeine Attribute wie Name, SizeBytes und ContentType (oft als MIME-Typ bezeichnet). Diese Metadaten können mit der GetMetadataAsync Methode aus einer Cloud Storage Referenz abgerufen werden.

// 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
    }
});

Dateimetadaten aktualisieren

Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads mit der Methode UpdateMetadataAsync aktualisieren, die ein MetadataChange-Objekt verwendet. Eine vollständige Liste der aktualisierbaren Attribute finden Sie hier. Nur die in den Metadaten angegebenen Attribute werden aktualisiert. Alle anderen bleiben unverändert.

// 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;
    }
});

Sie können beschreibbare Metadatenattribute löschen, indem Sie den leeren String übergeben:

// 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
    }
});

Fehlerbehebung

Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können. Dazu gehören beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung für den Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehlerbehebung in der Dokumentation.

Benutzerdefinierte Metadaten

Sie können benutzerdefinierte Metadaten als Dictionary<string, string> angeben.

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

// UpdateMetadataAsync

Sie können app-spezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank (z. B. die Firebase Realtime Database) zum Speichern und Synchronisieren dieser Art von Daten zu verwenden.

Attribute von Dateimetadaten

Eine vollständige Liste der Metadatenattribute für eine Datei finden Sie unten:

Nächste Schritte

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch das Entfernen von Dateien. Hier erfahren Sie, wie Sie Dateien löschen aus Cloud Storage.