फायरबेस के लिए क्लाउड स्टोरेज आपको फायरबेस द्वारा प्रदान और प्रबंधित क्लाउड स्टोरेज बकेट में फ़ाइलों को जल्दी और आसानी से अपलोड करने की अनुमति देता है।
एक संदर्भ बनाएँ
फ़ाइल अपलोड करने के लिए, पहले क्लाउड स्टोरेज में उस स्थान का क्लाउड स्टोरेज संदर्भ बनाएं जहां आप फ़ाइल अपलोड करना चाहते हैं।
आप अपने क्लाउड स्टोरेज बकेट के रूट में चाइल्ड पाथ जोड़कर एक संदर्भ बना सकते हैं:
// 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
आप अपने क्लाउड स्टोरेज बकेट के रूट के संदर्भ में डेटा अपलोड नहीं कर सकते। आपका संदर्भ किसी चाइल्ड यूआरएल की ओर इंगित करना चाहिए।
फाइलें अपलोड करें
एक बार आपके पास संदर्भ हो जाने पर, आप दो तरीकों से क्लाउड स्टोरेज पर फ़ाइलें अपलोड कर सकते हैं:
- मेमोरी में बाइट बफ़र से अपलोड करें
- डिवाइस पर फ़ाइल का प्रतिनिधित्व करने वाले फ़ाइल पथ से अपलोड करें
मेमोरी में डेटा से अपलोड करें
क्लाउड स्टोरेज पर फ़ाइल अपलोड करने के लिए 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" Futurefuture = 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" 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(); }
यदि आप अपने अपलोड को सक्रिय रूप से प्रबंधित करना चाहते हैं, तो आप 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); }
त्रुटि प्रबंधन
अपलोड करते समय त्रुटियाँ होने के कई कारण हो सकते हैं, जिनमें स्थानीय फ़ाइल का मौजूदा न होना, या उपयोगकर्ता के पास वांछित फ़ाइल अपलोड करने की अनुमति न होना शामिल है। आप डॉक्स के हैंडल एरर्स अनुभाग में त्रुटियों के बारे में अधिक जानकारी पा सकते हैं।
अगले कदम
अब जब आपने फ़ाइलें अपलोड कर दी हैं, तो आइए जानें कि उन्हें क्लाउड स्टोरेज से कैसे डाउनलोड किया जाए ।