Firebase için Cloud Storage, dosyaları Firebase tarafından sağlanan ve yönetilen bir Cloud Storage paketine hızlı ve kolay bir şekilde yüklemenize olanak tanır.
Referans Oluştur
Bir dosyayı yüklemek için öncelikle Cloud Storage'da dosyayı yüklemek istediğiniz konuma yönelik bir Cloud Storage referansı oluşturun .
Cloud Storage paketinizin köküne alt yollar ekleyerek bir 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 referansla veri yükleyemezsiniz. Referansınız bir alt URL'ye işaret etmelidir.
Dosyaları yükle
Referansınız olduğunda dosyaları Cloud Storage'a iki şekilde yükleyebilirsiniz:
- Bellekteki bir bayt arabelleğinden yükleme
- Cihazdaki bir dosyayı temsil eden dosya yolundan yükleme
Bellekteki verilerden yükleme
PutData()
yöntemi, Cloud Storage'a dosya yüklemenin en basit yoludur. PutData()
bir bayt arabelleği alır ve Future tamamlandığında dosya hakkında bilgi içerecek 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);
Bu noktada istek yapıldı ancak dosya yüklenmeden önce Geleceğin tamamlanmasını beklemek zorundayız. Oyunlar genellikle bir döngüde çalıştığından ve diğer uygulamalara göre daha az geri çağrıldığından, genellikle tamamlanmak üzere 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 bir dosyadan yükleme
PutFile()
yöntemiyle kameradaki fotoğraf ve video gibi yerel dosyaları cihazlara yükleyebilirsiniz. PutFile()
dosyanın yolunu temsil eden bir std::string
alır ve Future tamamlandığında dosya hakkında bilgi içerecek 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 aktif olarak yönetmek istiyorsanız PutFile()
veya PutBytes()
yöntemlerine bir Controller
sağlayabilirsiniz. Bu, devam eden yükleme işlemini gözlemlemek için denetleyiciyi kullanmanıza olanak tanır. Daha fazla bilgi için Yüklemeleri Yönetme konusuna bakın.
Dosya Meta Verilerini Ekle
Dosyaları yüklerken meta verileri de ekleyebilirsiniz. Bu meta veriler name
, size
ve content_type
(genellikle MIME türü olarak anı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 çıkarır, ancak meta verilerde content_type
belirterek otomatik olarak algılanan türü geçersiz kılabilirsiniz. Bir content_type
sağlamazsanız ve Cloud Storage, dosya uzantısından varsayılan bir sonuç çıkaramıyorsa Cloud Storage, application/octet-stream
kullanır. Dosya meta verileri hakkında daha fazla bilgi için Dosya Meta Verilerini Kullan 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, isteğe bağlı olarak PutBytes()
veya PutFile()
yöntemlerine iletebileceğiniz Controller
üzerindeki Pause()
, Resume()
ve Cancel()
yöntemlerini kullanarak yüklemeleri duraklatabilir, devam ettirebilir ve iptal edebilirsiniz.
// 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 İzleyin
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 yönetimi
Yerel dosyanın mevcut olmaması veya kullanıcının istenen dosyayı yükleme iznine sahip olmaması da dahil olmak üzere yükleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Dokümanların Hataları İşleme bölümünde hatalar hakkında daha fazla bilgi bulabilirsiniz.
Sonraki adımlar
Dosyaları yüklediğinize göre artık bunları Cloud Storage'dan nasıl indireceğinizi öğrenelim.