CameraEventImage स्कीमा

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

sdm.devices.traits.CameraEventImage

यह trait ऐसे किसी भी डिवाइस का है जिस पर इवेंट से इमेज जनरेट की जा सकती हैं.

फ़ील्ड

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

निर्देश

GenerateImage

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

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

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

इमेज के लिए अनुरोध और जवाब जनरेट करें

अनुरोध

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

जवाब

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

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

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

इमेज के जवाब वाले फ़ील्ड जनरेट करें

फ़ील्ड ब्यौरा डेटा टाइप
url वह यूआरएल जिससे कैमरा इमेज डाउनलोड करनी है. string
उदाहरण के लिए: "https://domain/sdm_event_stapshot/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 एट्रिब्यूट देखें.

गड़बड़ियां

इस trait के संबंध में, ये गड़बड़ी कोड दिखाए जा सकते हैं:

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

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