CameraEventImage स्कीमा

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

sdm.devices.traits.CameraEventImage

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

फ़ील्ड

इस Trait के लिए कोई फ़ील्ड उपलब्ध नहीं है.

निर्देश

GenerateImage

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

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

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

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

अनुरोध

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

जवाब

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

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

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

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

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

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

कैमरे की इमेज डाउनलोड करने के लिए, एचटीटीपी ऑथराइज़ेशन हेडर में token का इस्तेमाल करके, GenerateImage कमांड रिस्पॉन्स से url को GET कॉल करें:

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 का इस्तेमाल करें.

एपीआई के गड़बड़ी कोड की पूरी सूची देखने के लिए, एपीआई के गड़बड़ी कोड का संदर्भ देखें.