C++ এর জন্য ক্লাউড স্টোরেজ সহ ফাইল আপলোড করুন

Cloud Storage for 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. ডিভাইসে থাকা কোনো ফাইলের প্রতিনিধিত্বকারী ফাইল পাথ থেকে আপলোড করুন

মেমরিতে থাকা ডেটা থেকে আপলোড করুন

Cloud Storage ফাইল আপলোড করার সবচেয়ে সহজ উপায় হলো 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 প্রদান না করেন এবং 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);
}

ত্রুটি পরিচালনা

আপলোড করার সময় বিভিন্ন কারণে ত্রুটি ঘটতে পারে, যার মধ্যে রয়েছে স্থানীয়ভাবে ফাইলটির অস্তিত্ব না থাকা, অথবা কাঙ্ক্ষিত ফাইলটি আপলোড করার জন্য ব্যবহারকারীর অনুমতি না থাকা। আপনি ডকুমেন্টেশনের ' Handle Errors' বিভাগে ত্রুটি সম্পর্কে আরও তথ্য পেতে পারেন।

পরবর্তী পদক্ষেপ

এখন যেহেতু আপনি ফাইলগুলো আপলোড করেছেন, চলুন জেনে নিই Cloud Storage থেকে কীভাবে সেগুলো ডাউনলোড করতে হয়।