ক্যামেরা। ছবি তোলা

একটি ইকুরেক্টাঙ্গুলার ইমেজ ক্যাপচার করে, ল্যাট/লং স্থানাঙ্কগুলিকে EXIF-এ সংরক্ষণ করে (যদি আপনার ক্যামেরার নিজস্ব GPS বা GPS সংযুক্ত মোবাইল ফোনে সক্ষম থাকে)। প্রয়োজনে এই কমান্ড কল করার আগে camera.setOptions কল করুন। এই কমান্ডটি এপিআই লেভেল 2 এ পরিবর্তন করা হয়েছে।

পরামিতি

  • sessionId: camera.startSession কমান্ড থেকে প্রাপ্ত অনন্য সেশন শনাক্তকারী। এপিআই লেভেল 2-এ এই ক্ষেত্রটি বাতিল করা হয়েছে।

ফলাফল

  • API স্তর 1
    • fileUri: ক্যাপচার করা ছবির URI। পরম বা আপেক্ষিক ইউআরআই ব্যবহার করবেন কিনা তা নির্মাতারা সিদ্ধান্ত নেয়; উদাহরণস্বরূপ, " http://android.com/robots.txt " হল একটি পরম URI যখন "robots.txt" হল একটি আপেক্ষিক URI৷ ক্লায়েন্টরা এটিকে একটি অস্বচ্ছ শনাক্তকারী হিসাবে বিবেচনা করতে পারে।
  • API স্তর 2
    • fileUrl: ক্যাপচার করা ছবির সম্পূর্ণ URL, যা ক্যামেরার HTTP সার্ভার থেকে সরাসরি ডাউনলোড করতে ব্যবহার করা যেতে পারে। অনুগ্রহ করে মনে রাখবেন এই কমান্ডটি অবিলম্বে fileUrl ফেরত দেয় না যেহেতু ক্যাপচার (ইন-ক্যামেরা স্টিচিং সহ) সাধারণত সম্পূর্ণ হতে কিছুটা সময় নেয় (সেকেন্ড থেকে মিনিটে পরিবর্তিত হয়)। কমান্ডের অগ্রগতি /osc/commands/status API ব্যবহার করে পর্যায়ক্রমে ক্যামেরা পোলিং করে প্রাপ্ত করা হয় এবং কমান্ড শেষ হলে fileUrl ফলাফলটি ফেরত দেয়। যখন delayProcessing সত্য হয়, এটি হল প্রিভিউ ইমেজের নিখুঁত URL, যা ইমেজ প্রক্রিয়া করার জন্য processPicture-এ ইনপুট হিসাবে ব্যবহার করা যেতে পারে, অন্যথায়, এটি চূড়ান্ত প্রক্রিয়াকৃত ছবির পরম URL।

ত্রুটি

  • missing Parameter: sessionId অনুপস্থিত। এপিআই লেভেল 2-এ এই ত্রুটি কোডটি বাতিল করা হয়েছে।
  • invalidParameterName: প্যারামিটারের নামটি অস্বীকৃত, যেমন sessionId API স্তর 2-এ স্বীকৃত নয়।
  • invalidParameterValue: ইনপুট প্যারামিটার নাম স্বীকৃত, কিন্তু এর মান অবৈধ; উদাহরণস্বরূপ, sessionId বিদ্যমান নেই, আর সক্রিয় নেই, বা এর ডেটা টাইপটি ভুল। এপিআই লেভেল 2-এ এই ত্রুটি কোডটি বাতিল করা হয়েছে।
  • disabledCommand: কমান্ড বর্তমানে নিষ্ক্রিয়; উদাহরণস্বরূপ, ক্যামেরাটি ভিডিও শুটিং মোডে রয়েছে। এই ত্রুটি কোডটি API স্তর 2 এ যোগ করা হয়েছে।

কমান্ড I/O

কমান্ড ইনপুট (API স্তর 1)
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
কমান্ড আউটপুট (API স্তর 1)
{
    "results": {
        "fileUri": "file URI"
    }
}
কমান্ড আউটপুট (ত্রুটি) (API স্তর 1)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
কমান্ড ইনপুট (API স্তর 2)
none
কমান্ড আউটপুট (API স্তর 2)
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
কমান্ড আউটপুট (ত্রুটি) (API স্তর 2)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}