Загрузка файлов с помощью Cloud Storage for Unity

Cloud Storage for Firebase позволяет быстро и легко загружать файлы в хранилище Cloud Storage предоставляемое и управляемое Firebase.

Создать ссылку

Для загрузки файла сначала создайте ссылку на файл в Cloud Storage .

Вы можете создать ссылку, добавив дочерние пути к корню вашего сегмента Cloud Storage , или вы можете создать ссылку на основе существующего URL-адреса gs:// или https:// ссылающегося на объект в 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);

Вы не можете загружать данные, ссылаясь на корневой каталог вашего Cloud Storage . Ваша ссылка должна указывать на дочерний URL-адрес.

Загрузка файлов

Получив ссылку, вы можете загружать файлы в Cloud Storage двумя способами:

  1. Загрузка из массива байтов в памяти.
  2. Загрузка из пути к файлу, представляющего собой файл на устройстве.

Загрузка данных из памяти.

Метод PutBytesAsync() — это самый простой способ загрузить файл в Cloud Storage . PutBytesAsync() принимает массив байтов (byte[]) и возвращает объект System.Task<Firebase.Storage.StorageMetadata> , который будет содержать информацию о файле после завершения задачи. Дополнительно можно использовать объект IProgress<UploadState> (обычно StorageProgress<UploadState> ) для отслеживания статуса загрузки.

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

Загрузка из локального файла

Вы можете загружать локальные файлы на устройства, такие как фотографии и видео с камеры, с помощью метода PutFileAsync() . Метод PutFileAsync() принимает string , представляющую путь к файлу, и возвращает объект System.Task<Firebase.Storage.StorageMetadata> , который будет содержать информацию о файле после завершения задачи. При желании вы можете использовать объект IProgress<UploadState> (обычно StorageProgress<UploadState> ) для отслеживания статуса загрузки.

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

Если вы хотите активно отслеживать процесс загрузки, вы можете использовать класс StorageProgress или собственный класс, реализующий интерфейс IProgress<UploadState> , с методами PutFileAsync() или PutBytesAsync() . Дополнительную информацию см. в разделе «Управление загрузками» .

Добавить метаданные файла

При загрузке файлов вы также можете добавлять метаданные. Эти метаданные содержат типичные свойства метаданных файла, такие как Name , Size и ContentType (обычно называемый MIME-типом). Метод PutFileAsync() автоматически определяет тип содержимого по расширению имени файла, но вы можете переопределить автоматически определенный тип, указав ContentType в метаданных. Если вы не указываете ContentType , и Cloud Storage не может определить значение по умолчанию по расширению файла, Cloud Storage использует application/octet-stream . Дополнительную информацию о метаданных файлов см. в разделе « Использование метаданных файлов».

// 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(...

Отслеживание хода загрузки

Для отслеживания хода загрузки можно прикреплять обработчики событий. Обработчик событий соответствует стандартному интерфейсу System.IProgress<T> . Вы можете использовать экземпляр класса StorageProgress , чтобы предоставить собственное Action<T> в качестве функции обратного вызова для отслеживания прогресса.

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

Обработка ошибок

При загрузке могут возникать ошибки по ряду причин, включая отсутствие локального файла или отсутствие у пользователя разрешения на загрузку нужного файла. Более подробную информацию об ошибках можно найти в разделе «Обработка ошибок» документации.

Следующие шаги

Теперь, когда вы загрузили файлы, давайте узнаем, как их скачать из Cloud Storage .