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 বাকেটের রুটের রেফারেন্স সহ ডেটা আপলোড করতে পারবেন না। আপনার রেফারেন্স অবশ্যই কোনও চাইল্ড URL-এর দিকে নির্দেশ করবে।
ফাইলগুলি আপলোড করুন
রেফারেন্স পেয়ে গেলে, আপনি দুটি উপায়ে Cloud Storage-এ ফাইল আপলোড করতে পারবেন:
- মেমরিতে থাকা বাইট বাফার থেকে আপলোড করা
- ডিভাইসে থাকা কোনও ফাইলের ফাইল পাথ থেকে আপলোড করা
মেমরিতে থাকা ডেটা থেকে আপলোড করা
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" Futurefuture = 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> রিটার্ন করে যার মধ্যে
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(); }
আপনি যদি নিজের আপলোড অ্যাক্টিভভাবে ম্যানেজ করতে চান, তাহলে Controller-এ
PutFile() বা PutBytes() পদ্ধতি যোগ করতে পারেন। এটি আপনাকে কন্ট্রোলার ব্যবহার করে
চলমান আপলোড অপারেশন পর্যবেক্ষণ করতে দেয়। আরও তথ্যের জন্য আপলোড ম্যানেজ করুন
বিকল্প দেখুন।
ফাইলের মেটাডেটা যোগ করা
এছাড়াও, ফাইল আপলোড করার সময় আপনি মেটাডেটা যোগ করতে পারবেন। এই মেটাডেটাতে
সাধারণ ফাইল মেটাডেটা প্রপার্টি যেমন 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 থেকে সেগুলি ডাউনলোড করতে হয়।