CameraEventImage স্কিমা

Nest Cam (পুরনো) Nest Hub Max Nest Doorbell (পুরনো) 

sdm.devices.traits.CameraEventImage

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

ফিল্ড

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

কমান্ড

GenerateImage

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

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

ধরন এলিমেন্ট বিবরণ
ইভেন্ট CameraMotion ট্রেইটের মোশন ইভেন্ট ক্যামেরা মোশন শনাক্ত করেছে।
ইভেন্ট CameraPerson ট্রেইটের ব্যক্তি ইভেন্ট ক্যামেরা কোনও ব্যক্তিকে শনাক্ত করেছে।
ইভেন্ট CameraSound ট্রেইটের সাউন্ড ইভেন্ট ক্যামেরা সাউন্ড শনাক্ত করেছে।
ইভেন্ট DoorbellChime ট্রেইটের Chime ইভেন্ট কলিং বেল প্রেস করা হয়েছে।
কমান্ড অনুরোধে কাজ করে এমন ইভেন্ট থেকে eventId ব্যবহার করুন যাতে সেই ইভেন্ট সম্পর্কিত ক্যামেরা ইমেজের জন্য ডাউনলোড URL পেতে পারেন।

GenerateImage অনুরোধ ও উত্তর

অনুরোধ করুন

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

রেসপন্স

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

GenerateImage অনুরোধের ফিল্ড

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

GenerateImage রেসপন্স ফিল্ড

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

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

url-এ একটি GET কল করুন GenerateImage কমান্ড রেসপন্স থেকে, token ব্যবহার করে HTTP Authorization হেডারে Basic authorization সহ, ক্যামেরার ছবি ডাউনলোড করতে:

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-এর জন্য ডিফল্ট ভ্যালু হিসেবে ৪৮০ বেছে নেওয়া হয়।

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

সমস্যা

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

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

API-তে হওয়া সমস্যার কোডের সম্পূর্ণ তালিকা দেখতে, API-তে হওয়া সমস্যার কোডের রেফারেন্স দেখুন।