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" Futurefuture = 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" Futurefuture = 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.