Firebase için Cloud Storage, dosyaları Firebase tarafından sağlanan ve yönetilen bir Cloud Storage grubuna hızlı ve kolay bir şekilde yüklemenize olanak tanır.
Referans Oluştur
Bir dosya yüklemek için önce Cloud Storage'da dosyayı yüklemek istediğiniz konuma bir Cloud Storage referansı oluşturun .
Cloud Storage paketinizin kök dizinine 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
Bir 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 bir dosya yolundan yükleme
Bellekteki verilerden yükleme
PutData() yöntemi, bir dosyayı Cloud Storage'a yüklemenin en basit yoludur. PutData() bir bayt arabelleği alır ve Future tamamlandığında dosya hakkında bilgi içerecek olan 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ıldığı noktada ancak dosya yüklenmeden önce Future'ın tamamlanmasını beklememiz gerekiyor. Oyunlar genellikle bir döngüde çalıştığından ve diğer uygulamalara göre daha az geri arama odaklı olduğundan, genellikle tamamlama 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 bir dosyadan yükleyin
PutFile() yöntemi ile kameradan 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"
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. Bu, devam eden karşıya yükleme işlemini gözlemlemek için denetleyiciyi kullanmanıza izin verir. Daha fazla bilgi için Yüklemeleri Yönet'e bakın.
Dosya Meta Verisi Ekle
Dosyaları karşıya 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, dosya adı uzantısından içerik türünü otomatik olarak çıkarır, ancak meta verilerde content_type belirterek otomatik algılanan türü geçersiz kılabilirsiniz. Bir 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, isteğe bağlı olarak PutBytes() veya PutFile() yöntemlerine iletebileceğiniz, Controller üzerinde 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şabilmesinin çeşitli nedenleri vardır. Dokümanların Hataları İşle bölümünde hatalarla ilgili daha fazla bilgi bulabilirsiniz.
Sonraki adımlar
Dosyaları yüklediğinize göre, bunları Cloud Storage'dan nasıl indireceğinizi öğrenelim.