إدارة الجهاز
المنصة الأساسيةdevice_health_readإدارة الجهازيقارن أحدث اختبار لسرعة الإنترنت في منشأة بما تحتاج إليه أجهزتها. يعيد network سرعة التنزيل والرفع بوحدة Mbps، وبالنسبة إلى الشاشات والكاميرات (التسجيل مع البث المباشر) وأنظمة السماعات المتصلة التي رُصدت خلال آخر 24 ساعة: عدد الأجهزة، وعرض النطاق الترددي الذي يحتاج إليه كل منها، وهل الاتصال كافٍ. استخدمه لتشخيص الأجهزة البطيئة أو التي ينقطع اتصالها، أو قبل إضافة أجهزة. مرّر facilityIds للتحقق من عدة منشآت.
الإجراءات:
- network: التحقق من عرض النطاق الترددي للشبكة.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
action* | "network" | الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة. |
facilityId | string | معرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة. |
facilityIds | array | عدة معرّفات منشآت لتنفيذ الطلب نفسه في كل منها. استخدمه بدلًا من facilityId. |
device_inventory_readإدارة الجهازكل جهاز مسجّل في منشأة: شاشات العرض، والكاميرات السحابية، والكاميرات الشبكية، ومعالجات الحافة بالذكاء الاصطناعي، وأزرار الاستغاثة، ووحدات التحكم بالأبواب، ووكلاء الذكاء الاصطناعي، وأجهزة استشعار IoT. استخدمه لاستكشاف الأخطاء وإصلاحها، أو لتدقيق المعدات، أو للعثور على معرّف جهاز.
لكل جهاز نوعه، وطرازه، ومعرّفاته (deviceUuid؛ وdeviceID للشاشات؛ وdeviceSerialNumber لأزرار الاستغاثة)، وموقعه، وتفاصيل الشبكة (IP، وWi-Fi أو ethernet، وSSID، والقناة، والشبكات القريبة؛ ويحتوي metadata.networkStats على منفذ محوّل PoE)، والحالة الصحية (درجة حرارة وحدة المعالجة المركزية، والذاكرة، ومدة التشغيل)، وmetadata.updated، وهي آخر نبضة بمللي ثانية Unix. يعني Offline عدم وجود نبضة لمدة 5 دقائق؛ والجهاز غير المتصل لأكثر من 7 أيام وله نظير متصل (المعدات نفسها أو الاسم نفسه أو الموقع نفسه) استُبدل على الأرجح. صفوف networkCamera هي عمليات بث يسحبها Edge Processor المحدد في edgeProcessorUUID؛ ولا يمكن لقيمة deviceUuid الخاصة بها (التي تبدأ بـ ep_) استقبال الأوامر. تظهر بيانات اعتماد عناوين URL للبث بصيغة : ما لم يُضبط includeCredentials. أوصِ باستخدام ethernet السلكي بدلًا من Wi-Fi.
ذو صلة: 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 | معرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة. |
facilityIds | array | عدة معرّفات منشآت لتنفيذ الطلب نفسه في كل منها. استخدمه بدلًا من 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 شاشة عرض (حدّدها باستخدام deviceID من device_inventory_read)؛ أما مجموعات الشاشة أو وسومها أو وضع العرض فاستخدم لها أدوات العرض بدلًا من ذلك. ينقل move شاشة، أو كاميرا سحابية، أو زر استغاثة، أو وحدة تحكم باب، أو وكيل ذكاء اصطناعي، أو معالج حافة بالذكاء الاصطناعي إلى منشأة أخرى في المنظمة نفسها.
الإجراءات:
- rename_screen: إعادة تسمية شاشة. يُطبَّق فورًا، حتى على الشاشات غير المتصلة أو المنتهية الدعم. يتطلب deviceID وdisplayName.
- configure_screen: تغيير إعدادات عتاد الشاشة. تتغير الإعدادات التي تمررها فقط. تُدفع إلى الجهاز وقد تعيد تشغيل العرض. لا يمكن إلا إعادة تسمية الشاشات غير المتصلة والمنتهية الدعم (الحالة 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 | معرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة. |
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 (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 للكاميرا أو وحدة تحكم الباب أو وكيل الذكاء الاصطناعي أو Edge Processor (move) |
deviceSerialNumber | string | الرقم التسلسلي لزر الاستغاثة (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 عندما لا تُكتشف أزرار الاستغاثة؛ علمًا بأن إضافة زر أو نقله أو إزالته تفعل ذلك بالفعل، وتعيد الشاشات تحميل القائمة كل 10 دقائق تقريبًا. |
broadcast | boolean | الإرسال إلى كل جهاز في المنشأة بدلًا من uuid واحد |
uuid | string | قيمة deviceUuid من device_inventory_read؛ اتركها عند البث |
arguments | objectstring | osd: نص الرسالة، ويظهر فوق المحتوى الحالي. loadUrl: عنوان URL بصيغة http(s)، ويظهر حتى تحميل البرنامج التالي أو إعادة التشغيل. powerCyclePort: {switchID, switchPort}. اتركه للأوامر الأخرى. |
confirm | boolean | اضبطه فقط بعد أن يؤكد المستخدم المعاينة التي أعادها الاستدعاء الأول |