ניהול מכשירים
פלטפורמת הליבהdevice_health_readניהול מכשיריםמשווה את בדיקת מהירות האינטרנט האחרונה של מתקן עם מה שהמכשירים שלו צריכים. network מחזיר את מהירות ההורדה וההעלאה ב-Mbps, ועבור מסכים, מצלמות (הקלטה וגם שידור חי) ומערכות רמקולים מחוברות שנראו ב-24 השעות האחרונות: מספר המכשירים, רוחב הפס שכל אחד מהם צריך והאם החיבור מספיק. השתמשו בו כדי לאבחן מכשירים איטיים או מתנתקים, או לפני הוספת מכשירים. העבירו facilityIds כדי לבדוק כמה מתקנים.
פעולות:
- network: בדיקת רוחב הפס של הרשת.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "network" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
facilityIds | array | כמה מזהי מתקנים, כדי להריץ את אותה בקשה בכל אחד מהם. השתמשו בזה במקום facilityId. |
device_inventory_readניהול מכשיריםכל מכשיר שרשום למתקן: מסכי תצוגה, מצלמות ענן, מצלמות רשת, מכשירי Edge Processor, לחצני Duress, בקרי דלתות, סוכני בינה מלאכותית וחיישני IoT. השתמשו בו כדי לפתור בעיות, לבקר ציוד או למצוא מזהה של מכשיר.
לכל מכשיר יש סוג, דגם, מזהים (deviceUuid; deviceID עבור מסכים; deviceSerialNumber עבור לחצני Duress), מיקום, פרטי רשת (IP, Wi-Fi או Ethernet, SSID, ערוץ, רשתות סמוכות; ב-metadata.networkStats נמצאת יציאת מתג ה-PoE), תקינות (טמפרטורת CPU, זיכרון, זמן פעולה רציף) ו-metadata.updated, פעימת החיים האחרונה ב-Unix ms. לא מקוון פירושו שאין פעימת חיים במשך 5 דקות; מכשיר שאינו מקוון יותר מ-7 ימים ויש לו תאום מקוון (אותו ציוד, שם או מיקום) ככל הנראה הוחלף. שורות networkCamera הן זרמים שנמשכים על ידי ה-Edge Processor שב-edgeProcessorUUID; ה-deviceUuid שלהן (שמתחיל ב-ep_) אינו יכול לקבל פקודות. פרטי הגישה בכתובות URL של זרמים מוצגים כ-: אלא אם includeCredentials מוגדר. המליצו על Ethernet קווי על פני Wi-Fi.
קשור: cctv_cameras_read ו-cctv_cameras_write (מצלמות), cctv_edge_processors_write (מכשירי Edge Processor), device_inventory_write (שינוי שם, הגדרה, העברה), device_send_command (שליטה), device_health_read (רוחב פס).
פעולות:
- list: רשימת מכשירים. המכשירים במתקן, מסוננים לפי סוג או שם. עם facilityIds, כל מתקן מחזיר את העמוד הראשון שלו.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "list" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
facilityIds | array | כמה מזהי מתקנים, כדי להריץ את אותה בקשה בכל אחד מהם. השתמשו בזה במקום facilityId. |
deviceType | string | רק הסוג הזה, כמו ב-deviceType: screen, camera, networkCamera, duress וכן הלאה |
query | string | השם, החדר, deviceID, deviceUuid או המספר הסידורי מכילים את הערך הזה |
includeCredentials | boolean | החזרת כתובות URL של זרמים עם שם המשתמש והסיסמה שלהן. כבוי כברירת מחדל (פרטי הגישה מוצגים כ-***:***). הגדירו זאת רק כשהמשתמש זקוק במפורש לפרטי הגישה; נדרשת גישת CCTV במתקן. |
limit | integer | פריטים בעמוד (ברירת מחדל 25, לכל היותר 100) |
cursor | string | nextCursor מהעמוד הקודם |
device_inventory_writeניהול מכשיריםמשנה מכשיר שרשום למתקן. rename_screen ו-configure_screen משנים מסך תצוגה (זהו אותו לפי deviceID מ-device_inventory_read); עבור קבוצות, תגים או מצב תצוגה של מסך השתמשו במקום זאת בכלי התצוגה. move מעביר מסך, מצלמת ענן, לחצן Duress, בקר דלת, סוכן בינה מלאכותית או Edge Processor למתקן אחר באותו ארגון.
פעולות:
- rename_screen: שינוי שם של מסך. חל מיד, גם על מסכים לא מקוונים או מסכים שהגיעו לסוף חייהם. דורש deviceID, displayName.
- configure_screen: שינוי הגדרות החומרה של מסך. רק ההגדרות שאתם מעבירים משתנות. הן נשלחות למכשיר ועשויות להפעיל מחדש את התצוגה שלו. מסכים לא מקוונים ומסכים שהגיעו לסוף חייהם (סטטוס 409) ניתנים לשינוי שם בלבד. דורש deviceID. מבקש אישור.
- move: העברת מכשיר למתקן אחר. facilityId הוא המקום שבו המכשיר נמצא כעת; נדרשת לכם גישה גם למתקן היעד. העברת Edge Processor מעבירה את מצלמות הרשת שלו; כדי להעביר מצלמות רשת בודדות השתמשו ב-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 | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
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 | קוד PIN של AirPlay בן 4 ספרות; ריק כדי להסיר (configure_screen) |
duressEnabled | boolean | סורק Bluetooth ללחצני Duress (configure_screen) |
sonosEnabled | boolean | שליטה ברמקולי Sonos (configure_screen) |
wifiSupport | boolean | פורטל הגדרת Wi-Fi מסוג captive (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 של מצלמה, בקר דלת, סוכן בינה מלאכותית או Edge Processor (move) |
deviceSerialNumber | string | המספר הסידורי של לחצן ה-Duress (move) |
confirm | boolean | הגדירו רק לאחר שהמשתמש אישר את התצוגה המקדימה שהוחזרה בקריאה הראשונה |
device_send_commandניהול מכשיריםשולח פקודה בזמן אמת למכשיר אחד, או לכל המכשירים במתקן: אתחול, הפעלה או כיבוי של התצוגה, הפעלה מחדש של הדפדפן, הצגת הודעה, טעינת דף, התקנת עדכונים או ניתוק וחיבור מחדש של חשמל ביציאת PoE. מכשירים מקוונים מגיבים תוך שניות; מכשירים לא מקוונים לעולם אינם מקבלים אותה. כל פקודה מבקשת אישור תחילה.
כוונו למכשיר אחד באמצעות uuid (ה-deviceUuid שלו מ-device_inventory_read), או לכל המכשירים באמצעות broadcast: true. העבירו facilityIds כדי להריץ בכמה מתקנים. מסכים מקבלים כל פקודה; מצלמות מקבלות rebootDevice ו-unlockUpdates. מצלמות רשת (deviceUuid שמתחיל ב-ep_) אינן יכולות לקבל פקודות; כוונו ל-Edge Processor שלהן (edgeProcessorUUID) או נתקו וחברו מחדש את החשמל ביציאת ה-PoE שלהן.
כדי להחזיר לפעולה מצלמת PoE לא מקוונת, קראו את metadata.networkStats שלה (switchID, sw_port) ב-device_inventory_read, ולאחר מכן שלחו powerCyclePort לכל מכשיר מקוון במתקן עם הארגומנטים {switchID, switchPort}. המכשיר הזה מבקש מבקר הרשת של המתקן לנתק ולהחזיר את החשמל ביציאה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
facilityIds | array | כמה מזהי מתקנים, כדי להריץ את אותה בקשה בכל אחד מהם. השתמשו בזה במקום facilityId. |
command* | "displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort" | הפקודה לשליחה. שלחו restartBleScanner לכל המכשירים כשלחצני Duress אינם מזוהים; הוספה, העברה או הסרה של לחצן כבר עושות זאת, והמסכים טוענים מחדש את הרשימה בערך כל 10 דקות. |
broadcast | boolean | שליחה לכל המכשירים במתקן במקום ל-uuid אחד |
uuid | string | ה-deviceUuid מ-device_inventory_read; השמיטו בשליחה לכל המכשירים |
arguments | objectstring | osd: טקסט ההודעה, שמוצג מעל התוכן הנוכחי. loadUrl: כתובת URL מסוג http(s), שמוצגת עד הטעינה הבאה של תוכנית או עד האתחול הבא. powerCyclePort: {switchID, switchPort}. השמיטו עבור פקודות אחרות. |
confirm | boolean | הגדירו רק לאחר שהמשתמש אישר את התצוגה המקדימה שהוחזרה בקריאה הראשונה |