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

Cloud Storage for Firebase আপনাকে Firebase-এর দেওয়া ও ম্যানেজ করা Cloud Storage বাকেটে দ্রুত ও সহজে ফাইল আপলোড করতে দেয়।

রেফারেন্স তৈরি করা

কোনও ফাইল আপলোড করতে, প্রথমে আপনি যে ফাইল আপলোড করতে চান সেটির Cloud Storage রেফারেন্স তৈরি করুন।

আপনার Cloud Storage বালতির রুটে চাইল্ড পাথ যোগ করে আপনি রেফারেন্স তৈরি করতে পারেন অথবা আগে থেকে থাকা gs:// বা https:// URL থেকে রেফারেন্স তৈরি করতে পারেন যা Cloud Storage-এ কোনও অবজেক্টকে রেফার করে।

// Create a root reference
StorageReference storageRef = storage.RootReference;

// Create a reference to "mountains.jpg"
StorageReference mountainsRef = storageRef.Child("mountains.jpg");

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

// While the file names are the same, the references point to different files
Assert.AreEqual(mountainsRef.Name, mountainImagesRef.Name);
Assert.AreNotEqual(mountainsRef.Path, mountainImagesRef.Path);

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

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

রেফারেন্স পেয়ে গেলে, আপনি দুটি উপায়ে Cloud Storage-এ ফাইল আপলোড করতে পারবেন:

  1. মেমরিতে থাকা বাইট অ্যারে থেকে আপলোড করা
  2. ডিভাইসে থাকা কোনও ফাইলের ফাইল পাথ থেকে আপলোড করা

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

PutBytesAsync() পদ্ধতি হল Cloud Storage-এ ফাইল আপলোড করার সবচেয়ে সহজ উপায়। PutBytesAsync() একটি byte[] নেয় এবং একটি System.Task<Firebase.Storage.StorageMetadata> রিটার্ন করে, যেটি টাস্ক সম্পূর্ণ হলে ফাইল সম্পর্কে তথ্য কন্টেন করবে। আপনি চাইলে আপলোড স্ট্যাটাস মনিটর করার জন্য IProgress<UploadState> (সাধারণত StorageProgress<UploadState>) ব্যবহার করতে পারেন।

// Data in memory
var customBytes = new byte[] {
    /*...*/
};

// Create a reference to the file you want to upload
StorageReference riversRef = storageRef.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
riversRef.PutBytesAsync(customBytes)
    .ContinueWith((Task<StorageMetadata> task) => {
        if (task.IsFaulted || task.IsCanceled) {
            Debug.Log(task.Exception.ToString());
            // Uh-oh, an error occurred!
        }
        else {
            // Metadata contains file metadata such as size, content-type, and md5hash.
            StorageMetadata metadata = task.Result;
            string md5Hash = metadata.Md5Hash;
            Debug.Log("Finished uploading...");
            Debug.Log("md5 hash = " + md5Hash);
        }
    });

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

PutFileAsync() পদ্ধতির মাধ্যমে আপনি ডিভাইসে লোকাল ফাইল আপলোড করতে পারবেন, যেমন, ক্যামেরা থেকে তোলা ফটো ও ভিডিও। PutFileAsync() একটি string নেয় যা ফাইলের পাথকে বোঝায় এবং একটি System.Task<Firebase.Storage.StorageMetadata> রিটার্ন করে যার মধ্যে টাস্ক সম্পূর্ণ হলে ফাইল সম্পর্কিত তথ্য থাকে। আপনি চাইলে আপলোড স্ট্যাটাস মনিটর করার জন্য IProgress<UploadState> (সাধারণত StorageProgress<UploadState>) ব্যবহার করতে পারেন।

// File located on disk
string localFile = "...";

// Create a reference to the file you want to upload
StorageReference riversRef = storageRef.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
riversRef.PutFileAsync(localFile)
    .ContinueWith((Task<StorageMetadata> task) => {
        if (task.IsFaulted || task.IsCanceled) {
            Debug.Log(task.Exception.ToString());
            // Uh-oh, an error occurred!
        }
        else {
            // Metadata contains file metadata such as size, content-type, and download URL.
            StorageMetadata metadata = task.Result;
            string md5Hash = metadata.Md5Hash;
            Debug.Log("Finished uploading...");
            Debug.Log("md5 hash = " + md5Hash);
        }
    });

আপনি যদি নিজের আপলোড অ্যাক্টিভভাবে মনিটর করতে চান, তাহলে PutFileAsync() বা PutBytesAsync() পদ্ধতি সহ StorageProgress ক্লাস বা আপনার নিজস্ব ক্লাস ব্যবহার করতে পারেন যা IProgress<UploadState> প্রয়োগ করে। আরও তথ্যের জন্য আপলোড ম্যানেজ করা দেখুন।

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

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

// Create storage reference
StorageReference mountainsRef = storageRef.Child("images/mountains.jpg");

byte[] customBytes = new byte[] {
    /*...*/
};
string localFile = "...";

// Create file metadata including the content type
var newMetadata = new MetadataChange();
newMetadata.ContentType = "image/jpeg";

// Upload data and metadata
mountainsRef.PutBytesAsync(customBytes, newMetadata, null,
    CancellationToken.None); // .ContinueWithOnMainThread(...
// Upload file and metadata
mountainsRef.PutFileAsync(localFile, newMetadata, null,
    CancellationToken.None); // .ContinueWithOnMainThread(...

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

আপলোড মনিটর করার জন্য আপনি আপলোডের সাথে লিসনার অ্যাটাচ করতে পারেন। শ্রোতা স্ট্যান্ডার্ড System.IProgress<T> ইন্টারফেস অনুসরণ করে। প্রগ্রেস টিকের জন্য কলব্যাক হিসেবে আপনার নিজস্ব Action<T> প্রদান করতে, আপনি StorageProgress ক্লাসের একটি ইনস্ট্যান্স ব্যবহার করতে পারেন।

// Start uploading a file
var task = storageRef.Child("images/mountains.jpg")
    .PutFileAsync(localFile, null,
        new StorageProgress<UploadState>(state => {
            // called periodically during the upload
            Debug.Log(String.Format("Progress: {0} of {1} bytes transferred.",
                state.BytesTransferred, state.TotalByteCount));
        }), CancellationToken.None, null);

task.ContinueWithOnMainThread(resultTask => {
    if (!resultTask.IsFaulted && !resultTask.IsCanceled) {
        Debug.Log("Upload finished.");
    }
});

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

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

পরবর্তী ধাপ

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