Dateimetadaten mit Cloud Storage for Unity verwenden

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

Hinweis: Standardmäßig benötigt ein Cloud Storage for Firebase-Bucket Firebase Authentication, um Aktionen für die Daten oder Dateien des Buckets auszuführen. Sie können Firebase Security Rules in Cloud Storage ändern, um den nicht authentifizierten Zugriff für bestimmte Situationen zuzulassen. In den meisten Fällen empfehlen wir jedoch dringend, den Zugriff einzuschränken und robuste Sicherheitsregeln einzurichten, insbesondere bei Produktions-Apps. Wenn Sie Google App Engine verwenden und einen Standard-Cloud Storage-Bucket mit dem Namensformat *.appspot.com haben, müssen Sie möglicherweise berücksichtigen, wie sich Ihre Sicherheitsregeln auf den Zugriff auf App Engine-Dateien auswirken.

Dateimetadaten abrufen

Dateimetadaten enthalten neben einigen weniger gängigen Attributen wie ContentDisposition und CreationTimeMillis auch allgemeine Attribute wie Name, SizeBytes und ContentType (oft als MIME-Typ bezeichnet). 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 die Dateimetadaten jederzeit nach Abschluss des Dateiuploads aktualisieren. Dazu verwenden Sie die Methode UpdateMetadataAsync, die ein MetadataChange-Objekt verwendet. Weitere Informationen zu den Attributen, die aktualisiert werden können, finden Sie in der vollständigen Liste. Nur die in den Metadaten angegebenen Properties 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 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
    }
});

Fehler beheben

Es kann verschiedene Gründe dafür geben, dass beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten. Dazu gehört beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie im Abschnitt Fehler beheben 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 appspezifische Daten für jede Datei in benutzerdefinierten Metadaten speichern. Wir empfehlen jedoch dringend, eine Datenbank wie Firebase Realtime Database zu verwenden, um diese Art von Daten zu speichern und zu synchronisieren.

Eigenschaften von Dateimetadaten

Unten findest du eine vollständige Liste der Metadateneigenschaften in einer Datei:

Attribut	Typ	In MetadataChange bearbeitbar
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	YES
ContentDisposition	string	YES
ContentEncoding	string	YES
ContentLanguage	string	YES
ContentType	string	YES
DownloadUrl	Uri	NEIN
DownloadUrls	IList<Uri>	NEIN
CustomMetadataKeys	IEnumerable<string>	YES

Nächste Schritte

Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, aber auch das Entfernen von Dateien. Sehen wir uns an, wie Sie Dateien in Cloud Storage löschen.