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

নেস্ট ক্যাম (পুরানো সংস্করণ) নেস্ট হাব ম্যাক্স নেস্ট ডোরবেল (পুরানো সংস্করণ)

sdm.devices.traits.CameraEventImage

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

ক্ষেত্র

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

কমান্ড

ছবি তৈরি করুন

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

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

প্রকার	উপাদান	বর্ণনা
অনুষ্ঠান	CameraMotion বৈশিষ্ট্যের মোশন ইভেন্ট	ক্যামেরায় গতি শনাক্ত করা হয়েছে।
অনুষ্ঠান	CameraPerson বৈশিষ্ট্যের ব্যক্তি ইভেন্ট	ক্যামেরায় একজন ব্যক্তিকে শনাক্ত করা হয়েছে।
অনুষ্ঠান	CameraSound বৈশিষ্ট্যের সাউন্ড ইভেন্ট	ক্যামেরায় শব্দ শনাক্ত করা হয়েছে।
অনুষ্ঠান	DoorbellChime বৈশিষ্ট্যের Chime ইভেন্ট	কলিং বেল টিপা হয়েছে।

কোনো সমর্থিত ইভেন্টের সাথে সম্পর্কিত ক্যামেরা ইমেজের ডাউনলোড ইউআরএল পেতে, কমান্ড অনুরোধে সেই ইভেন্টের eventId ব্যবহার করুন।

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

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

অনুরোধ

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

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

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

ছবি তৈরি করার অনুরোধ ক্ষেত্রগুলি

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

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

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

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

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

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

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

উদাহরণস্বরূপ, যদি ক্যামেরার অ্যাসপেক্ট রেশিও 4:3 হয়, তাহলে 480 x 360 রেজোলিউশনে ক্যামেরার ছবিটি ডাউনলোড করতে হলে প্রস্থ অথবা উচ্চতা নির্দিষ্ট করে দিন:

প্রস্থ

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 ব্যবহার করুন।

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