ক্যামেরাইভেন্টইমেজ স্কিমা

নেস্ট ক্যাম (লিগ্যাসি) নেস্ট হাব ম্যাক্স নেস্ট ডোরবেল (লিগ্যাসি)

sdm.devices.traits.CameraEventImage

এই বৈশিষ্ট্যটি এমন যেকোনো ডিভাইসের ক্ষেত্রে প্রযোজ্য যা ইভেন্ট থেকে ছবি তৈরিতে সহায়তা করে।

ক্ষেত্র

এই বৈশিষ্ট্যের জন্য কোনও ক্ষেত্র উপলব্ধ নেই।

কমান্ড

চিত্র তৈরি করুন

ক্যামেরার ছবি ডাউনলোড করার জন্য একটি URL প্রদান করে।

এই কমান্ডটি নিম্নলিখিত ইভেন্টগুলিকে সমর্থন করে:

আদর্শ উপাদান বিবরণ
ইভেন্ট ক্যামেরামোশন বৈশিষ্ট্যের গতি ইভেন্ট ক্যামেরা গতি সনাক্ত করেছে।
ইভেন্ট ক্যামেরাপারসন বৈশিষ্ট্যের ব্যক্তি ইভেন্ট ক্যামেরা একজন ব্যক্তিকে শনাক্ত করেছে।
ইভেন্ট ক্যামেরাসাউন্ড বৈশিষ্ট্যের সাউন্ড ইভেন্ট ক্যামেরা শব্দ শনাক্ত করেছে।
ইভেন্ট ডোরবেলচাইম বৈশিষ্ট্যের কাইম ইভেন্ট ডোরবেল টিপানো হয়েছে।
সেই ইভেন্টের সাথে সম্পর্কিত ক্যামেরা ছবির জন্য একটি ডাউনলোড URL পেতে কমান্ড রিকোয়েস্টে একটি সমর্থিত ইভেন্ট থেকে eventId ব্যবহার করুন।

GenerateImage অনুরোধ এবং প্রতিক্রিয়া

অনুরোধ 

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "eqxAGXAQ3bD4LQkqCi4R8XaqC_..."
  }
}

প্রতিক্রিয়া 

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

GenerateImage অনুরোধ ক্ষেত্র

মাঠ বিবরণ ডেটা টাইপ
eventId যে ইভেন্টের জন্য একটি সম্পর্কিত ক্যামেরা চিত্র অনুরোধ করতে হবে তার আইডি। string
উদাহরণ: "eqxAGXAQ3bD4LQkqCi4R8XaqC_..."

চিত্র প্রতিক্রিয়া ক্ষেত্র তৈরি করুন

মাঠ বিবরণ ডেটা টাইপ
url ক্যামেরার ছবি ডাউনলোড করার URL। string
উদাহরণ: "https:// domain /sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token ছবি ডাউনলোড করার সময় HTTP অনুমোদন শিরোনামে ব্যবহার করার জন্য টোকেন। string
উদাহরণ: "g.0.eventToken"

একটি ক্যামেরা ছবি ডাউনলোড করুন

একটি থেকে url এ GET কল করুন চিত্র তৈরি করুন ক্যামেরার ছবি ডাউনলোড করার জন্য বেসিক অথরাইজেশন সহ HTTP অথরাইজেশন হেডারে token ব্যবহার করে কমান্ড রেসপন্স:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

ডাউনলোড করা ছবির রেজোলিউশন কাস্টমাইজ করতে width বা height কোয়েরি প্যারামিটার ব্যবহার করুন। এই প্যারামিটারগুলির মধ্যে কেবল একটি নির্দিষ্ট করতে হবে। অন্য প্যারামিটারটি ক্যামেরার আকৃতির অনুপাত অনুসারে স্বয়ংক্রিয়ভাবে স্কেল করা হয়।

উদাহরণস্বরূপ, যদি ক্যামেরার আকৃতির অনুপাত ৪:৩ হয়, তাহলে ৪৮০ x ৩৬০ রেজোলিউশনের ক্যামেরার ছবি ডাউনলোড করতে প্রস্থ অথবা উচ্চতা উল্লেখ করুন:

প্রস্থ 

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

উচ্চতা 

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

ডাউনলোড URL-এর ক্ষেত্রে অন্যান্য বিধিনিষেধ প্রযোজ্য:

  • যদি উভয় প্যারামিটারই URL-এ দেওয়া থাকে, তাহলে width ব্যবহার করা হবে এবং height উপেক্ষা করা হবে।
  • যদি URL-এ কোনও প্যারামিটার না থাকে, তাহলে width জন্য 480 এর একটি ডিফল্ট মান বেছে নেওয়া হয়।

দেখুন ক্যামেরা ইমেজ ছবির বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য বৈশিষ্ট্য।

ত্রুটি

এই বৈশিষ্ট্যের সাথে সম্পর্কিত নিম্নলিখিত ত্রুটি কোড(গুলি) ফেরত পাঠানো যেতে পারে:

ত্রুটি বার্তা আরপিসি সমস্যা সমাধান
ক্যামেরার ছবি আর ডাউনলোডের জন্য উপলব্ধ নেই। DEADLINE_EXCEEDED ইভেন্টের ছবি প্রকাশের ৩০ সেকেন্ড পরে শেষ হয়ে যায়। মেয়াদ শেষ হওয়ার আগে ছবিটি ডাউনলোড করতে ভুলবেন না।
ইভেন্ট আইডি ক্যামেরার অন্তর্গত নয়। FAILED_PRECONDITION ক্যামেরা ইভেন্ট দ্বারা প্রদত্ত সঠিক eventID ব্যবহার করুন।

API ত্রুটি কোডের সম্পূর্ণ তালিকার জন্য API ত্রুটি কোড রেফারেন্স দেখুন।