Flutter-এ Cloud Storage-এর মাধ্যমে ফাইল আপলোড করা

এই পৃষ্ঠায় Cloud Storage বাকেটে ফাইল আপলোড করার জন্য কীভাবে Cloud Storage for Firebase SDK ব্যবহার করতে হয় তা বর্ণনা করা হয়েছে।

আরও তথ্যের জন্য, এই প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

ফাইল আপলোড করুন

Cloud Storage-এ ফাইল আপলোড করতে, প্রথমে ফাইলের নাম সহ ফাইলের সম্পূর্ণ পাথের একটি রেফারেন্স তৈরি করুন।

// Create a storage reference from your app
final storageRef = FirebaseStorage.instance.ref();

// Create a reference to "mountains.jpg"
final mountainsRef = storageRef.child("mountains.jpg");

// Create a reference to 'images/mountains.jpg'
final mountainImagesRef = storageRef.child("images/mountains.jpg");

// While the file names are the same, the references point to different files
assert(mountainsRef.name == mountainImagesRef.name);
assert(mountainsRef.fullPath != mountainImagesRef.fullPath);

আপনি উপযুক্ত রেফারেন্স তৈরি করার পরে, Cloud Storage-এ ফাইল আপলোড করতে putFile(), putString() বা putData() পদ্ধতি কল করুন।

আপনার Cloud Storage বাকেটের রুটের রেফারেন্স সহ ডেটা আপলোড করতে পারবেন না। আপনার রেফারেন্স অবশ্যই একটি চাইল্ড URL-এ পয়েন্ট করতে হবে।

ফাইল থেকে আপলোড করুন

ফাইল আপলোড করতে, আপনাকে প্রথমে অন-ডিভাইস লোকেশনে এটির অ্যাবসোলিউট পাথ পেতে হবে। যেমন, কোনও ফাইল যদি অ্যাপ্লিকেশনের ডকুমেন্ট ডিরেক্টরিতে থাকে, তাহলে ফাইল পাথ তৈরি করতে অফিসিয়াল path_provider প্যাকেজ ব্যবহার করুন এবং putFile()-এ পাস করুন:

Directory appDocDir = await getApplicationDocumentsDirectory();
String filePath = '${appDocDir.absolute}/file-to-upload.png';
File file = File(filePath);

try {
  await mountainsRef.putFile(file);
} on firebase_core.FirebaseException catch (e) {
  // ...
}

স্ট্রিং থেকে আপলোড করুন

আপনি putString() পদ্ধতি ব্যবহার করে র, base64, base64url বা data_url এনকোড করা স্ট্রিং হিসেবে ডেটা আপলোড করতে পারবেন। যেমন, ডেটা URL হিসেবে এনকোড করা টেক্সট স্ট্রিং আপলোড করতে:

String dataUrl = 'data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==';

try {
  await mountainsRef.putString(dataUrl, format: PutStringFormat.dataUrl);
} on FirebaseException catch (e) {
  // ...
}

প্রসেস না করা ডেটা আপলোড করুন

যেসব ক্ষেত্রে স্ট্রিং বা File আপলোড করা সম্ভব নয়, সেখানে আপনি Uint8List হিসেবে লোয়ার-লেভেল টাইপ করা ডেটা আপলোড করতে পারবেন। এই ক্ষেত্রে, আপনার ডেটা সহ putData() মেথড কল করুন:

try {
  // Upload raw data.
  await mountainsRef.putData(data);
} on firebase_core.FirebaseException catch (e) {
  // ...
}

ডাউনলোড URL পান

ফাইল আপলোড করার পরে, আপনি Reference-এ getDownloadUrl() পদ্ধতি কল করে ফাইলটি ডাউনলোড করার জন্য একটি URL পেতে পারেন:

await mountainsRef.getDownloadURL();

ফাইলের মেটাডেটা যোগ করা

এছাড়াও, ফাইল আপলোড করার সময় আপনি মেটাডেটা অন্তর্ভুক্ত করতে পারবেন। এই মেটাডেটাতে সাধারণ ফাইল মেটাডেটা প্রপার্টি থাকে যেমন contentType (সাধারণত MIME টাইপ হিসেবে উল্লেখ করা হয়)। putFile() পদ্ধতিটি অটোমেটিক File এক্সটেনশন থেকে MIME-এর প্রকার অনুমান করে, তবে আপনি মেটাডেটাতে contentType নির্দিষ্ট করে অটোমেটিক শনাক্ত করা প্রকার ওভাররাইড করতে পারেন। আপনি contentType প্রদান না করলে এবং Cloud Storage ফাইল এক্সটেনশন থেকে ডিফল্ট অনুমান করতে না পারলে, Cloud Storage application/octet-stream ব্যবহার করে। আরও তথ্যের জন্য, ফাইলের মেটাডেটা ব্যবহার করুন দেখুন।

try {
  await mountainsRef.putFile(file, SettableMetadata(
    contentType: "image/jpeg",
  ));
} on firebase_core.FirebaseException catch (e) {
  // ...
}

আপলোড ম্যানেজ করুন

আপলোড শুরু করার পাশাপাশি, আপনি pause(), resume() এবং cancel() পদ্ধতি ব্যবহার করে আপলোড পজ, আবার শুরু এবং বাতিল করতে পারবেন। ইভেন্ট পজ ও আবার চালু করা যথাক্রমে pause ও progress স্টেট পরিবর্তন করে। আপলোড বাতিল করলে, আপলোড বাতিল করা হয়েছে বলে একটি সমস্যার মেসেজ দেখানো হয়।

final task = mountainsRef.putFile(largeFile);

// Pause the upload.
bool paused = await task.pause();
print('paused, $paused');

// Resume the upload.
bool resumed = await task.resume();
print('resumed, $resumed');

// Cancel the upload.
bool canceled = await task.cancel();
print('canceled, $canceled');

আপলোড প্রগ্রেস মনিটর করা

আপনার আপলোড টাস্কের সাফল্য, ব্যর্থতা, অগ্রগতি বা বিরতি ম্যানেজ করতে আপনি টাস্কের ইভেন্ট স্ট্রিম শুনতে পারেন:

ইভেন্টের ধরন সাধারণ ব্যবহার
TaskState.running ডেটা ট্রান্সফার করার সময় মাঝে মাঝে নির্গত হয় এবং আপলোড/ডাউনলোড ইন্ডিকেটর পপুলেট করার জন্য ব্যবহার করা যেতে পারে।
TaskState.paused টাস্ক পজ করা হলে যেকোনও সময় নির্গত হয়।
TaskState.success টাস্ক সম্পূর্ণ হলে নির্গত হয়।
TaskState.canceled টাস্ক বাতিল করা হলে যেকোনও সময় নির্গত হয়।
TaskState.error আপলোড করা না গেলে নির্গত হয়। নেটওয়ার্ক টাইমআউট, অনুমোদনে ব্যর্থতা বা আপনি টাস্ক বাতিল করলে এটি হতে পারে।
mountainsRef.putFile(file).snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // ...
      break;
    case TaskState.paused:
      // ...
      break;
    case TaskState.success:
      // ...
      break;
    case TaskState.canceled:
      // ...
      break;
    case TaskState.error:
      // ...
      break;
  }
});

সমস্যা ম্যানেজ করা

আপলোড করার সময় বিভিন্ন কারণে সমস্যা হতে পারে, যেমন লোকাল ফাইল না থাকা অথবা ব্যবহারকারীর কাছে নির্দিষ্ট ফাইল আপলোড করার অনুমতি না থাকা। সমস্যা সম্পর্কে আরও জানতে, সমস্যা সমাধান করুন দেখুন।

সম্পূর্ণ উদাহরণ

প্রগ্রেস মনিটরিং ও সমস্যা সমাধানের সাথে আপলোডের সম্পূর্ণ উদাহরণ নিচে দেখানো হল:

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/path/to/mountains.jpg";
final file = File(filePath);

// Create the file metadata
final metadata = SettableMetadata(contentType: "image/jpeg");

// Create a reference to the Cloud Storage bucket
final storageRef = FirebaseStorage.instance.ref();

// Upload file and metadata to the path 'images/mountains.jpg'
final uploadTask = storageRef
    .child("images/path/to/mountains.jpg")
    .putFile(file, metadata);

// Listen for state changes, errors, and completion of the upload.
uploadTask.snapshotEvents.listen((TaskSnapshot taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      final progress =
          100.0 * (taskSnapshot.bytesTransferred / taskSnapshot.totalBytes);
      print("Upload is $progress% complete.");
      break;
    case TaskState.paused:
      print("Upload is paused.");
      break;
    case TaskState.canceled:
      print("Upload was canceled");
      break;
    case TaskState.error:
      // Handle unsuccessful uploads
      break;
    case TaskState.success:
      // Handle successful uploads on complete
      // ...
      break;
  }
});

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