डिवाइस प्रबंधन
कोर प्लेटफ़ॉर्मdevice_health_readडिवाइस प्रबंधनकिसी सुविधा के नवीनतम इंटरनेट स्पीड टेस्ट की तुलना उसके डिवाइसों की आवश्यकता से करता है। network, Mbps में डाउनलोड और अपलोड स्पीड लौटाता है, और पिछले 24 घंटों में दिखी स्क्रीन, कैमरों (रिकॉर्डिंग और लाइव स्ट्रीमिंग) और कनेक्टेड स्पीकर सिस्टम के लिए: डिवाइसों की संख्या, हर एक को आवश्यक बैंडविड्थ और क्या कनेक्शन पर्याप्त है। इसका उपयोग धीमे या बार-बार डिस्कनेक्ट होने वाले डिवाइसों का निदान करने के लिए, या डिवाइस जोड़ने से पहले करें। कई सुविधाओं की जाँच करने के लिए facilityIds दें।
कार्रवाइयाँ:
- network: नेटवर्क बैंडविड्थ जाँच।
पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
action* | "network" | क्या करना है; प्रत्येक क्रिया का वर्णन टूल विवरण में है। |
facilityId | string | सुविधा ID। जब कनेक्टेड सुविधा ही आपकी अभीष्ट सुविधा हो, तो वैकल्पिक। |
facilityIds | array | कई सुविधा ID, ताकि हर एक पर वही अनुरोध चलाया जा सके। facilityId के स्थान पर उपयोग करें। |
device_inventory_readडिवाइस प्रबंधनकिसी सुविधा में पंजीकृत हर डिवाइस: डिस्प्ले स्क्रीन, क्लाउड कैमरे, नेटवर्क कैमरे, एआई एज प्रोसेसर, duress बटन, डोर कंट्रोलर, एआई एजेंट और IoT सेंसर। इसका उपयोग समस्या निवारण, उपकरणों के ऑडिट या किसी डिवाइस की ID ढूँढने के लिए करें।
हर डिवाइस में उसका प्रकार, मॉडल, IDs (deviceUuid; स्क्रीन के लिए deviceID; duress बटन के लिए deviceSerialNumber), स्थान, नेटवर्क विवरण (IP, Wi-Fi या Ethernet, SSID, चैनल, आस-पास के नेटवर्क; metadata.networkStats में PoE स्विच पोर्ट होता है), स्वास्थ्य (CPU तापमान, मेमोरी, अपटाइम) और metadata.updated, यानी Unix ms में अंतिम हार्टबीट, होते हैं। ऑफ़लाइन का अर्थ है 5 मिनट तक कोई हार्टबीट नहीं; जो डिवाइस 7 दिनों से अधिक ऑफ़लाइन है और जिसका कोई ऑनलाइन जुड़वाँ (वही उपकरण, नाम या स्थान) है, उसे संभवतः बदल दिया गया है। networkCamera पंक्तियाँ वे स्ट्रीम हैं जिन्हें edgeProcessorUUID वाला एज प्रोसेसर प्राप्त करता है; उनका deviceUuid (ep_ से शुरू) कमांड प्राप्त नहीं कर सकता। जब तक includeCredentials सेट न हो, स्ट्रीम URL क्रेडेंशियल : के रूप में दिखते हैं। Wi-Fi के बजाय वायर्ड Ethernet की सलाह दें।
संबंधित: cctv_cameras_read और cctv_cameras_write (कैमरे), cctv_edge_processors_write (एज प्रोसेसर), device_inventory_write (नाम बदलना, कॉन्फ़िगर करना, स्थानांतरित करना), device_send_command (नियंत्रण), device_health_read (बैंडविड्थ)।
कार्रवाइयाँ:
- list: डिवाइसों की सूची। सुविधा पर मौजूद डिवाइस, प्रकार या नाम के आधार पर फ़िल्टर किए गए। facilityIds के साथ, हर सुविधा अपना पहला पेज लौटाती है।
पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
action* | "list" | क्या करना है; प्रत्येक क्रिया का वर्णन टूल विवरण में है। |
facilityId | string | सुविधा ID। जब कनेक्टेड सुविधा ही आपकी अभीष्ट सुविधा हो, तो वैकल्पिक। |
facilityIds | array | कई सुविधा ID, ताकि हर एक पर वही अनुरोध चलाया जा सके। facilityId के स्थान पर उपयोग करें। |
deviceType | string | केवल यह प्रकार, deviceType के अनुसार: screen, camera, networkCamera, duress आदि |
query | string | नाम, कमरा, deviceID, deviceUuid या सीरियल नंबर में यह शामिल है |
includeCredentials | boolean | स्ट्रीम URL उनके उपयोगकर्ता नाम और पासवर्ड के साथ लौटाएँ। डिफ़ॉल्ट रूप से बंद (क्रेडेंशियल ***:*** के रूप में दिखते हैं)। इसे केवल तभी सेट करें जब उपयोगकर्ता को स्पष्ट रूप से क्रेडेंशियल चाहिए; इसके लिए सुविधा पर सीसीटीवी पहुँच आवश्यक है। |
limit | integer | प्रति पेज आइटम (डिफ़ॉल्ट 25, अधिकतम 100) |
cursor | string | पिछले पेज से nextCursor |
device_inventory_writeडिवाइस प्रबंधनकिसी सुविधा में पंजीकृत डिवाइस को बदलता है। rename_screen और configure_screen किसी डिस्प्ले स्क्रीन को बदलते हैं (उसे device_inventory_read से मिले deviceID से पहचानें); स्क्रीन के समूह, टैग या डिस्प्ले मोड के लिए इसके बजाय डिस्प्ले टूल का उपयोग करें। move किसी स्क्रीन, क्लाउड कैमरा, duress बटन, डोर कंट्रोलर, एआई एजेंट या एआई एज प्रोसेसर को उसी संगठन की दूसरी सुविधा में ले जाता है।
कार्रवाइयाँ:
- rename_screen: स्क्रीन का नाम बदलें। तुरंत लागू होता है, ऑफ़लाइन या जीवनकाल समाप्त हो चुकी स्क्रीन के लिए भी। deviceID, displayName आवश्यक हैं।
- configure_screen: स्क्रीन की हार्डवेयर सेटिंग्स बदलें। केवल वही सेटिंग्स बदलती हैं जो आप देते हैं। इन्हें डिवाइस पर भेजा जाता है और इससे उसका डिस्प्ले पुनः आरंभ हो सकता है। ऑफ़लाइन और जीवनकाल समाप्त हो चुकी स्क्रीन (status 409) का केवल नाम बदला जा सकता है। deviceID आवश्यक है। पुष्टि माँगता है।
- move: डिवाइस को दूसरी सुविधा में ले जाएँ। facilityId वह जगह है जहाँ डिवाइस अभी है; आपको लक्ष्य सुविधा की पहुँच भी चाहिए। एज प्रोसेसर को ले जाने पर उसके नेटवर्क कैमरे भी चले जाते हैं; अलग-अलग नेटवर्क कैमरे ले जाने के लिए cctv_edge_processors_write transfer_cameras का उपयोग करें। targetFacilityId, deviceType आवश्यक हैं। पुष्टि माँगता है।
पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
action* | "rename_screen" | "configure_screen" | "move" | क्या करना है; प्रत्येक क्रिया का वर्णन टूल विवरण में है। |
deviceID | string | स्क्रीन का deviceID (6-वर्ण का कोड) |
displayName | string | स्क्रीन का नया नाम (rename_screen, configure_screen) |
facilityId | string | सुविधा ID। जब कनेक्टेड सुविधा ही आपकी अभीष्ट सुविधा हो, तो वैकल्पिक। |
orientation | "normal" | "left" | "right" | "inverted" | स्क्रीन रोटेशन (configure_screen) |
resolution | "auto" | "1920x1080" | "1280x720" | "720x400" | आउटपुट रिज़ॉल्यूशन; auto वही उपयोग करता है जो डिस्प्ले बताता है (configure_screen) |
scheduledReboot | "disabled" | "daily" | "weekly" | "monthly" | स्क्रीन अपने आप कब रीबूट होती है (configure_screen) |
displayBrightness | integer | बैकलाइट ब्राइटनेस, 0-100 (configure_screen) |
airplayEnabled | boolean | स्क्रीन AirPlay स्वीकार करती है (configure_screen) |
airplayName | string | कस्टम AirPlay रिसीवर नाम; स्वचालित नाम के लिए खाली छोड़ें (configure_screen) |
airplayPin | string | 4-अंकों का AirPlay PIN; हटाने के लिए खाली छोड़ें (configure_screen) |
duressEnabled | boolean | Bluetooth duress बटन स्कैनर (configure_screen) |
sonosEnabled | boolean | Sonos स्पीकर नियंत्रण (configure_screen) |
wifiSupport | boolean | कैप्टिव Wi-Fi सेटअप पोर्टल (configure_screen) |
cameraRestreamingEnabled | boolean | स्क्रीन से स्थानीय कैमरा फ़ीड को फिर से स्ट्रीम करें (configure_screen) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (configure_screen) |
targetFacilityId | string | वह सुविधा जहाँ डिवाइस ले जाना है (move) |
deviceType | "screen" | "camera" | "duress" | "door-controller" | "ph-ai-agent" | "ai-edge-processor" | डिवाइस का प्रकार; यही तय करता है कि कौन-सा पहचानकर्ता देना है (move) |
deviceUuid | string | कैमरा, डोर कंट्रोलर, एआई एजेंट या एज प्रोसेसर का deviceUuid (move) |
deviceSerialNumber | string | Duress बटन का सीरियल नंबर (move) |
confirm | boolean | केवल तभी सेट करें जब उपयोगकर्ता ने पहली कॉल से लौटाए गए पूर्वावलोकन की पुष्टि कर दी हो |
device_send_commandडिवाइस प्रबंधनकिसी एक डिवाइस को, या किसी सुविधा के हर डिवाइस को लाइव कमांड भेजता है: रीबूट, डिस्प्ले चालू या बंद, ब्राउज़र पुनः आरंभ, संदेश दिखाना, पेज लोड करना, अपडेट इंस्टॉल करना या किसी PoE पोर्ट को पावर साइकल करना। ऑनलाइन डिवाइस कुछ ही सेकंड में कार्रवाई करते हैं; ऑफ़लाइन डिवाइसों तक कमांड कभी नहीं पहुँचती। हर कमांड पहले पुष्टि माँगती है।
किसी एक डिवाइस को uuid (device_inventory_read से उसका deviceUuid) से, या हर डिवाइस को broadcast: true से लक्षित करें। कई सुविधाओं पर चलाने के लिए facilityIds दें। स्क्रीन हर कमांड स्वीकार करती हैं; कैमरे rebootDevice और unlockUpdates स्वीकार करते हैं। नेटवर्क कैमरे (ep_ से शुरू होने वाला deviceUuid) कमांड प्राप्त नहीं कर सकते; उनके एज प्रोसेसर (edgeProcessorUUID) को लक्षित करें या उनके PoE पोर्ट को पावर साइकल करें।
किसी ऑफ़लाइन PoE कैमरे को वापस लाने के लिए, device_inventory_read में उसका metadata.networkStats (switchID, sw_port) पढ़ें, फिर सुविधा के किसी भी ऑनलाइन डिवाइस को arguments {switchID, switchPort} के साथ powerCyclePort भेजें। वह डिवाइस सुविधा के नेटवर्क कंट्रोलर से पोर्ट की पावर बंद करके फिर से चालू करने का अनुरोध करता है।
पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
facilityId | string | सुविधा ID। जब कनेक्टेड सुविधा ही आपकी अभीष्ट सुविधा हो, तो वैकल्पिक। |
facilityIds | array | कई सुविधा ID, ताकि हर एक पर वही अनुरोध चलाया जा सके। facilityId के स्थान पर उपयोग करें। |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | भेजी जाने वाली कमांड। duress बटन पहचाने न जाने पर restartBleScanner ब्रॉडकास्ट करें; बटन जोड़ने, स्थानांतरित करने या हटाने पर यह पहले से हो जाता है, और स्क्रीन हर ~10 मिनट में सूची फिर से लोड करती हैं। |
broadcast | boolean | किसी एक uuid के बजाय सुविधा के हर डिवाइस को भेजें |
uuid | string | device_inventory_read से deviceUuid; ब्रॉडकास्ट करते समय छोड़ दें |
arguments | objectstring | osd: संदेश का टेक्स्ट, जो वर्तमान सामग्री के ऊपर दिखाया जाता है। loadUrl: एक http(s) URL, जो अगले प्रोग्राम लोड या रीबूट तक दिखाया जाता है। powerCyclePort: {switchID, switchPort}। अन्य कमांड के लिए छोड़ दें। |
confirm | boolean | केवल तभी सेट करें जब उपयोगकर्ता ने पहली कॉल से लौटाए गए पूर्वावलोकन की पुष्टि कर दी हो |