CameraEventImage स्कीमा

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

sdm.devices.traits.CameraEventImage

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

फ़ील्ड

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

निर्देश

GenerateImage

इससे कैमरा इमेज डाउनलोड करने के लिए यूआरएल मिलता है.

यह निर्देश इन इवेंट के साथ काम करता है:

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

इमेज के लिए अनुरोध और रिस्पॉन्स जनरेट करें

अनुरोध

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

जवाब

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

इमेज के लिए अनुरोध के फ़ील्ड जनरेट करें

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

इमेज के रिस्पॉन्स वाले फ़ील्ड जनरेट करें

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

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

url पर इससे, GET कॉल करें GenerateImage इसके लिए, कमांड रिस्पॉन्स सामान्य प्राधिकरण के साथ HTTP प्राधिकरण हेडर में 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 को अनदेखा कर दिया जाता है.
  • अगर यूआरएल में कोई भी पैरामीटर नहीं दिया गया है, तो 480 का डिफ़ॉल्ट मान चुना जाता है width.

ज़्यादा जानकारी के लिए, कैमरा इमेज इमेज के बारे में जानकारी देने की सुविधा प्रॉपर्टी.

गड़बड़ियां

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

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

इसके लिए एपीआई गड़बड़ी कोड संदर्भ देखें में देखें.