إدارة الجهاز

المنصة الأساسية
device_health_readإدارة الجهاز

يقارن أحدث اختبار لسرعة الإنترنت في منشأة بما تحتاج إليه أجهزتها. يعيد network سرعة التنزيل والرفع بوحدة Mbps، وبالنسبة إلى الشاشات والكاميرات (التسجيل مع البث المباشر) وأنظمة السماعات المتصلة التي رُصدت خلال آخر 24 ساعة: عدد الأجهزة، وعرض النطاق الترددي الذي يحتاج إليه كل منها، وهل الاتصال كافٍ. استخدمه لتشخيص الأجهزة البطيئة أو التي ينقطع اتصالها، أو قبل إضافة أجهزة. مرّر facilityIds للتحقق من عدة منشآت.

الإجراءات:

  • network: التحقق من عرض النطاق الترددي للشبكة.

المعلمات

الاسمالنوعالوصف
action*"network"الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة.
facilityIdstringمعرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.
facilityIdsarrayعدة معرّفات منشآت لتنفيذ الطلب نفسه في كل منها. استخدمه بدلًا من 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"الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة.
facilityIdstringمعرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.
facilityIdsarrayعدة معرّفات منشآت لتنفيذ الطلب نفسه في كل منها. استخدمه بدلًا من facilityId.
deviceTypestringهذا النوع فقط، كما في deviceType: screen، وcamera، وnetworkCamera، وduress، وغيرها
querystringالاسم أو الغرفة أو deviceID أو deviceUuid أو الرقم التسلسلي يحتوي على هذا
includeCredentialsbooleanإعادة عناوين URL للبث مع اسم المستخدم وكلمة المرور. متوقف افتراضيًا (تظهر بيانات الاعتماد بصيغة ***:***). لا تضبطه إلا عندما يحتاج المستخدم إلى بيانات الاعتماد صراحةً؛ ويتطلب وصولًا إلى الدوائر التلفزيونية المغلقة في المنشأة.
limitintegerعدد العناصر في الصفحة (الافتراضي 25، والحد الأقصى 100)
cursorstringnextCursor من الصفحة السابقة
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"الإجراء المطلوب؛ كل إجراء موصوف في وصف الأداة.
deviceIDstringdeviceID للشاشة (رمز من 6 أحرف)
displayNamestringاسم الشاشة الجديد (rename_screen, configure_screen)
facilityIdstringمعرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.
orientation"normal" | "left" | "right" | "inverted"تدوير الشاشة (configure_screen)
resolution"auto" | "1920x1080" | "1280x720" | "720x400"دقة الإخراج؛ تستخدم auto ما تُبلغ عنه الشاشة (configure_screen)
scheduledReboot"disabled" | "daily" | "weekly" | "monthly"موعد إعادة تشغيل الشاشة لنفسها (configure_screen)
displayBrightnessintegerسطوع الإضاءة الخلفية، من 0 إلى 100 (configure_screen)
airplayEnabledbooleanتقبل الشاشة AirPlay (configure_screen)
airplayNamestringاسم مخصص لجهاز استقبال AirPlay؛ اتركه فارغًا للاسم التلقائي (configure_screen)
airplayPinstringرمز PIN لـ AirPlay من 4 أرقام؛ اتركه فارغًا لإزالته (configure_screen)
duressEnabledbooleanماسح أزرار الاستغاثة عبر Bluetooth (configure_screen)
sonosEnabledbooleanالتحكم في سماعات Sonos (configure_screen)
wifiSupportbooleanبوابة إعداد Wi-Fi المقيّدة (configure_screen)
cameraRestreamingEnabledbooleanإعادة بث موجزات الكاميرات المحلية من الشاشة (configure_screen)
sessionTimerEnabledbooleanSynchronised session timer (master clock) and its bells (configure_screen)
targetFacilityIdstringالمنشأة المراد نقل الجهاز إليها (move)
deviceType"screen" | "camera" | "duress" | "door-controller" | "ph-ai-agent" | "ai-edge-processor"نوع الجهاز؛ يحدد المعرّف الذي يجب تمريره (move)
deviceUuidstringdeviceUuid للكاميرا أو وحدة تحكم الباب أو وكيل الذكاء الاصطناعي أو Edge Processor (move)
deviceSerialNumberstringالرقم التسلسلي لزر الاستغاثة (move)
confirmbooleanاضبطه فقط بعد أن يؤكد المستخدم المعاينة التي أعادها الاستدعاء الأول
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}. يطلب ذلك الجهاز من وحدة التحكم بالشبكة في المنشأة قطع طاقة المنفذ وإعادتها.

المعلمات

الاسمالنوعالوصف
facilityIdstringمعرّف المنشأة. اختياري إذا كانت المنشأة المتصلة هي المقصودة.
facilityIdsarrayعدة معرّفات منشآت لتنفيذ الطلب نفسه في كل منها. استخدمه بدلًا من facilityId.
command*"displayOff" | "displayOn" | "unlockUpdates" | "rebootDevice" | "restartBrowser" | "gpuDebugOn" | "gpuDebugOff" | "restartBleScanner" | "osd" | "loadUrl" | "powerCyclePort"الأمر المراد إرساله. بُثَّ restartBleScanner عندما لا تُكتشف أزرار الاستغاثة؛ علمًا بأن إضافة زر أو نقله أو إزالته تفعل ذلك بالفعل، وتعيد الشاشات تحميل القائمة كل 10 دقائق تقريبًا.
broadcastbooleanالإرسال إلى كل جهاز في المنشأة بدلًا من uuid واحد
uuidstringقيمة deviceUuid من device_inventory_read؛ اتركها عند البث
argumentsobjectstringosd: نص الرسالة، ويظهر فوق المحتوى الحالي. loadUrl: عنوان URL بصيغة http(s)، ويظهر حتى تحميل البرنامج التالي أو إعادة التشغيل. powerCyclePort: {switchID, switchPort}. اتركه للأوامر الأخرى.
confirmbooleanاضبطه فقط بعد أن يؤكد المستخدم المعاينة التي أعادها الاستدعاء الأول