شاشات العرض

Changes Display Screens settings shared by every facility in the facility's brand: the boot screen shown while screens start up, the settings new screens start with, and what templated content shows. Organisation admins only; read the current values and canEdit with display_settings_read boot_screen, screen_defaults or templated.

Actions:

• save_boot_screen: Save the boot screen. Sets the boot screen image (PNG, JPEG or WebP, up to 10 MB, from a public https imageUrl or imageBase64) and/or how it is laid out. Without an image, fit and background re-render the current one. Screens pick it up when they next start. Asks for confirmation.
• reset_boot_screen: Reset the boot screen. Removes the brand's boot screen; screens go back to the default one when they next start. Asks for confirmation.
• save_screen_defaults: Save the screen defaults. The settings a screen starts with when it is paired at one of the brand's facilities. Only the settings you pass change. Screens that are already paired keep their own settings; change those with device_inventory_write configure_screen. Asks for confirmation.
• save_templated: Save templated content settings. What templated content screens and the Schedule show: the data source name, workout names, programs in the Schedule and how far ahead, training phases and how far ahead, and Program Builder training camps (one banner per week) and how far ahead. Asks for confirmation.

تنشئ مجموعات Display Screens في منشأة وتعيد تسميتها وتحذفها، وتحدد الشاشات التي تضمها. المجموعات هي أهداف للنشر (display_publish targets.groupIds) وأهداف للأوامر (display_screen_command groupIds). عند تحديد عدة شاشات أو مجموعات أو أهداف، تنفّذ الأداة الإجراء عليها جميعًا في استدعاء واحد؛ لذا تحقّق مع المستخدم قبل تنفيذ إجراء على عدد كبير منها.

الإجراءات:

• save: حفظ مجموعة. الإنشاء: name (واختياريًا screenIds). إعادة التسمية: groupId (المعرّف أو الاسم الحالي) وname. يستبدل screenIds الأعضاء؛ والشاشات غير المدرجة تغادر هذه المجموعة لكنها تحتفظ بمجموعاتها الأخرى.
• delete: حذف مجموعة. يحذف مجموعة: تغادرها شاشاتها (مع احتفاظها بمجموعاتها الأخرى) ويُزال المحتوى المنشور إلى المجموعة من الجدول. يتطلب groupId. يطلب التأكيد.

تنشر تطبيقات HTML ثابتة ("التطبيقات المستضافة") لـ Display Screens. استدعِ display_library_read app_guidelines أولًا لمعرفة أحجام الشاشات وقواعد التصميم والحدود وSDK، ثم display_screenshot بعد ذلك للتحقق من النتيجة على شاشة. عند تحديد عدة شاشات أو مجموعات أو أهداف، تنفّذ الأداة الإجراء عليها جميعًا في استدعاء واحد؛ لذا تحقّق مع المستخدم قبل تنفيذ إجراء على عدد كبير منها.

الإجراءات:

• publish: نشر تطبيق مستضاف. ينشئ تطبيقًا مستضافًا (name + files) أو ينشر إصدارًا جديدًا (appId + files؛ ويصبح فعّالًا في كل مكان يُعرض فيه التطبيق، ويتراجع rollback عنه). يضعه publishTo على الشاشات أيضًا كما يفعل display_publish؛ ويتطلب الهدف من نوع brand أو organisation القيمة confirm. يتطلب files. قد يطلب التأكيد.
• rollback: التراجع عن إصدار تطبيق مستضاف. يجعل إصدارًا سابقًا هو الحالي مرة أخرى، في كل مكان يُعرض فيه التطبيق. اعرض الإصدارات باستخدام display_library_read app_versions. يتطلب appId وversion.

تقرأ مكتبة محتوى Display Screens المرئية لمنشأة: الوسائط (الصور ومقاطع الفيديو)، والتطبيقات (صفحات الويب وتطبيقات HTML المستضافة وتطبيقات وكيل الذكاء الاصطناعي وعروض الدوائر التلفزيونية المغلقة)، وقوائم التشغيل، إضافةً إلى تطبيقات وكيل الذكاء الاصطناعي ومصادر الدوائر التلفزيونية المغلقة التي يمكن إضافتها.

لكل عنصر contentRef (media#… أو app#… أو playlist#…) لاستخدامه مع display_publish وقوائم التشغيل. يبيّن ownerScope الجهة المالكة له (facility# أو brand# أو org#)؛ ولا يمكن نشر المحتوى إلا ضمن نطاق مالكه. الوسائط ذات الحالة processing ليست جاهزة بعد؛ والحالة failed تتطلب إعادة الرفع. لا يمكن تشغيل صفحات الويب ذات frameable: false في قوائم التشغيل، بل كشاشة بصفحة كاملة فقط. تتخطى الشاشات العناصر التي لها displayIssue: تطبيق وكيل ذكاء اصطناعي غير منشور أو متوقف مؤقتًا أو display-off أو محدود الجمهور أو بدون Custom Apps؛ أو عرض دوائر تلفزيونية مغلقة بالحالة no-cctv أو cctv-off (يفعّل مسؤول المنشأة الدوائر التلفزيونية المغلقة للشاشات في إعدادات Display Screens) أو no-cameras.

الإجراءات:

• list: عرض عناصر المكتبة. الوسائط والتطبيقات (مقسّمة إلى صفحات؛ مع التصفية حسب type أو kind أو tag أو name)، أو مع type agent-apps تطبيقات وكيل الذكاء الاصطناعي المسموح بها على الشاشات والتي يمكنك نشرها باستخدام display_publish content.agentAppId. لكل عنصر type: media أو app أو agent-app.
• cctv_sources: عرض مصادر الدوائر التلفزيونية المغلقة. كاميرات المنشأة وعروض Live View المشتركة لاستخدامها مع display_publish content.cctv، وما إذا كانت الدوائر التلفزيونية المغلقة مفعّلة على الشاشات. يتطلب صلاحية الوصول إلى الدوائر التلفزيونية المغلقة في المنشأة.
• get: الحصول على عنصر من المكتبة. عنصر وسائط أو تطبيق أو قائمة تشغيل واحدة حسب contentRef. يتطلب contentRef.
• usages: أماكن استخدام المحتوى. تعيينات الجدول الفعّالة وقوائم التشغيل التي تستخدم عنصر وسائط أو تطبيقًا (أو التعيينات الخاصة بقائمة تشغيل). لا يمكن حذف المحتوى قيد الاستخدام. يتطلب contentRef.
• app_versions: عرض إصدارات التطبيق المستضاف. إصدارات تطبيق مستضاف وأيها الحالي، لاستخدامها مع display_hosted_apps_write rollback. يتطلب appId.
• app_guidelines: إرشادات التطبيقات المستضافة. أحجام الشاشات وقواعد التصميم وحدود الحزمة وDisplay App SDK وقالب أولي. استدعِ هذا الإجراء قبل إنشاء تطبيق لـ display_hosted_apps_write publish.
• check_url: التحقق من صفحة ويب. ما إذا كان يمكن عرض صفحة ويب داخل قوائم التشغيل (بعض المواقع ترفض التضمين في إطار)، مع تلميحات حول مظهرها. يمكن عرض الصفحات التي ترفض التضمين كشاشة بصفحة كاملة. يتطلب url.
• playlists: عرض قوائم التشغيل. قوائم التشغيل المرئية للمنشأة (مقسّمة إلى صفحات)، ولكل منها عناصرها (contentRef وduration وfit).

تضيف محتوى مكتبة Display Screens وتغيّره: رفع الصور ومقاطع الفيديو، وإنشاء تطبيقات صفحات الويب وتطبيقات وكيل الذكاء الاصطناعي وتطبيقات عروض الدوائر التلفزيونية المغلقة، وتعديل الأسماء والعلامات والمدد والتواريخ، وحذف العناصر غير المستخدمة، وتحديث معاينة التطبيق. تُنشر تطبيقات HTML المستضافة باستخدام display_hosted_apps_write؛ وقوائم التشغيل باستخدام display_playlists_write.

صمّم الصور بدقة 1920×1080 (أفقي) أو 1080×1920 (عمودي). تبدأ الوسائط الجديدة بالحالة processing أثناء إعداد نسخ جاهزة للويب؛ ويمكن إضافتها إلى قوائم التشغيل فورًا وتُشغَّل حالما تصبح جاهزة. ownerScope: facility (الافتراضي) أو brand أو organisation (تتطلب القيمتان brand وorganisation صلاحية وصول على مستوى المنظمة).

الإجراءات:

• upload_media: رفع صورة أو فيديو. يضيف صورة أو فيديو من url عام عبر https (مفضّل؛ الصور حتى 25 MB، ومقاطع الفيديو حتى 200 MB) أو بترميز base64 مع mimeType (حتى 20 MB). الصور بتنسيقات JPEG وPNG وWebP وGIF؛ ومقاطع الفيديو بتنسيقات MP4 وWebM وMOV (تُحوَّل إلى H.264 MP4 حتى 1080p). لمقاطع الفيديو الأكبر: create_video_upload.
• create_video_upload: بدء رفع فيديو كبير. لمقاطع الفيديو حتى 2 GB: يسجّل الفيديو ويعيد رفعًا موقّعًا مسبقًا (أرسل الملف بطلب PUT إلى upload.url مع upload.headers قبل upload.expiresAt)، ثم استدعِ transcode مع contentRef الخاص به. يتطلب name وmimeType وbytes.
• transcode: معالجة فيديو. يحوّل فيديو ليناسب الشاشات: بعد create_video_upload، أو مرة أخرى بعد فشل، أو لفيديو قديم لا تستطيع الشاشات تشغيله. يتطلب contentRef.
• create_app: إضافة تطبيق. يضيف صفحة ويب (kind url، مع تمرير url؛ ويُتحقق من قابلية تضمينها في إطار)، أو تطبيق وكيل ذكاء اصطناعي (kind agent-app، مع تمرير agentAppId من display_library_read list type agent-apps)، أو عرض دوائر تلفزيونية مغلقة (kind cctv-view، مملوك للمنشأة، ويتطلب صلاحية الوصول إلى الدوائر التلفزيونية المغلقة). يتطلب kind وname.
• update: تحديث عنصر في المكتبة. يغيّر اسم عنصر وسائط أو تطبيق أو علاماته أو مدته؛ أو validFrom/validTo لعنصر وسائط (بتنسيق ISO، وnull يمسح القيمة؛ وخارج هذه الفترة يُتخطّى العنصر)؛ أو url لصفحة ويب؛ أو الكاميرات أو العرض أو التخطيط أو الجودة لعرض دوائر تلفزيونية مغلقة. يتطلب contentRef.
• delete: حذف عنصر من المكتبة. يحذف عنصر وسائط أو تطبيقًا. يُمنع الحذف ما دام العنصر في جدول فعّال أو قائمة تشغيل: يعرض الخطأ هذه الأماكن (أزلها أولًا باستخدام display_schedule_write delete أو display_playlists_write save). يتطلب contentRef. يطلب التأكيد.
• refresh_preview: تحديث معاينة التطبيق. يلتقط لقطة شاشة جديدة لتطبيق لمعاينته في المكتبة (مثلًا بعد تغيّر الصفحة). يتطلب contentRef.

تنشئ قوائم تشغيل Display Screens وتحدّثها وتحذفها: حلقات مرتبة من الوسائط والتطبيقات. تصل التغييرات إلى كل شاشة تعرض قائمة التشغيل خلال ثوانٍ. انشر قائمة تشغيل باستخدام display_publish content.contentRef "playlist#".

الإجراءات:

• save: حفظ قائمة تشغيل. الإنشاء: name + items (يمكن أن تكون items فارغة). التحديث: playlistId + أيٌّ من name أو items أو transition؛ تستبدل items القائمة بأكملها، لذا أرسل كل العناصر بالترتيب.
• delete: حذف قائمة تشغيل. يحذف قائمة تشغيل. يُمنع الحذف ما دامت منشورة في أي مكان: يعرض الخطأ التعيينات التي يجب إزالتها أولًا (display_schedule_write delete). يتطلب playlistId. يطلب التأكيد.

تضع المحتوى على Display Screens: عنصر وسائط أو قائمة تشغيل أو تطبيق أو صفحة ويب أو تطبيق وكيل ذكاء اصطناعي أو عرض مباشر للدوائر التلفزيونية المغلقة، على الشاشات أو المجموعات أو المنشأة أو علامتها التجارية أو منظمتها.

mode: يستبدل now (الافتراضي) ما تعرضه الأهداف عادةً؛ ويعرض scheduled المحتوى فقط في فترات أسبوعية (بالمنطقة الزمنية للمنشأة) و/أو بين from وto؛ ويقاطع takeover كل شيء لمدة durationMin (أو حتى وقت محدد)، ثم ينتهي تلقائيًا (أوقفه مبكرًا باستخدام display_takeover_stop). تحدد الشاشات ما تعرضه حسب الطبقة (takeover > scheduled > default)، ثم حسب مدى تحديد الهدف (screen > group > facility > brand > organisation).

الدوائر التلفزيونية المغلقة: بث الكاميرات المباشر مرئي لأي شخص بالقرب من الشاشات. يعيد الاستدعاء الأول requiresConfirmation (الرمز CCTV_CONFIRMATION_REQUIRED)؛ اسأل المستخدم، ثم استدعِ الأداة مرة أخرى مع confirmCctv: true. يجب أن يكون الخيار "Allow CCTV on display screens" مفعّلًا في المنشأة.

لا تعرض المحتوى المنشور إلا الشاشات في وضع المشغّل؛ وتُدرج الشاشات الأخرى في warnings. تعيد batchId؛ ويؤدي استخدامه مع display_schedule_write delete إلى التراجع عن عملية النشر بأكملها. عند تحديد عدة شاشات أو مجموعات أو أهداف، تنفّذ الأداة الإجراء عليها جميعًا في استدعاء واحد؛ لذا تحقّق مع المستخدم قبل تنفيذ إجراء على عدد كبير منها.

تقرأ ما هو منشور على Display Screens: لشاشة واحدة، ما تعرضه في وقت معيّن وخلال نطاق زمني (بعد حسمه عبر كل طبقة وهدف ترث منه) إضافةً إلى التعيينات التي تصل إليها؛ أو التعيينات المنشورة إلى مجموعة أو المنشأة أو علامتها التجارية أو منظمتها.

معرّفات التعيينات (as_…) ومعرّفات الدفعات (bt_…) هي ما يحدّثه display_schedule_write أو يحذفه. الأوقات بتنسيق ISO؛ والفترات بالمنطقة الزمنية للمنشأة.

الإجراءات:

• get: الحصول على جدول شاشة. ما تعرضه الشاشة في at (الافتراضي الآن)، وخطها الزمني من from إلى to (الافتراضي 24 ساعة)، وكل تعيين يصل إليها. يتطلب screenId.
• list_assignments: عرض التعيينات. التعيينات المنشورة إلى مجموعة (groupId)، أو إلى المنشأة أو علامتها التجارية أو منظمتها (target، والافتراضي facility). مقسّمة إلى صفحات، والأحدث تغييرًا أولًا.

تغيّر ما هو منشور على Display Screens: تعديل توقيت تعيين أو أولويته أو محتواه (اختياريًا عبر عملية النشر بأكملها)، أو إزالة تعيين واحد أو عملية نشر كاملة. اعثر على المعرّفات باستخدام display_schedule_read. تؤدي إزالة المحتوى من الجدول إلى إبقائه في المكتبة؛ ولإنهاء استحواذ (takeover) مبكرًا مع الاحتفاظ بسجله، استخدم display_takeover_stop.

الإجراءات:

• update: تحديث تعيين. يغيّر توقيت التعيين (الفترات الأسبوعية، from/to؛ وnull يمسح التاريخ) أو أولويته أو محتواه. يطبّق applyToBatch التغيير نفسه على كل أهداف عملية النشر. لا يمكن تغيير شيء في الاستحواذ (takeover) سوى وقت انتهائه. يتطلب محتوى الدوائر التلفزيونية المغلقة confirmCctv بعد موافقة المستخدم. يتطلب assignmentId.
• delete: الإزالة من الجدول. يزيل تعيينًا واحدًا (assignmentId) أو كل ما يخص عملية نشر واحدة (batchId). تعود الشاشات خلال ثوانٍ إلى ما كانت ستعرضه في غير ذلك. يطلب التأكيد.

ترسل أمرًا مباشرًا إلى Display Screens في منشأة: reload (تعيد شاشات المشغّل جلب جدولها)، أو identify (يومض اسم الشاشة ورمزها للعثور عليها في المكان)، أو displayOn/displayOff (لوحة التلفاز)، أو rebootDevice (يعيد تشغيل حاسوب الشاشة، مع شاشة فارغة لمدة 1–2 دقيقة؛ ويتطلب confirm: true)، أو osd (رسالة قصيرة على الشاشة؛ مرّر message).

اختر الشاشات باستخدام screenIds و/أو groupIds (كل شاشة في تلك المجموعات في المنشأة)، أو allScreens: true لكل شاشة في المنشأة (عندئذٍ يصل displayOn/displayOff إلى شاشات Templated content أيضًا). تعيد نتائج لكل شاشة. عند تحديد عدة شاشات أو مجموعات أو أهداف، تنفّذ الأداة الإجراء عليها جميعًا في استدعاء واحد؛ لذا تحقّق مع المستخدم قبل تنفيذ إجراء على عدد كبير منها.

تقرأ Display Screens في منشأة: عرضها مع حالتها وما يُعرض الآن وما يليه (مع التصفية حسب المجموعة أو الحالة أو وضع العرض)، أو الحصول على التفاصيل الكاملة لشاشة واحدة وخطها الزمني، أو عرض مجموعات الشاشات مع شاشاتها.

يظهر وضع العرض للمستخدمين باسم "Data Source": القيمة player هي "User managed content"، والقيمة program-builder هي "Templated content" (لا تستخدم أبدًا مع المستخدمين أي اسم آخر لهذا الوضع)، والقيمة url هي "Full-page website (Kiosk Mode)". الأوقات بتنسيق ISO؛ وتُعاد المنطقة الزمنية للمنشأة.

الإجراءات:

• list: عرض الشاشات. الشاشات في المنشأة (مقسّمة إلى صفحات)، ولكل منها الحالة وآخر نبضة اتصال والمجموعات والعلامات وما يُعرض الآن وما يليه. تعيد المجموعات أيضًا.
• get: الحصول على شاشة. التفاصيل الكاملة لشاشة واحدة (الحالة ونبضة الاتصال وإصدار المشغّل والأخطاء الأخيرة)، ولشاشات المشغّل ما تعرضه خلال نطاق زمني (الافتراضي الساعات الـ 24 التالية، والحد الأقصى 14 يومًا). يتطلب screenId.
• groups: عرض مجموعات الشاشات. مجموعات الشاشات في المنشأة (مقسّمة إلى صفحات)، ولكل منها شاشاتها.

تغيّر Display Screens: إقران شاشة جديدة برمز الإقران الخاص بها؛ أو إعادة تسمية شاشة، أو تعيين مجموعاتها وعلاماتها، أو تبديل وضع العرض الخاص بها (يظهر للمستخدمين باسم "Data Source")؛ أو تدوير الرمز المميز لشاشة مشغّل؛ أو إنشاء رابط معاينة محدود المدة لشاشة أو محتوى؛ أو إعادة ضبط شاشة إلى إعدادات المصنع (يزيلها من المنشأة).

أوضاع العرض: player ("User managed content")، وurl ("Full-page website (Kiosk Mode)"، مع تمرير url، عبر https فقط)، وprogram-builder ("Templated content"؛ لا تستخدم أبدًا مع المستخدمين أي اسم آخر لهذا الوضع). يؤدي تغيير الوضع إلى إعادة تحميل الشاشة فورًا وتغيير ما يراه الأعضاء، لذا يتطلب تأكيد المستخدم.

الإجراءات:

• update: تحديث شاشة. يضبط اسم الشاشة ومجموعاتها (المعرّفات أو الأسماء؛ تستبدل المجموعات الحالية) وعلاماتها (تستبدلها) و/أو وضع العرض. يعيد تغيير الوضع requiresConfirmation أولًا. يتطلب screenId. قد يطلب التأكيد.
• rotate_token: تدوير الرمز المميز للشاشة. يصدر رمزًا مميزًا جديدًا لشاشة مشغّل ويعيد تحميلها؛ ويتوقف الرمز القديم عن العمل. استخدمه عند احتمال تسرّب عنوان URL لمشغّل الشاشة. يتطلب screenId. يطلب التأكيد.
• create_preview_link: إنشاء رابط معاينة. رابط (صالح لمدة محدودة) يعرض ما تعرضه الشاشة أو مظهر المحتوى، اختياريًا في وقت مستقبلي. يمكن لأي شخص لديه الرابط عرضه حتى انتهاء صلاحيته.
• reset: إعادة ضبط شاشة إلى إعدادات المصنع. يزيل الشاشة من المنشأة ويعيد ضبطها إلى إعدادات المصنع؛ وتُعاد ضبط الشاشة المطفأة عندما تتصل بالإنترنت في المرة التالية، ثم تعرض صفحة الإقران الخاصة بها. مرّر confirmName: اسم الشاشة تمامًا كما كتبه المستخدم. يتطلب إدارة الجهاز. يتطلب screenId وconfirmName. يطلب التأكيد.
• pair: إقران شاشة جديدة. يضيف شاشة جديدة إلى المنشأة باستخدام الرمز المكوّن من 6 أحرف في صفحة الإقران الخاصة بها، ثم يعيد تحميلها. في المنشآت التي لديها Display Screens فقط تبدأ الشاشة على player؛ وإذا كان لديها Templated content أيضًا، يحدد mode ذلك (الافتراضي program-builder). يتطلب إدارة الجهاز. يتطلب pairingCode وname. يطلب التأكيد.

تلتقط ما تعرضه شاشة Display Screens الآن وتعيد الصورة، لتتمكن من التحقق من عملك بعد النشر (التخطيط وحجم النص وعدم وجود أجزاء مقطوعة أو تمرير). تنتظر حتى 15 ثانية لاستجابة الشاشة؛ وتنتهي مهلة الشاشات غير المتصلة. تعيد أيضًا عنوان URL في البوابة لصورة JPEG (للمستخدمين الذين سجّلوا الدخول فقط، ويُحتفظ به لمدة 10 دقائق).

قد تتضمن لقطات الشاشة بث الدوائر التلفزيونية المغلقة المباشر وأعضاء ظاهرين فيها؛ لا تشاركها خارج المحادثة.

Reads Display Screens settings for a facility: the fallback slate, polling and nightly reload, CCTV on screens; the screen power schedule (with the next days' on/off times); automations (brightness, bell volume, check-in power, round timer state); the brand's boot screen, screen defaults and templated content settings; and, with templated content, the scheduled program dates and the templated schedule.

Actions:

• settings: Get facility display settings. The fallback slate (message, background, logo, facility name), polling interval, nightly reload time and whether CCTV may be shown on screens.
• power_schedule: Get the power schedule. When screens turn on and off: the saved schedule (or the older automations' equivalent), the facility time zone and the on/off times for the next 7 days.
• power_schedule_preview: Preview a power schedule. The on/off times a schedule would give over the next 7 days, without saving it. Needs schedule.
• automations: Get display automations. Automatic brightness (day/night levels and triggers), bell volume levels and schedule (decimal hours, 6.5 = 06:30), check-in power, and the round timer state, for one or several facilities. usesGlobalDefaults is true until the facility saves its own.
• boot_screen: Get the brand's boot screen. The image the facility's brand shows while screens start up (fit, background, image URLs) and whether you can change it (organisation admins).
• screen_defaults: Get the brand's screen defaults. The settings a screen starts with when it is paired at one of the brand's facilities (orientation, screen mirroring, session timer, speaker control, duress monitoring, camera restreaming, Wi-Fi support) and whether you can change them (organisation admins). Screens that are already paired keep their own settings; see device_inventory_read for those.
• templated: Get the brand's templated content settings. What templated content screens and the Schedule show for the facility's brand (source name, workout names, programs and training phases, look-ahead days) and whether you can change it (organisation admins).
• program_dates: List scheduled program dates. The dates with a workout program, from the start of this month to the brand's look-ahead. Needs templated content (Program Builder) at the facility.
• templated_schedule: Get the templated schedule. Programs and training phases between two dates (YYYY-MM-DD, at most 62 days), as the brand shows them. Needs templated content (Program Builder) at the facility. Needs from, to.

تغيّر إعدادات Display Screens لمنشأة: Fallback Slate، والاستطلاع وإعادة التحميل الليلية، و"Allow CCTV on display screens"؛ وجدول تشغيل الشاشات؛ والأتمتة (السطوع، ومستوى صوت الجرس، والتشغيل عند تسجيل الحضور). تحتفظ الحقول التي لا تحددها بقيمها الحالية. الإعدادات على مستوى العلامة التجارية (شاشة الإقلاع وTemplated content) موجودة في display_brand_settings_write.

الإجراءات:

• save_settings: حفظ إعدادات العرض للمنشأة. Fallback Slate الذي يظهر عند عدم وجود أي محتوى مجدول، والفاصل الزمني للاستطلاع (30–300 s)، ووقت إعادة التحميل الليلية (HH:mm)، وallowCctv. يتطلب تفعيل allowCctv تأكيد المستخدم ومسؤول منشأة لديه صلاحية الوصول إلى الدوائر التلفزيونية المغلقة. قد يطلب التأكيد.
• save_power_schedule: حفظ جدول التشغيل. يغيّر أوقات تشغيل الشاشات وإطفائها؛ وتُدمج الحقول التي تمرّرها في الجدول المحفوظ. يعيد أوقات التشغيل والإيقاف للأيام السبعة التالية. تحقّق أولًا باستخدام display_settings_read power_schedule_preview. يتطلب schedule.
• save_automations: حفظ أتمتة العرض. يغيّر إعدادات السطوع التلقائي ومستوى صوت الجرس والتشغيل عند تسجيل الحضور. تحتفظ المنشأة بعد ذلك بإعداداتها الخاصة بدلًا من الإعدادات الافتراضية العامة.

تنهي فورًا عمليات الاستحواذ (takeover) الجارية على Display Screens: لعملية نشر واحدة (batchId من display_publish)، أو لأهداف محددة (الافتراضي: عمليات الاستحواذ المنشورة إلى المنشأة بأكملها)، أو باستخدام allScreens لكل عملية استحواذ منشورة إلى المنشأة أو شاشاتها أو مجموعاتها. لا تتوقف عمليات الاستحواذ على مستوى العلامة التجارية والمنظمة إلا باستخدام batchId. تعود الشاشات إلى محتواها المجدول أو الافتراضي خلال ثوانٍ؛ وتعيد الأداة عدد العمليات التي توقفت. عند تحديد عدة شاشات أو مجموعات أو أهداف، تنفّذ الأداة الإجراء عليها جميعًا في استدعاء واحد؛ لذا تحقّق مع المستخدم قبل تنفيذ إجراء على عدد كبير منها.

تتحكم في شاشات Templated content (وضع العرض "Templated content" في display_screens_read): تحميل برنامج تمارين يوم معيّن عليها، أو التحكم في مؤقت الجولات. لا تتأثر أبدًا شاشات User managed content وشاشات مواقع الويب بصفحة كاملة.

الإجراءات:

• load_program: تحميل برنامج تمارين. يحمّل برنامج تمارين تاريخ معيّن (YYYY-MM-DD، والافتراضي اليوم) من مصدر بيانات المنشأة على كل شاشة Templated content في منشأة واحدة أو عدة منشآت؛ وتعيد الشاشات التحميل خلال ثوانٍ. استخدمه لعرض تمرين اليوم أو يوم آخر، أو عندما تعرض الشاشات تمرينًا خاطئًا. تتطلب المنشآت المتعددة confirm. قد يطلب التأكيد.
• clock: التحكم في مؤقت الجولات. يشغّل مؤقت الجولات على شاشات Templated content أو يوقفه مؤقتًا أو يعيد تشغيله أو يوقفه، ويكتم أصوات الجولات أو يلغي كتمها، ويضبط مستوى صوت الجرس (setvolume مع volume بين 0–100) أو يطلب حالته. يتطلب Templated content في المنشأة. يتطلب command.