CameraEventImage स्कीमा

Nest Cam (लेगसी) Nest Hub Max Nest Doorbell (लेगसी) 

sdm.devices.traits.CameraEventImage

यह ट्रैट किसी भी ऐसे डिवाइस से जुड़ा होता है जिस पर इवेंट से इमेज जनरेट करने की सुविधा काम करती है.

फ़ील्ड

इस विशेषता के लिए कोई फ़ील्ड उपलब्ध नहीं है.

निर्देश

GenerateImage

कैमरे से ली गई इमेज डाउनलोड करने के लिए यूआरएल उपलब्ध कराता है.

यह कमांड इन इवेंट के साथ काम करता है:

टाइप एलिमेंट ब्यौरा
इवेंट CameraMotion ट्रैट का मोशन इवेंट कैमरे ने मोशन का पता लगाया है.
इवेंट CameraPerson ट्रैट का व्यक्ति इवेंट कैमरे ने किसी व्यक्ति की पहचान की है.
इवेंट CameraSound ट्रैट का साउंड इवेंट कैमरे ने आवाज़ की पहचान की है.
इवेंट DoorbellChime ट्रीट की मदद से, घंटी बजने की सूचना देने वाला इवेंट दरवाज़े की घंटी बजाई गई है.
उस इवेंट से जुड़ी कैमरे की इमेज का डाउनलोड यूआरएल पाने के लिए, कमांड अनुरोध में, इस्तेमाल किए जा सकने वाले इवेंट से eventId का इस्तेमाल करें.

GenerateImage का अनुरोध और रिस्पॉन्स

अनुरोधजवाब
POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "W5ee-_6HEyr8JQUP_rp8NWz1SI..."
  }
}

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

GenerateImage अनुरोध फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
eventId उस इवेंट का आईडी जिसके लिए कैमरे से ली गई इमेज का अनुरोध करना है. string
उदाहरण: "W5ee-_6HEyr8JQUP_rp8NWz1SI..."

GenerateImage के रिस्पॉन्स फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
url कैमरे से ली गई इमेज डाउनलोड करने के लिए यूआरएल. string
उदाहरण: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token इमेज डाउनलोड करते समय, एचटीटीपी अनुमति हेडर में इस्तेमाल करने के लिए टोकन. string
उदाहरण: "g.0.eventToken"

कैमरे से ली गई इमेज डाउनलोड करना

कैमरे की इमेज डाउनलोड करने के लिए, GenerateImage कमांड के रिस्पॉन्स से, url को GET कॉल करें. इसके लिए, एचटीटीपी अनुमति हेडर में 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

डाउनलोड यूआरएल पर ये अन्य पाबंदियां लागू होती हैं:

  • अगर यूआरएल में दोनों पैरामीटर दिए गए हैं, तो width का इस्तेमाल किया जाता है और height को अनदेखा कर दिया जाता है.
  • अगर यूआरएल में कोई पैरामीटर नहीं दिया गया है, तो width के लिए डिफ़ॉल्ट वैल्यू 480 चुनी जाती है.

इमेज प्रॉपर्टी के बारे में जानकारी के लिए, CameraImage ट्रैट देखें.

गड़बड़ियां

इस विशेषता के लिए, गड़बड़ी के ये कोड दिख सकते हैं:

गड़बड़ी का मैसेज RPC समस्या का हल
कैमरे की इमेज अब डाउनलोड करने के लिए उपलब्ध नहीं है. DEADLINE_EXCEEDED इवेंट पब्लिश होने के 30 सेकंड बाद, इवेंट की इमेज दिखना बंद हो जाती हैं. समयसीमा खत्म होने से पहले, इमेज डाउनलोड कर लें.
इवेंट आईडी, कैमरे से जुड़ा नहीं है. FAILED_PRECONDITION कैमरा इवेंट से मिले सही eventID का इस्तेमाल करें.

एपीआई से जुड़ी गड़बड़ियों के कोड की पूरी सूची के लिए, एपीआई से जुड़ी गड़बड़ी के कोड का रेफ़रंस देखें.