Bu sayfada, Cloud Storage paketine dosya yüklemek için Cloud Storage for Firebase SDK'nın nasıl kullanılacağı açıklanmaktadır.
Daha fazla bilgi için bu SSS sayfasına bakın.
Referans oluşturma
Dosya yüklemek için önce Cloud Storage içinde dosyayı yüklemek istediğiniz konuma 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 içeren verileri yükleyemezsiniz. Referansınız bir alt URL'ye yönlendirmelidir.
Dosyaları yükle
Referans oluşturduktan sonra Cloud Storage dizinine iki şekilde dosya yükleyebilirsiniz:
- Bellekteki bir bayt arabelleğinden yükleme
- Cihazdaki bir dosyayı temsil eden dosya yolundan yükleme
Bellekteki verilerden yükle
PutData() yöntemi, Cloud Storage hizmetine dosya yüklemenin en basit yoludur. PutData(), bir bayt arabelleği alır ve Future tamamlandığında dosya hakkında bilgi içeren bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için 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);
İstek yapıldı ancak dosya yüklenmeden önce Future'ın tamamlanmasını beklememiz gerekiyor. Oyunlar genellikle bir döngü içinde çalıştığından ve diğer uygulamalara kıyasla daha az geri çağırma odaklı olduğundan, genellikle tamamlanma durumunu sorgulamanız gerekir.
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öntemini kullanarak cihazlardaki yerel dosyaları (ör. kameradaki fotoğraf ve videolar) yükleyebilirsiniz. PutFile(), dosyanın yolunu temsil eden bir std::string alır ve Future tamamlandığında dosya hakkında bilgi içeren bir Future<Metadata> döndürür. Yüklemenizi yönetmek ve durumunu izlemek için 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ükleme işleminizi etkin bir şekilde yönetmek istiyorsanız PutFile() veya PutBytes() yöntemlerine bir Controller sağlayabilirsiniz. Bu sayede, devam eden yükleme işlemini gözlemlemek için denetleyiciyi kullanabilirsiniz. Ayrıntılı bilgi için Yüklemeleri yönetme başlıklı makaleyi inceleyin.
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 veri özelliklerini içerir. PutFile yöntemi, MIME türünü dosya adı uzantısından otomatik olarak çıkarır ancak meta verilerde content_type değerini belirterek otomatik olarak algılanan türü geçersiz kılabilirsiniz. content_type sağlamazsanız ve Cloud Storage, dosya uzantısından varsayılan bir değer çıkaramazsa Cloud Storage, application/octet-stream kullanır.
Dosya meta verileri hakkında daha fazla bilgi için Dosya meta verilerini kullanma başlıklı makaleyi inceleyin.
// 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 ilerleme durumunu izleme
Yükleme işleminin ilerleme durumunu izlemek için yüklemelere dinleyici 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 işleme
Yükleme sırasında hata oluşmasının çeşitli nedenleri olabilir. Örneğin, yerel dosya mevcut olmayabilir veya kullanıcının, yüklemek istediği dosya için izni olmayabilir. Hatalar hakkında daha fazla bilgi için Hataları işleme başlıklı makaleyi inceleyin.
Sonraki adımlar
Dosyaları yüklediğinize göre, bunları Cloud Storage üzerinden nasıl indireceğinizi öğrenin.