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

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

Cloud Storage for Firebase, dosyalarınızı bir API'ye hızla ve kolayca yüklemenizi sağlar. Sağlanan Cloud Storage paketi Firebase tarafından yönetilir.

Referans Oluşturma

Dosya yüklemek için önce Cloud Storage referansı oluşturma dosyayı yüklemek istediğiniz Cloud Storage'a konumlandırın.

Cloud Storage paketi:

// 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 paketi. Referansınız bir alt URL'ye yönlendirmelidir.

Dosya Yükle

Referans aldıktan sonra dosyaları Cloud Storage'a yükleyebilirsiniz iki yöntem vardır:

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

Bellekteki verilerden yükle

PutData() yöntemi, bir dosyayı şuraya yüklemenin en basit yoludur: Cloud Storage. PutData(), bir bayt arabelleği alır ve şunu döndürür: Dosya hakkında bilgiler içeren Future<Metadata> tamamlanacağına inanıyorum. Yüklemenizi yönetmek için Controller kullanabilir ve mesajının durumunu izleyebilirsiniz.

// 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);

İstekte bulunuldu, ancak Gelecekteki Reklamının dosya yüklenmeden önce tamamlanır. Oyunlar genellikle bir döngü içinde olduğundan uygulamalara göre daha az geri arama odaklıdır. Bu tür uygulamalar teşekkür etmenin de önemli bir yoludur.

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

Cihazlara, PutFile() yöntemiyle kameranızı açın. PutFile() std::string atıyor dosyanın yolunu temsil eder ve Future<Metadata> ve şunu içerir: dosyayla ilgili bilgileri içeren bir e-posta alırsınız. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için Yüklemenizi yönetmek ve durumunu izlemek için Controller.

// 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 şuraya bir Controller sağlayabilirsiniz: PutFile() veya PutBytes() yöntemleri. Bu şekilde, denetleyiciyi kullanarak şunları yapabilirsiniz: devam eden yükleme işlemini gözlemleyin. Aşağıdakiler için Yüklemeleri Yönetme başlıklı makaleyi inceleyin: daha fazla bilgi edinin.

Dosya Meta Verileri Ekleme

Dosya yüklerken meta verileri de ekleyebilirsiniz. Bu meta veri şunları içerir: name, size ve content_type gibi tipik dosya meta verisi özellikleri (genellikle MIME türü olarak ifade edilir). PutFile() yöntemi, otomatik olarak içerik türünü dosya adı uzantısından değiştirebilirsiniz, ancak meta veride content_type belirtilerek otomatik algılanan tür. Google bir content_type sağlarsanız Cloud Storage, Cloud Storage, application/octet-stream dosya uzantısını kullanır. Görüntüleyin 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 aşağıdakileri kullanarak yüklemeleri duraklatabilir, devam ettirebilir ve iptal edebilirsiniz: Controller üzerinde aşağıdaki Pause(), Resume() ve Cancel() yöntemlerini kullanarak isteğe bağlı olarak PutBytes() veya PutFile() yöntemlerine iletebilir.

// 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üklemelere dinleyiciler ekleyerek yüklemelerin ilerlemesini yükleyin.

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 birkaç nedeni vardır: yerel dosya mevcut değil veya kullanıcının yükleme izni yok seçin. Hatalarla ilgili daha fazla bilgiyi Hataları İşleme bölümünde bulabilirsiniz.

Sonraki adımlar

Artık dosya yüklediğinize göre bunları indirin Cloud Storage'dan edinilebilir.