Tải tệp lên bằng Cloud Storage cho C++

Cloud Storage for Firebase cho phép bạn tải tệp lên một bộ chứa Cloud Storage do Firebase cung cấp và quản lý một cách nhanh chóng và dễ dàng.

Lưu ý: Theo mặc định, bộ chứa Cloud Storage for Firebase yêu cầu Firebase Authentication thực hiện bất kỳ thao tác nào trên dữ liệu hoặc tệp của bộ chứa. Bạn có thể thay đổi Firebase Security Rules thành Cloud Storage để cho phép truy cập không xác thực trong một số trường hợp cụ thể. Tuy nhiên, trong hầu hết các trường hợp, bạn nên hạn chế quyền truy cập và thiết lập các quy tắc bảo mật mạnh mẽ (đặc biệt là đối với các ứng dụng phát hành công khai). Xin lưu ý rằng nếu bạn sử dụng Google App Engine và có một bộ chứa Cloud Storage mặc định có định dạng tên là *.appspot.com, thì bạn có thể cần cân nhắc mức độ ảnh hưởng của các quy tắc bảo mật đối với quyền truy cập vào tệp App Engine.

Tạo tệp đối chiếu

Để tải tệp lên, trước tiên, hãy tạo một tệp tham chiếu Cloud Storage đến vị trí trong Cloud Storage mà bạn muốn tải tệp lên.

Bạn có thể tạo một tệp tham chiếu bằng cách thêm các đường dẫn con vào thư mục gốc của bộ chứa 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 dữ liệu lên bằng tham chiếu đến thư mục gốc của bộ chứa Cloud Storage. URL tham chiếu của bạn phải trỏ đến một URL con.

Tải tệp lên

Sau khi có tệp tham chiếu, bạn có thể tải tệp lên Cloud Storage bằng hai 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 một 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 vùng đệm byte và trả về một Future<Metadata> chứa thông tin về tệp khi Future hoàn tất. Bạn có thể sử dụng Controller để quản lý nội dung tải lên và theo dõi trạng thái của nội dung đó.

// 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 Future hoàn tất trước khi tải tệp lên. Vì các trò chơi thường chạy theo vòng lặp và ít được điều khiển bằng lệnh gọi lại hơn so với các ứng dụng khác, nên bạn thường sẽ thăm dò ý kiến để hoàn tất.

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ừ tệp cục bộ

Bạn có thể tải các tệp cục bộ trên thiết bị lên, chẳng hạn như ảnh và video từ máy ảnh, bằng phương thức PutFile(). PutFile() lấy một std::string đại diện cho đường dẫn đến tệp và trả về một Future<Metadata> sẽ chứa thông tin về tệp khi Future hoàn tất. Bạn có thể sử dụng Controller để quản lý nội dung tải lên và theo dõi trạng thái của nội dung đó.

// 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ý nội dung tải lên, 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 thao tác tải lên đang diễn ra. Hãy xem phần Quản lý nội dung 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ể thê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 thông thường như name, size và content_type (thường được gọi là loại MIME). Phương thức PutFile() tự động suy luận loại nội dung từ đuôi 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 luận giá trị mặc định từ đuôi tệp, thì Cloud Storage sẽ sử dụng application/octet-stream. Hãy 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à huỷ tải lên bằng các phương thức Pause(), Resume() và Cancel() trên Controller. Bạn có thể tuỳ ý chuyển các phương thức này đến 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 trình nghe vào nội dung 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);
}

Lỗi xử lý

Có một số lý do khiến lỗi có thể xảy ra khi tải lên, bao gồm cả việ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.

Các bước tiếp theo

Giờ thì bạn đã tải các tệp lên, hãy tìm hiểu cách tải các tệp đó xuống từ Cloud Storage.