Carica file con Cloud Storage per Unity

Cloud Storage for Firebase ti consente di caricare rapidamente e facilmente i file in un bucket Cloud Storage fornito e gestito da Firebase.

Creazione di un riferimento

Per caricare un file, devi prima creare un riferimento Cloud Storage al file che vuoi caricare.

Puoi creare un riferimento aggiungendo percorsi secondari alla radice del bucket Cloud Storage oppure puoi creare un riferimento da un URL gs:// o https:// esistente che fa riferimento a un oggetto in Cloud Storage.

// Create a root reference
StorageReference storageRef = storage.RootReference;

// Create a reference to "mountains.jpg"
StorageReference mountainsRef = storageRef.Child("mountains.jpg");

// Create a reference to 'images/mountains.jpg'
StorageReference mountainImagesRef =
    storageRef.Child("images/mountains.jpg");

// While the file names are the same, the references point to different files
Assert.AreEqual(mountainsRef.Name, mountainImagesRef.Name);
Assert.AreNotEqual(mountainsRef.Path, mountainImagesRef.Path);

Non puoi caricare dati con un riferimento alla radice del tuo bucket Cloud Storage. Il riferimento deve rimandare a un URL secondario.

Carica file

Una volta ottenuto un riferimento, puoi caricare i file su Cloud Storage in due modi:

  1. Caricare da un array di byte in memoria
  2. Caricare da un percorso del file che rappresenta un file sul dispositivo

Caricare i dati dalla memoria

Il metodo PutBytesAsync() è il modo più semplice per caricare un file su Cloud Storage. PutBytesAsync() accetta un byte[] e restituisce un System.Task<Firebase.Storage.StorageMetadata> che conterrà informazioni sul file al termine dell'attività. Se vuoi, puoi utilizzare un IProgress<UploadState> (in genere StorageProgress<UploadState>) per monitorare lo stato del caricamento.

// Data in memory
var customBytes = new byte[] {
    /*...*/
};

// Create a reference to the file you want to upload
StorageReference riversRef = storageRef.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
riversRef.PutBytesAsync(customBytes)
    .ContinueWith((Task<StorageMetadata> task) => {
        if (task.IsFaulted || task.IsCanceled) {
            Debug.Log(task.Exception.ToString());
            // Uh-oh, an error occurred!
        }
        else {
            // Metadata contains file metadata such as size, content-type, and md5hash.
            StorageMetadata metadata = task.Result;
            string md5Hash = metadata.Md5Hash;
            Debug.Log("Finished uploading...");
            Debug.Log("md5 hash = " + md5Hash);
        }
    });

Caricare da un file locale

Puoi caricare file locali sui dispositivi, come foto e video dalla fotocamera, con il metodo PutFileAsync(). PutFileAsync() accetta un string che rappresenta il percorso del file e restituisce un System.Task<Firebase.Storage.StorageMetadata> che conterrà informazioni sul file al termine dell'attività. Se vuoi, puoi utilizzare un IProgress<UploadState> (in genere StorageProgress<UploadState>) per monitorare lo stato del caricamento.

// File located on disk
string localFile = "...";

// Create a reference to the file you want to upload
StorageReference riversRef = storageRef.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
riversRef.PutFileAsync(localFile)
    .ContinueWith((Task<StorageMetadata> task) => {
        if (task.IsFaulted || task.IsCanceled) {
            Debug.Log(task.Exception.ToString());
            // Uh-oh, an error occurred!
        }
        else {
            // Metadata contains file metadata such as size, content-type, and download URL.
            StorageMetadata metadata = task.Result;
            string md5Hash = metadata.Md5Hash;
            Debug.Log("Finished uploading...");
            Debug.Log("md5 hash = " + md5Hash);
        }
    });

Se vuoi monitorare attivamente il caricamento, puoi utilizzare una classe StorageProgress o una tua classe che implementa IProgress<UploadState>, con i metodi PutFileAsync() o PutBytesAsync(). Per saperne di più, consulta Gestire i caricamenti.

Aggiungere metadati del file

Puoi anche includere i metadati quando carichi i file. Questi metadati contengono le proprietà tipiche dei metadati dei file, come Name, Size e ContentType (comunemente denominati tipo MIME). Il metodo PutFileAsync() deduce automaticamente il tipo di contenuti dall'estensione del nome file, ma puoi ignorare il tipo rilevato automaticamente specificando ContentType nei metadati. Se non fornisci un ContentType e Cloud Storage non può dedurre un valore predefinito dall'estensione del file, Cloud Storage utilizza application/octet-stream. Per ulteriori informazioni sui metadati dei file, consulta la sezione Utilizzare i metadati dei file.

// Create storage reference
StorageReference mountainsRef = storageRef.Child("images/mountains.jpg");

byte[] customBytes = new byte[] {
    /*...*/
};
string localFile = "...";

// Create file metadata including the content type
var newMetadata = new MetadataChange();
newMetadata.ContentType = "image/jpeg";

// Upload data and metadata
mountainsRef.PutBytesAsync(customBytes, newMetadata, null,
    CancellationToken.None); // .ContinueWithOnMainThread(...
// Upload file and metadata
mountainsRef.PutFileAsync(localFile, newMetadata, null,
    CancellationToken.None); // .ContinueWithOnMainThread(...

Monitorare l'avanzamento del caricamento

Puoi allegare listener ai caricamenti per monitorarne l'avanzamento. Il listener segue l'interfaccia standard System.IProgress<T>. Puoi utilizzare un'istanza della classe StorageProgress per fornire il tuo Action<T> come callback per i segni di avanzamento.

// Start uploading a file
var task = storageRef.Child("images/mountains.jpg")
    .PutFileAsync(localFile, null,
        new StorageProgress<UploadState>(state => {
            // called periodically during the upload
            Debug.Log(String.Format("Progress: {0} of {1} bytes transferred.",
                state.BytesTransferred, state.TotalByteCount));
        }), CancellationToken.None, null);

task.ContinueWithOnMainThread(resultTask => {
    if (!resultTask.IsFaulted && !resultTask.IsCanceled) {
        Debug.Log("Upload finished.");
    }
});

Gestione degli errori

Esistono diversi motivi per cui potrebbero verificarsi errori durante il caricamento, tra cui l'assenza del file locale o la mancanza dell'autorizzazione per caricare il file desiderato. Puoi trovare ulteriori informazioni sugli errori nella sezione Gestire gli errori della documentazione.

Passaggi successivi

Ora che hai caricato i file, scopriamo come scaricarli da Cloud Storage.