Verwenden Sie Dateimetadaten mit Cloud Storage for Unity

Nach dem Hochladen einer Datei in die Cloud Storage-Referenz können Sie auch die Dateimetadaten abrufen und aktualisieren, um beispielsweise den Inhaltstyp zu aktualisieren. Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten speichern.

Dateimetadaten abrufen

Dateimetadaten enthalten allgemeine Eigenschaften wie Name , SizeBytes und ContentType (häufig als MIME-Typ bezeichnet) zusätzlich zu einigen weniger häufigen Eigenschaften wie ContentDisposition und CreationTimeMillis . Diese Metadaten können mit der Methode GetMetadataAsync 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 Dateimetadaten jederzeit aktualisieren, nachdem der Dateiupload abgeschlossen ist, indem Sie die UpdateMetadataAsync Methode verwenden, die ein MetadataChange -Objekt annimmt. Weitere Informationen dazu, welche Eigenschaften aktualisiert werden können, finden Sie in der vollständigen Liste . Nur die in den Metadaten angegebenen Eigenschaften 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 Metadateneigenschaften löschen, indem Sie die leere Zeichenfolge ü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
    }
});

Fehler behandeln

Es gibt eine Reihe von Gründen, warum beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten können, einschließlich der Datei, die nicht vorhanden ist, oder des Benutzers, der keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehler behandeln 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, aber wir empfehlen dringend, eine Datenbank (z. B. die Firebase Realtime Database ) zu verwenden, um diese Art von Daten zu speichern und zu synchronisieren.

Datei-Metadaten-Eigenschaften

Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:

Eigentum Typ Veränderbar in MetadataChange
Bucket string NEIN
Generation string NEIN
MetadataGeneration string NEIN
Path string NEIN
Name string NEIN
SizeBytes long NEIN
CreationTimeMillis long NEIN
UpdatedTimeMillis long NEIN
CacheControl string JA
ContentDisposition string JA
ContentEncoding string JA
ContentLanguage string JA
ContentType string JA
DownloadUrl Uri NEIN
DownloadUrls IList<Uri> NEIN
CustomMetadataKeys IEnumerable<string> JA

Nächste Schritte

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch die Möglichkeit, sie zu entfernen. Lassen Sie uns lernen, wie Sie Dateien aus Cloud Storage löschen .