chrome.fileBrowserHandler

বর্ণনা

অনুমতি

প্রাপ্যতা

ChromeOS ফাইল ব্রাউজারটি আসে যখন ব্যবহারকারী Alt+Shift+M টিপে বা একটি SD কার্ড, USB কী, এক্সটার্নাল ড্রাইভ বা ডিজিটাল ক্যামেরার মতো একটি বাহ্যিক স্টোরেজ ডিভাইস সংযোগ করে। বাহ্যিক ডিভাইসে ফাইল দেখানোর পাশাপাশি, ফাইল ব্রাউজার সেই ফাইলগুলিও প্রদর্শন করতে পারে যা ব্যবহারকারী পূর্বে সিস্টেমে সংরক্ষণ করেছেন।

যখন ব্যবহারকারী এক বা একাধিক ফাইল নির্বাচন করে, ফাইল ব্রাউজার সেই ফাইলগুলির জন্য বৈধ হ্যান্ডলার প্রতিনিধিত্বকারী বোতামগুলি যোগ করে। উদাহরণস্বরূপ, নিম্নলিখিত স্ক্রিনশটে, একটি ".png" প্রত্যয় সহ একটি ফাইল নির্বাচন করার ফলে একটি "গ্যালারিতে সংরক্ষণ করুন" বোতামে ব্যবহারকারী ক্লিক করতে পারেন৷

উদ্ভাসিত

আপনাকে অবশ্যই এক্সটেনশন ম্যানিফেস্টে "fileBrowserHandler" অনুমতি ঘোষণা করতে হবে, এবং আপনাকে অবশ্যই "file_browser_handlers" ক্ষেত্রটি ব্যবহার করতে হবে এক্সটেনশনটিকে কমপক্ষে একটি ফাইল প্রকারের হ্যান্ডলার হিসাবে নিবন্ধন করতে৷ বোতামে প্রদর্শিত হওয়ার জন্য আপনাকে একটি 16x16 আইকনও প্রদান করা উচিত। যেমন:

{
  "name": "My extension",
  ...
  "file_browser_handlers": [
    {
      "id": "upload",
      "default_title": "Save to Gallery", // What the button will display
      "file_filters": [
        "filesystem:*.jpg",  // To match all files, use "filesystem:*.*"
        "filesystem:*.jpeg",
        "filesystem:*.png"
      ]
    }
  ],
  "permissions" : [
    "fileBrowserHandler"
  ],
  "icons": {
    "16": "icon16.png",
    "48": "icon48.png",
    "128": "icon128.png"
  },
  ...
}

একটি ফাইল ব্রাউজার হ্যান্ডলার বাস্তবায়ন

এই API ব্যবহার করতে, আপনাকে অবশ্যই একটি ফাংশন বাস্তবায়ন করতে হবে যা chrome.fileBrowserHandler এর onExecute ইভেন্ট পরিচালনা করে। যখনই ব্যবহারকারী আপনার ফাইল ব্রাউজার হ্যান্ডলারের প্রতিনিধিত্ব করে এমন বোতামটি ক্লিক করবে তখনই আপনার ফাংশনটি কল করা হবে। আপনার ফাংশনে, ফাইলের বিষয়বস্তুতে অ্যাক্সেস পেতে ফাইল সিস্টেম API ব্যবহার করুন। এখানে একটি উদাহরণ:

chrome.fileBrowserHandler.onExecute.addListener(async (id, details) => {
  if (id !== 'upload') {
    return;  // check if you have multiple file_browser_handlers
  }

  for (const entry of detail.entries) {
    // the FileSystemFileEntry doesn't have a Promise API, wrap in one
    const file = await new Promise((resolve, reject) => {
      entry.file(resolve, reject);
    });
    const buffer = await file.arrayBuffer();
    // do something with buffer
  }
});

আপনার ইভেন্ট হ্যান্ডলার দুটি আর্গুমেন্ট পাস করেছে:

আইডি

ম্যানিফেস্ট ফাইল থেকে "id" মান। আপনার এক্সটেনশন একাধিক হ্যান্ডলার প্রয়োগ করলে, কোন হ্যান্ডলার ট্রিগার হয়েছে তা দেখতে আপনি আইডি মান পরীক্ষা করতে পারেন।

বিস্তারিত

ঘটনা বর্ণনাকারী একটি বস্তু। আপনি এই অবজেক্টের entries ক্ষেত্র থেকে ব্যবহারকারী নির্বাচিত ফাইল বা ফাইলগুলি পেতে পারেন, যা FileSystemFileEntry অবজেক্টের একটি অ্যারে।

chrome.fileBrowserHandler.onExecute.addListener(
  callback: function,
)