Cloud Storage cho Firebase cho phép bạn tải tệp lên nhóm Cloud Storage do Firebase cung cấp và quản lý một cách nhanh chóng và dễ dàng.
Tạo một tài liệu tham khảo
Để tải tệp lên, trước tiên hãy tạo tham chiếu Cloud Storage tới vị trí trong Cloud Storage mà bạn muốn tải tệp lên.
Bạn có thể tạo một tham chiếu bằng cách thêm các đường dẫn con vào thư mục gốc của nhóm Cloud Storage:
// Create a root reference
StorageReference storage_ref = storage->GetReference();
// Create a reference to "mountains.jpg"
StorageReference mountains_ref = storage_ref.Child("mountains.jpg");
// Create a reference to 'images/mountains.jpg'
StorageReference mountain_images_ref = storage_ref.Child("images/mountains.jpg");
// While the file names are the same, the references point to different files
mountains_ref.name() == mountain_images_ref.name(); // true
mountains_ref.full_path() == mountain_images_ref.full_path(); // false
Bạn không thể tải lên dữ liệu có tham chiếu đến thư mục gốc của bộ chứa Cloud Storage. Tham chiếu của bạn phải trỏ đến URL con.
Tải tập tin lên
Sau khi đã có tài liệu tham khảo, bạn có thể upload file lên Cloud Storage theo 2 cách:
- Tải lên từ bộ đệm byte trong bộ nhớ
- Tải lên từ đường dẫn tệp đại diện cho tệp trên thiết bị
Tải lên từ dữ liệu trong bộ nhớ
Phương thức PutData() là cách đơn giản nhất để tải tệp lên Cloud Storage. PutData() lấy bộ đệm byte và trả về Future<Metadata> sẽ chứa thông tin về tệp khi Tương lai hoàn thành. Bạn có thể sử dụng Controller để quản lý quá trình tải lên của mình và theo dõi trạng thái của nó.
// Data in memory
const size_t kByteBufferSize = ...
uint8_t byte_buffer[kByteBufferSize] = { ... };
// Create a reference to the file you want to upload
StorageReference rivers_ref = storage_ref.Child("images/rivers.jpg");
// Upload the file to the path "images/rivers.jpg"
Future future = rivers_ref.PutBytes(byte_buffer, kByteBufferSize);
Tại thời điểm yêu cầu đã được thực hiện nhưng chúng ta phải đợi Tương lai hoàn thành trước khi tệp được tải lên. Vì trò chơi thường chạy theo vòng lặp và ít được điều khiển gọi lại hơn các ứng dụng khác nên bạn thường sẽ thăm dò để hoàn thành.
if (future.status() != firebase::kFutureStatusPending) {
if (future.status() != firebase::kFutureStatusComplete) {
LogMessage("ERROR: GetData() returned an invalid future.");
// Handle the error...
} else if (future.Error() != firebase::storage::kErrorNone) {
LogMessage("ERROR: GetData() returned error %d: %s", future.Error(),
future.error_message());
// Handle the error...
}
} else {
// Metadata contains file metadata such as size, content-type, and download URL.
Metadata* metadata = future.Result();
std::string download_url = metadata->download_url();
}
}
Tải lên từ một tập tin cục bộ
Bạn có thể tải các tệp cục bộ lên thiết bị, chẳng hạn như ảnh và video từ máy ảnh, bằng phương thức PutFile() . PutFile() lấy std::string đại diện cho đường dẫn đến tệp và trả về Future<Metadata> sẽ chứa thông tin về tệp khi Tương lai hoàn thành. Bạn có thể sử dụng Controller để quản lý quá trình tải lên của mình và theo dõi trạng thái của nó.
// File located on disk
std::string local_file = ...
// Create a reference to the file you want to upload
StorageReference rivers_ref = storage_ref.Child("images/rivers.jpg");
// Upload the file to the path "images/rivers.jpg"
Future future = rivers_ref.PutFile(localFile);
// Wait for Future to complete...
if (future.Error() != firebase::storage::kErrorNone) {
// Uh-oh, an error occurred!
} else {
// Metadata contains file metadata such as size, content-type, and download URL.
Metadata* metadata = future.Result();
std::string download_url = metadata->download_url();
}
Nếu muốn chủ động quản lý quá trình tải lên của mình, bạn có thể cung cấp Controller cho các phương thức PutFile() hoặc PutBytes() . Điều này cho phép bạn sử dụng bộ điều khiển để quan sát hoạt động tải lên đang diễn ra. Xem Quản lý tải lên để biết thêm thông tin.
Thêm siêu dữ liệu tệp
Bạn cũng có thể bao gồm siêu dữ liệu khi tải tệp lên. Siêu dữ liệu này chứa các thuộc tính siêu dữ liệu tệp điển hình như name , size và content_type (thường được gọi là loại MIME). Phương thức PutFile() tự động suy ra loại nội dung từ phần mở rộng tên tệp, nhưng bạn có thể ghi đè loại được phát hiện tự động bằng cách chỉ định content_type trong siêu dữ liệu. Nếu bạn không cung cấp content_type và Cloud Storage không thể suy ra giá trị mặc định từ phần mở rộng tệp thì Cloud Storage sẽ sử dụng application/octet-stream . Xem phần Sử dụng siêu dữ liệu tệp để biết thêm thông tin về siêu dữ liệu tệp.
// Create storage reference
StorageReference mountains_ref = storage_ref.Child("images/mountains.jpg");
// Create file metadata including the content type
StorageMetadata metadata;
metadata.set_content_type("image/jpeg");
// Upload data and metadata
mountains_ref.PutBytes(data, metadata);
// Upload file and metadata
mountains_ref.PutFile(local_file, metadata);
Quản lý tải lên
Ngoài việc bắt đầu tải lên, bạn có thể tạm dừng, tiếp tục và hủy tải lên bằng cách sử dụng các phương thức Pause() , Resume() và Cancel() trên Controller mà bạn có thể tùy ý chuyển sang các phương thức PutBytes() hoặc PutFile() .
// Start uploading a file
firebase::storage::Controller controller;
storage_ref.Child("images/mountains.jpg").PutFile(local_file, nullptr, &controller);
// Pause the upload
controller.Pause();
// Resume the upload
controller.Resume();
// Cancel the upload
controller.Cancel();
Theo dõi tiến trình tải lên
Bạn có thể đính kèm người nghe vào video tải lên để theo dõi tiến trình tải lên.
class MyListener : public firebase::storage::Listener {
public:
virtual void OnProgress(firebase::storage::Controller* controller) {
// A progress event occurred
}
};
{
// Start uploading a file
MyEventListener my_listener;
storage_ref.Child("images/mountains.jpg").PutFile(local_file, my_listener);
}
Xử lý lỗi
Có một số lý do khiến lỗi có thể xảy ra khi tải lên, bao gồm cả tệp cục bộ không tồn tại hoặc người dùng không có quyền tải tệp mong muốn lên. Bạn có thể tìm thêm thông tin về lỗi trong phần Xử lý lỗi của tài liệu.
Bước tiếp theo
Bây giờ bạn đã tải tệp lên, hãy tìm hiểu cách tải chúng xuống từ Cloud Storage.