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" : "NN8k3HYP9wKsv127QA397EOerd..."
  }
}

রেসপন্স

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

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

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

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

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

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

url-এ GET কল করুন GenerateImage কমান্ড রেসপন্স থেকে, বেসিক অথরাইজেশন সহ 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-এর জন্য ডিফল্ট ভ্যালু হিসেবে ৪৮০ বেছে নেওয়া হয়।

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

সমস্যা

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

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

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