C++ için Cloud Storage ile Dosya Yükleme

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

Referans Oluşturma

Dosya yüklemek için önce Cloud Storage içinde dosyayı yüklemek istediğiniz konumun Cloud Storage referansını oluşturun.

Alt yolları Cloud Storage paketinize ekleyerek 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 paketinize ait köke referans veren verileri yükleyemezsiniz. Referansınız bir alt URL'ye yönlendirmelidir.

Dosya Yükle

Referansınız olduğunda Cloud Storage'ya iki şekilde dosya 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'ye dosya yüklemenin en basit yoludur. PutData(), bir bayt arabelleği alır ve Future tamamlandığında dosya hakkında bilgi içeren bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için 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);

İstek yapıldı ancak dosyanın yüklenmesi için Future'ın tamamlanmasını beklememiz gerekiyor. Oyunlar genellikle döngü içinde çalıştığından ve diğer uygulamalara kıyasla daha az geri çağırma odaklı olduğundan, genellikle tamamlanma için 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öntemini kullanarak cihazlardaki yerel dosyaları (ör. kameradan alınan fotoğraf ve videolar) yükleyebilirsiniz. PutFile(), dosyanın yolunu temsil eden bir std::string alır ve Future tamamlandığında dosya hakkında bilgi içeren bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için 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ükleme işleminizi etkin bir şekilde yönetmek istiyorsanız Controller değerini PutFile() veya PutBytes() yöntemlerine sağlayabilirsiniz. Bu sayede, devam eden yükleme işlemini gözlemlemek için kontrol cihazını kullanabilirsiniz. Daha fazla bilgi için Yüklemeleri Yönetme bölümüne bakın.

Dosya meta verileri ekleme

Dosya yüklerken meta verileri de ekleyebilirsiniz. Bu meta veriler, name, size ve content_type gibi (genellikle MIME türü olarak adlandırılır) tipik dosya meta veri ö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. content_type sağlamazsanız ve Cloud Storage, dosya uzantısından varsayılan bir değer çıkaramazsa Cloud Storage, application/octet-stream değerini kullanır. Dosya meta verileri hakkında daha fazla bilgi için Dosya Meta Verilerini Kullanma 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, Controller üzerinde Pause(), Resume() ve Cancel() yöntemlerini kullanarak yüklemeleri duraklatabilir, devam ettirebilir ve iptal edebilirsiniz. Bu yöntemleri isteğe bağlı olarak PutBytes() veya PutFile() yöntemlerine de iletebilirsiniz.

// 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 ilerleme durumunu izleme

Yükleme işleminin ilerleme durumunu 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 İşleme

Yükleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Örneğin, yerel dosya mevcut olmayabilir veya kullanıcının istenen dosyayı yükleme izni olmayabilir. Hatalar hakkında daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.

Sonraki adımlar

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