CameraEventImage स्कीमा
Nest Cam (लेगसी)
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 का इस्तेमाल करें. |
एपीआई से जुड़े गड़बड़ी कोड की पूरी सूची देखने के लिए, एपीआई से जुड़े गड़बड़ी कोड का रेफ़रंस देखें.