C++ için Cloud Storage ile dosya yükleme

Bu sayfada, Cloud Storage paketine dosya yüklemek için Cloud Storage for Firebase SDK'nın nasıl kullanılacağı açıklanmaktadır.

Daha fazla bilgi için bu SSS sayfasına bakın.

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.

Dosyaları yükle

Referans oluşturduktan sonra Cloud Storage dizinine 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);

İstek yapıldı ancak dosya yüklenmeden önce Future'ın tamamlanmasını beklememiz gerekiyor. 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. Ayrıntılı bilgi için Yüklemeleri yönetme başlıklı makaleyi inceleyin.

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, MIME 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 başlıklı makaleyi inceleyin.

// 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 işleme

Yükleme sırasında hata oluşmasının çeşitli nedenleri olabilir. Örneğin, yerel dosya mevcut olmayabilir veya kullanıcının, yüklemek istediği dosya için izni olmayabilir. Hatalar hakkında daha fazla bilgi için Hataları işleme başlıklı makaleyi inceleyin.

Sonraki adımlar

Dosyaları yüklediğinize göre, bunları Cloud Storage üzerinden nasıl indireceğinizi öğrenin.