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üklemenize olanak tanır.

Referans Oluşturma

Dosya yüklemek için önce Cloud Storage içinde dosyayı yüklemek istediğiniz konuma bir 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 verileri yükleyemezsiniz. Referansınız bir alt URL'ye yönlendirmelidir.

Dosya Yükle

Referans oluşturduktan sonra Cloud Storage adresine 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ükle

PutData() yöntemi, Cloud Storage hizmetine 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);

Bu noktada istek yapılmıştır ancak dosya yüklenmeden önce Future'ın tamamlanmasını beklememiz gerekir. Oyunlar genellikle bir döngü içinde çalıştığından ve diğer uygulamalara kıyasla daha az geri çağırma odaklı olduğundan, genellikle tamamlanma durumunu sorgulamanız gerekir.

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. kameradaki 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 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 verileri de ekleyebilirsiniz. Bu meta veriler, name, size ve content_type (genellikle MIME türü olarak adlandırılır) gibi 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 değerini 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 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 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 hata oluşmasının çeşitli nedenleri vardır. Örneğin, yerel dosyanın mevcut olmaması veya kullanıcının istenen dosyayı yükleme izninin olmaması. Hatalar hakkında daha fazla bilgiyi belgelerin Hataları İşleme bölümünde bulabilirsiniz.

Sonraki adımlar

Dosyaları yüklediğinize göre, şimdi de Cloud Storage üzerinden dosya indirmeyi öğrenelim.