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

Cloud Storage for Firebase की मदद से, Firebase की ओर से उपलब्ध कराए गए और मैनेज किए गए 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() में फ़ाइल अपलोड करने का सबसे आसान तरीका PutData() है.Cloud Storage 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);

इस स्थिति में, अनुरोध किया जा चुका है, लेकिन फ़ाइल अपलोड होने से पहले हमें Future के पूरा होने का इंतज़ार करना होगा. गेम आम तौर पर लूप में चलते हैं और अन्य ऐप्लिकेशन के मुकाबले, इनमें कॉलबैक कम होते हैं. इसलिए, आम तौर पर आपको गेम पूरा होने के लिए पोल करना होगा.

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 से उन्हें डाउनलोड कैसे करें.