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 hızlı ve kolay bir şekilde dosya yüklemenizi sağlar.

Referans Oluşturma

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

Cloud Storage paketinizin köküne alt yollar 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 paketinizin köküne referans içeren veriler yükleyemezsiniz. Referansınız bir alt URL'ye işaret etmelidir.

Dosya Yükle

Referans aldıktan sonra Cloud Storage platformuna iki şekilde dosya yükleyebilirsiniz:

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

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 dosyayla ilgili bilgileri 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 gönderilmiş ancak dosyanın yüklenmesi için Future'ın tamamlanmasını beklememiz gerekiyor. Oyunlar genellikle döngü halinde çalıştığı ve diğer uygulamalara kıyasla geri çağırma işlevi daha az olduğu için genellikle tamamlanma için anket 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 cihazlara yerel dosyalar (ör. kameradan fotoğraf ve videolar) yükleyebilirsiniz. PutFile(), dosyanın yolunu temsil eden bir std::string alır ve Future tamamlandığında dosyayla ilgili bilgileri 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üklemenizi etkin bir şekilde yönetmek istiyorsanız PutFile() veya PutBytes() yöntemlerine bir Controller sağlayabilirsiniz. Bu sayede, devam eden yükleme işlemini gözlemlemek için denetleyiciyi kullanabilirsiniz. Daha fazla bilgi için Yüklemeleri yönetme bölümüne bakın.

Dosya Meta Verileri Ekleme

Dosya yüklerken meta veri de ekleyebilirsiniz. Bu meta veriler, name, size ve content_type gibi dosya meta verisi özelliklerini (genellikle MIME türü olarak adlandırılır) 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 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 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 dinleyici 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 birden çok nedeni vardır. Örneğin, yerel dosyanın mevcut olmaması veya kullanıcının istenen dosyayı yükleme iznine sahip olmaması. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.

Sonraki adımlar

Dosyalarınızı yüklediğinize göre, şimdi bunları Cloud Storage üzerinden nasıl indireceğinize gelelim.