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