ইউনিটির জন্য ক্লাউড স্টোরেজ দিয়ে ফাইল আপলোড করুন

Cloud Storage for Firebase আপনাকে ফায়ারবেস দ্বারা সরবরাহিত এবং পরিচালিত Cloud Storage বালতিতে ফাইলগুলি দ্রুত এবং সহজেই আপলোড করতে দেয়।

একটি রেফারেন্স তৈরি করুন

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

আপনি আপনার Cloud Storage বালতিটির মূলে শিশুদের পাথ যুক্ত করে একটি রেফারেন্স তৈরি করতে পারেন, বা আপনি বিদ্যমান gs:// বা https:// ইউআরএল 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 বালতিটির মূলের রেফারেন্স সহ ডেটা আপলোড করতে পারবেন না। আপনার রেফারেন্স অবশ্যই একটি শিশু ইউআরএল নির্দেশ করতে হবে।

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

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

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

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

PutBytesAsync() পদ্ধতিটি Cloud Storage কোনও ফাইল আপলোড করার সহজ উপায়। PutBytesAsync() একটি বাইট নেয় [] এবং একটি 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() পদ্ধতিগুলির সাথে IProgress<UploadState> প্রয়োগ করে এমন একটি StorageProgress ক্লাস বা আপনার নিজস্ব ক্লাস ব্যবহার করতে পারেন। আরও তথ্যের জন্য আপলোডগুলি পরিচালনা করুন দেখুন।

ফাইল মেটাডেটা যুক্ত করুন

আপনি ফাইলগুলি আপলোড করার সময় আপনি মেটাডেটাও অন্তর্ভুক্ত করতে পারেন। এই মেটাডেটাতে সাধারণ ফাইল মেটাডেটা বৈশিষ্ট্য রয়েছে যেমন 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 থেকে সেগুলি ডাউনলোড করবেন তা শিখি।