Bu sayfa, Cloud Translation API ile çevrilmiştir.

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 dosyayı Cloud Storage'da yüklemek istediğiniz konuma yönelik 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 veren verileri yükleyemezsiniz. Referansınız bir alt URL'ye yönlendirmelidir.

Dosya Yükle

Referans aldıktan sonra dosyaları Cloud Storage'a iki şekilde yükleyebilirsiniz:

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

Bellekteki verilerden yükle

PutData() yöntemi, Cloud Storage'a dosya yüklemenin en basit yoludur. PutData(), bir bayt arabelleği alır ve Gelecek tamamlandığında dosya hakkında bilgiler içeren 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);

Talep yapılmış olsa da dosya yüklenmeden önce Gelecekteki sürenin tamamlanmasını beklememiz gerekir. Oyunlar genellikle bir döngüde çalıştığından ve diğer uygulamalardan daha az geri çağırmaya yönlendirdiğinden genellikle tamamlanmak 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 dosyadan yükle

PutFile() yöntemini kullanarak cihazlara kameradan fotoğraf ve video gibi yerel dosyalar yükleyebilirsiniz. PutFile(), dosyanın yolunu temsil eden bir std::string alır ve Gelecek tamamlandığında dosyayla ilgili bilgileri içeren 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 etkin bir şekilde yönetmek istiyorsanız PutFile() veya PutBytes() yöntemlerine bir Controller sağlayabilirsiniz. Böylece, 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 verisi özelliklerini içerir. PutFile() yöntemi, içerik türünü dosya adı uzantısından otomatik olarak tahmin eder ancak meta verilerde content_type belirterek otomatik algılanan türü geçersiz kılabilirsiniz. content_type sağlamazsanız ve Cloud Storage, dosya uzantısından bir varsayılan çı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 İlerlemesini İzleme

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 İşleme

Yükleme sırasında, yerel dosyanın mevcut olmaması veya kullanıcının istenen dosyayı yükleme izninin olmaması gibi çeşitli nedenler vardır. Hatalar hakkında daha fazla bilgiyi belgelerin İşleyici Hataları bölümünde bulabilirsiniz.

Sonraki adımlar

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