C++ için Cloud Storage ile Dosyaları Yükleyin

Firebase için Cloud Storage, dosyaları Firebase tarafından sağlanan ve yönetilen bir Cloud Storage paketine hızlı ve kolay bir şekilde yüklemenize olanak tanır.

Referans Oluştur

Bir dosyayı yüklemek için öncelikle Cloud Storage'da dosyayı yüklemek istediğiniz konuma yönelik bir Cloud Storage referansı oluşturun .

Cloud Storage paketinizin köküne alt yollar ekleyerek bir referans oluşturabilirsiniz:

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

Cloud Storage paketinizin köküne referansla veri yükleyemezsiniz. Referansınız bir alt URL'ye işaret etmelidir.

Dosyaları yükle

Referansınız olduğunda dosyaları Cloud Storage'a iki şekilde yükleyebilirsiniz:

  1. Bellekteki bir bayt arabelleğinden yükleme
  2. Cihazdaki bir dosyayı temsil eden dosya yolundan yükleme

Bellekteki verilerden yükleme

PutData() yöntemi, Cloud Storage'a dosya yüklemenin en basit yoludur. PutData() bir bayt arabelleği alır ve Future tamamlandığında dosya hakkında bilgi içerecek bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için bir Controller kullanabilirsiniz.

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

Bu noktada istek yapıldı ancak dosya yüklenmeden önce Geleceğin tamamlanmasını beklemek zorundayız. Oyunlar genellikle bir döngüde çalıştığından ve diğer uygulamalara göre daha az geri çağrıldığından, genellikle tamamlanmak üzere yoklama yaparsınız.

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

Yerel bir dosyadan yükleme

PutFile() yöntemiyle kameradaki fotoğraf ve video gibi yerel dosyaları cihazlara yükleyebilirsiniz. PutFile() dosyanın yolunu temsil eden bir std::string alır ve Future tamamlandığında dosya hakkında bilgi içerecek bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için bir Controller kullanabilirsiniz.

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

Yüklemenizi aktif olarak yönetmek istiyorsanız PutFile() veya PutBytes() yöntemlerine bir Controller sağlayabilirsiniz. Bu, devam eden yükleme işlemini gözlemlemek için denetleyiciyi kullanmanıza olanak tanır. Daha fazla bilgi için Yüklemeleri Yönetme konusuna bakın.

Dosya Meta Verilerini Ekle

Dosyaları yüklerken meta verileri de ekleyebilirsiniz. Bu meta veriler name , size ve content_type (genellikle MIME türü olarak anılır) gibi tipik dosya meta verisi özelliklerini içerir. PutFile() yöntemi, içerik türünü dosya adı uzantısından otomatik olarak çıkarır, ancak meta verilerde content_type belirterek otomatik olarak algılanan türü geçersiz kılabilirsiniz. Bir content_type sağlamazsanız ve Cloud Storage, dosya uzantısından varsayılan bir sonuç çıkaramıyorsa Cloud Storage, application/octet-stream kullanır. Dosya meta verileri hakkında daha fazla bilgi için Dosya Meta Verilerini Kullan bölümüne bakın.

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

Yüklemeleri Yönet

Yüklemeleri başlatmanın yanı sıra, isteğe bağlı olarak PutBytes() veya PutFile() yöntemlerine iletebileceğiniz Controller üzerindeki Pause() , Resume() ve Cancel() yöntemlerini kullanarak yüklemeleri duraklatabilir, devam ettirebilir ve iptal edebilirsiniz.

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

Yükleme İlerlemesini İzleyin

Yüklemenin ilerlemesini izlemek için yüklemelere dinleyiciler ekleyebilirsiniz.

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

Hata yönetimi

Yerel dosyanın mevcut olmaması veya kullanıcının istenen dosyayı yükleme iznine sahip olmaması da dahil olmak üzere yükleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Dokümanların Hataları İşleme bölümünde hatalar hakkında daha fazla bilgi bulabilirsiniz.

Sonraki adımlar

Dosyaları yüklediğinize göre artık bunları Cloud Storage'dan nasıl indireceğinizi öğrenelim.