C++ के लिए, Cloud Storage वाली फ़ाइलें अपलोड करें

Cloud Storage for Firebase की मदद से, Firebase की ओर से दिए गए और मैनेज किए जाने वाले Cloud Storage बकेट में फ़ाइलें तुरंत और आसानी से अपलोड की जा सकती हैं.

ध्यान दें: डिफ़ॉल्ट रूप से, किसी Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई भी कार्रवाई करने के लिए, Firebase Authentication ज़रूरी है. खास स्थितियों में, पुष्टि किए बिना ऐक्सेस की अनुमति देने के लिए, Firebase Security RulesCloud Storage के लिए बदले जा सकते हैं. हालांकि, ज़्यादातर स्थितियों में, हमारा सुझाव है कि ऐक्सेस को सीमित किया जाए और सुरक्षा से जुड़े मज़बूत नियम सेट अप किए जाएं . खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए. ध्यान दें कि अगर आप Google App Engine का इस्तेमाल करते हैं और आपके पास डिफ़ॉल्ट Cloud Storage बकेट है, जिसका नाम फ़ॉर्मैट *.appspot.com में है, तो आपको यह देखना होगा कि सुरक्षा से जुड़े आपके नियमों का, App Engine फ़ाइलों के ऐक्सेस पर क्या असर पड़ता है.

ध्यान दें: स्पार्क प्लान वाले प्रोजेक्ट के लिए, Firebase, Windows के लिए कुछ तरह की एक्ज़ीक्यूटेबल फ़ाइलें (.exe, .dll और .bat एक्सटेंशन वाली फ़ाइलें), Android (.apk एक्सटेंशन वाली फ़ाइलें), और Apple (.ipa एक्सटेंशन वाली फ़ाइलें) Cloud Storage for Firebase और Firebase Hosting की मदद से अपलोड और होस्ट करने की सुविधा ब्लॉक कर देता है. यह नीति, हमारे प्लैटफ़ॉर्म पर होने वाले गलत इस्तेमाल को रोकने के लिए बनाई गई है. ब्लेज़ प्लान वाले प्रोजेक्ट पर इसका कोई असर नहीं पड़ता. ज़्यादा जानकारी के लिए, अक्सर पूछे जाने वाले ये सवाल देखें.

रेफ़रंस बनाना

कोई फ़ाइल अपलोड करने के लिए, सबसे पहले एक Cloud Storage रेफ़रंस उस जगह का बनाएं जहां आपको फ़ाइल अपलोड करनी है.Cloud Storage

Cloud Storage बकेट के रूट में चाइल्ड पाथ जोड़कर, रेफ़रंस बनाया जा सकता है: Cloud Storage

// 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 बकेट के रूट के रेफ़रंस से डेटा अपलोड नहीं किया जा सकता. आपका रेफ़रंस, चाइल्ड यूआरएल की ओर इशारा करना चाहिए.

फ़ाइलें अपलोड करना

रेफ़रंस मिलने के बाद, Cloud Storage में दो तरीकों से फ़ाइलें अपलोड की जा सकती हैं:

1. मेमोरी में मौजूद बाइट बफ़र से अपलोड करना
2. डिवाइस पर मौजूद किसी फ़ाइल के पाथ से अपलोड करना

मेमोरी में मौजूद डेटा से अपलोड करना

PutData() तरीका, Cloud Storage में कोई फ़ाइल अपलोड करने का सबसे आसान तरीका है. PutData() एक बाइट बफ़र लेता है और Future<Metadata> दिखाता है. इसमें, फ़ाइल के बारे में जानकारी होती है. यह जानकारी, फ़ाइल अपलोड होने के बाद मिलती है. अपलोड को मैनेज करने और उसकी स्थिति पर नज़र रखने के लिए, 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> दिखाता है. इसमें, फ़ाइल के बारे में जानकारी होती है. यह जानकारी, फ़ाइल अपलोड होने के बाद मिलती है. अपलोड को मैनेज करने और उसकी स्थिति पर नज़र रखने के लिए, 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 नहीं दिया जाता है और Cloud Storage, फ़ाइल के एक्सटेंशन से डिफ़ॉल्ट कॉन्टेंट टाइप का पता नहीं लगा पाता है, तो Cloud Storage 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);
}

गड़बड़ी ठीक करना

अपलोड के दौरान गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, लोकल फ़ाइल का मौजूद न होना या उपयोगकर्ता के पास, चुनी गई फ़ाइल को अपलोड करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी, दस्तावेज़ों के गड़बड़ियां ठीक करना सेक्शन में देखी जा सकती है.

अगले चरण

अब आपने फ़ाइलें अपलोड कर ली हैं, तो आइए उन्हें डाउनलोड करने का तरीका जानते हैं Cloud Storage.