camera.processPicture

প্রসেস ইমেজ, যা আগে ক্যাপচার করা হয়েছিল, কিন্তু এখনও প্রসেস করা হয়নি। এই কমান্ডটি প্রাসঙ্গিক তখনই যদি আপনি delayProcessing সমর্থন করেন যেহেতু প্রক্রিয়াকরণে দীর্ঘ সময় লাগে। আপনি delayProcessing সমর্থন না করলে, এই কমান্ডের জন্য অনুরোধ ত্রুটি কোড disabledCommand দিয়ে ব্যর্থ হওয়া উচিত। এই কমান্ডটি API স্তর 2 এ যোগ করা হয়েছে।

পরামিতি

  • previewFileUrls: প্রক্রিয়া না করা ছবির URL-এর একটি তালিকা। আপনি যদি ক্যামেরায় সমস্ত অপ্রক্রিয়াজাত ছবিগুলি প্রক্রিয়া করতে চান তবে এটি [“সমস্ত”]। এটা খালি হতে পারে না. ক্যামেরার কোনো ছবি প্রসেস করতে সমস্যা হলে, ক্যামেরা ত্রুটির সাথে সাড়া দেয় না, পরিবর্তে, এটি সেই URLটিকে উপেক্ষা করে অন্যদের সাথে এগিয়ে যাওয়া উচিত, এবং চরম ক্ষেত্রে previewToFinalFileUrls একটি খালি JSONObject হিসাবে ফিরে আসে।

ফলাফল

  • previewToFinalFileUrls: JSON-এর একটি JSONObject জোড়া, যেখানে প্রতিটি কী হল প্রিভিউ ইমেজের নিখুঁত URL, এবং প্রতিটি কী হল সংশ্লিষ্ট চূড়ান্ত প্রক্রিয়াকৃত ছবি এবং ক্যামেরা থেকে সরাসরি ডাউনলোড করতে ব্যবহার করা যেতে পারে। অনুগ্রহ করে মনে রাখবেন এই কমান্ডটি camera.takePicture-এর অনুরূপ, এবং অবিলম্বে previewToFinalFileUrls ফেরত দেয় না (এই অনুচ্ছেদে পরে ব্যাখ্যা করা একটি কর্নার কেস ব্যতীত) যেহেতু প্রক্রিয়াকরণ (ইন-ক্যামেরা সেলাই সহ) সাধারণত কিছু সময় নেয় (সেকেন্ড থেকে মিনিটে পরিবর্তিত হয়) ) শেষ করতে. কমান্ডের অগ্রগতি /osc/commands/status API ব্যবহার করে পর্যায়ক্রমে ক্যামেরা পোল করার মাধ্যমে প্রাপ্ত করা হয় এবং কমান্ডটি শেষ হলে previewToFinalFileUrls ফলাফলটি ফিরে আসে। কমান্ডটি শেষ হওয়ার আগে যদি ক্যামেরার সাথে সংযোগটি হারিয়ে যায়, ক্লায়েন্ট ক্যামেরার সাথে আবার সংযুক্ত হওয়ার পরে চূড়ান্ত চিত্রগুলির URL গুলি পেতে listFiles ব্যবহার করতে পারে বা অন্য একটি processPicture কমান্ড ইস্যু করতে পারে, যা পূর্বে previewToFinalFileUrls অবিলম্বে ফিরিয়ে দেবে যদি ছবিগুলি ইতিমধ্যেই প্রক্রিয়াকরণের আগে প্রক্রিয়া করা হয়ে থাকে। পুনঃসংযোগ

ত্রুটি

  • disabledCommand: আপনি যদি বিলম্ব প্রক্রিয়াকরণ সমর্থন না করেন।
  • invalidParameterName: ইনপুট প্যারামিটার নামটি অচেনা।
  • invalidParameterValue: ইনপুট প্যারামিটার নাম স্বীকৃত, কিন্তু এর মান অবৈধ; উদাহরণস্বরূপ, previewFileUrls এর যেকোনো URL অবৈধ।

কমান্ড I/O

কমান্ড ইনপুট
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
কমান্ড আউটপুট
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
কমান্ড আউটপুট (ত্রুটি)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}