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