फायरबेस के लिए क्लाउड स्टोरेज आपको फायरबेस द्वारा प्रदान और प्रबंधित क्लाउड स्टोरेज बकेट में फ़ाइलों को जल्दी और आसानी से अपलोड करने की अनुमति देता है।
एक संदर्भ बनाएँ
फ़ाइल अपलोड करने के लिए, पहले क्लाउड स्टोरेज में उस स्थान के लिए एक क्लाउड स्टोरेज संदर्भ बनाएँ जहाँ आप फ़ाइल अपलोड करना चाहते हैं।
आप अपने क्लाउड स्टोरेज बकेट के रूट में चाइल्ड पाथ जोड़कर एक संदर्भ बना सकते हैं:
// 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
आप अपने क्लाउड स्टोरेज बकेट के रूट के संदर्भ में डेटा अपलोड नहीं कर सकते। आपका संदर्भ चाइल्ड URL की ओर इशारा करना चाहिए।
फाइलें अपलोड करें
एक बार आपके पास एक संदर्भ होने के बाद, आप दो तरीकों से क्लाउड स्टोरेज में फाइल अपलोड कर सकते हैं:
- मेमोरी में बाइट बफर से अपलोड करें
- डिवाइस पर फ़ाइल का प्रतिनिधित्व करने वाले फ़ाइल पथ से अपलोड करें
मेमोरी में डेटा से अपलोड करें
क्लाउड स्टोरेज में फाइल अपलोड करने के लिए PutData() विधि सबसे सरल तरीका है। PutData() एक बाइट बफर लेता है और Future<Metadata> लौटाता है जिसमें Future पूर्ण होने पर फ़ाइल के बारे में जानकारी होगी। आप अपने अपलोड को प्रबंधित करने और उसकी स्थिति पर नज़र रखने के लिए Controller उपयोग कर सकते हैं।
// 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);
इस बिंदु पर अनुरोध किया गया है लेकिन फाइल अपलोड होने से पहले हमें फ्यूचर के पूरा होने का इंतजार करना होगा। चूंकि खेल आम तौर पर एक लूप में चलते हैं, और अन्य अनुप्रयोगों की तुलना में कम कॉलबैक संचालित होते हैं, आप आमतौर पर पूरा होने के लिए मतदान करेंगे।
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();
}
}
स्थानीय फ़ाइल से अपलोड करें
PutFile() मेथड से आप कैमरे से फोटो और वीडियो जैसे डिवाइस पर लोकल फाइल अपलोड कर सकते हैं। PutFile() फ़ाइल के पथ का प्रतिनिधित्व करने वाला एक std::string लेता है और Future<Metadata> लौटाता है जिसमें Future पूर्ण होने पर फ़ाइल के बारे में जानकारी होगी। आप अपने अपलोड को प्रबंधित करने और उसकी स्थिति पर नज़र रखने के लिए 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"
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();
}
यदि आप अपने अपलोड को सक्रिय रूप से प्रबंधित करना चाहते हैं, तो आप PutFile() या PutBytes() विधियों को Controller प्रदान कर सकते हैं। यह आपको चल रहे अपलोड ऑपरेशन को देखने के लिए नियंत्रक का उपयोग करने की अनुमति देता है। अधिक जानकारी के लिए अपलोड प्रबंधित करें देखें।
फ़ाइल मेटाडेटा जोड़ें
जब आप फ़ाइलें अपलोड करते हैं तो आप मेटाडेटा भी शामिल कर सकते हैं। इस मेटाडेटा में विशिष्ट फ़ाइल मेटाडेटा गुण होते हैं जैसे name , size और content_type (आमतौर पर MIME प्रकार के रूप में संदर्भित)। PutFile() विधि स्वचालित रूप से फ़ाइल नाम एक्सटेंशन से सामग्री प्रकार का अनुमान लगाती है, लेकिन आप मेटाडेटा में content_type निर्दिष्ट करके ऑटो-डिटेक्ट किए गए प्रकार को ओवरराइड कर सकते हैं। यदि आप content_type प्रदान नहीं करते हैं और क्लाउड स्टोरेज फ़ाइल एक्सटेंशन से डिफ़ॉल्ट का अनुमान नहीं लगा सकता है, तो क्लाउड स्टोरेज application/octet-stream का उपयोग करता है। फ़ाइल मेटाडेटा के बारे में अधिक जानकारी के लिए फ़ाइल मेटाडेटा का उपयोग करें अनुभाग देखें।
// 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);
अपलोड प्रबंधित करें
अपलोड शुरू करने के अलावा, आप Controller पर Pause() , Resume() , और Cancel() विधियों का उपयोग करके अपलोड को रोक सकते हैं, फिर से शुरू कर सकते हैं और रद्द कर सकते हैं, जिसे आप वैकल्पिक रूप से PutBytes() या PutFile() विधियों में पास कर सकते हैं।
// 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();
अपलोड प्रगति की निगरानी करें
अपलोड की प्रगति की निगरानी के लिए आप श्रोताओं को अपलोड से जोड़ सकते हैं।
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);
}
त्रुटि प्रबंधन
स्थानीय फ़ाइल के मौजूद न होने, या उपयोगकर्ता के पास वांछित फ़ाइल अपलोड करने की अनुमति न होने सहित अपलोड पर त्रुटियाँ आने के कई कारण हो सकते हैं। आप डॉक्स के हैंडल एरर सेक्शन में एरर के बारे में अधिक जानकारी प्राप्त कर सकते हैं।
अगले कदम
अब जबकि आपने फ़ाइलें अपलोड कर दी हैं, आइए जानें कि उन्हें क्लाउड स्टोरेज से कैसे डाउनलोड किया जाए ।