หน้าจอแสดงผล

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 Screen ที่สถานที่ และกำหนดว่าหน้าจอใดอยู่ในกลุ่ม กลุ่มเป็นเป้าหมายการเผยแพร่ (display_publish targets.groupIds) และเป้าหมายคำสั่ง (display_screen_command groupIds) เมื่อระบุหลายหน้าจอ หลายกลุ่ม หรือหลายเป้าหมาย เครื่องมือนี้จะดำเนินการกับทั้งหมดในการเรียกครั้งเดียว โปรดสอบถามผู้ใช้ก่อนดำเนินการกับรายการจำนวนมาก

การดำเนินการ:

• save: บันทึกกลุ่ม สร้าง: name (และ screenIds หากต้องการ) เปลี่ยนชื่อ: groupId (ID หรือชื่อปัจจุบัน) และ name โดย screenIds จะแทนที่สมาชิกเดิม หน้าจอที่ไม่อยู่ในรายการจะออกจากกลุ่มนี้แต่ยังคงอยู่ในกลุ่มอื่น ๆ
• delete: ลบกลุ่ม ลบกลุ่มหนึ่ง หน้าจอในกลุ่มจะออกจากกลุ่ม (แต่ยังคงอยู่ในกลุ่มอื่น ๆ) และเนื้อหาที่เผยแพร่ไปยังกลุ่มจะถูกนำออกจากกำหนดการ ต้องระบุ groupId จะขอการยืนยัน

เผยแพร่แอป HTML แบบสแตติก ("แอปที่โฮสต์") สำหรับ Display Screens เรียก display_library_read app_guidelines ก่อนเพื่อดูขนาดหน้าจอ กฎการออกแบบ ข้อจำกัด และ SDK แล้วเรียก display_screenshot หลังจากนั้นเพื่อตรวจสอบผลลัพธ์บนหน้าจอ เมื่อระบุหลายหน้าจอ หลายกลุ่ม หรือหลายเป้าหมาย เครื่องมือนี้จะดำเนินการกับทั้งหมดในการเรียกครั้งเดียว โปรดสอบถามผู้ใช้ก่อนดำเนินการกับรายการจำนวนมาก

การดำเนินการ:

• publish: เผยแพร่แอปที่โฮสต์ สร้างแอปที่โฮสต์ (name + files) หรือเผยแพร่เวอร์ชันใหม่ (appId + files โดยเวอร์ชันใหม่จะเริ่มใช้งานทุกที่ที่แสดงแอปนี้ และ rollback จะยกเลิกได้) publishTo จะนำแอปขึ้นหน้าจอด้วย เช่นเดียวกับ display_publish หากเป้าหมายเป็นแบรนด์หรือองค์กรต้องใช้ confirm ต้องระบุ files อาจขอการยืนยัน
• rollback: ย้อนกลับแอปที่โฮสต์ ทำให้เวอร์ชันก่อนหน้ากลับมาเป็นเวอร์ชันปัจจุบันอีกครั้งในทุกที่ที่แสดงแอปนี้ ดูรายการเวอร์ชันได้ด้วย display_library_read app_versions ต้องระบุ appId, version

อ่านคลังเนื้อหาของ Display Screens ที่สถานที่มองเห็นได้ ได้แก่ สื่อ (รูปภาพ วิดีโอ) แอป (หน้าเว็บ แอป HTML ที่โฮสต์ แอป AI Agent มุมมองกล้องวงจรปิด) และเพลย์ลิสต์ รวมถึงแอป AI Agent และแหล่งกล้องวงจรปิดที่เพิ่มได้

แต่ละรายการมี contentRef (media#…, app#…, playlist#…) สำหรับ display_publish และเพลย์ลิสต์ ownerScope แสดงผู้เป็นเจ้าของ (facility#, brand# หรือ org#) และเนื้อหาจะเผยแพร่ได้เฉพาะภายในขอบเขตของเจ้าของเท่านั้น สื่อที่มีสถานะ processing ยังไม่พร้อมใช้งาน ส่วน failed ต้องอัปโหลดใหม่ หน้าเว็บที่มี frameable: false จะเล่นในเพลย์ลิสต์ไม่ได้ แสดงได้เฉพาะเป็นหน้าจอแบบเต็มหน้าเท่านั้น หน้าจอจะข้ามรายการที่มี displayIssue ได้แก่ แอป AI Agent ที่ยังไม่เผยแพร่ หยุดชั่วคราว ปิดการแสดงผล จำกัดผู้ชม หรือไม่มี Custom Apps และมุมมองกล้องวงจรปิดที่เป็น no-cctv, cctv-off (ผู้ดูแลสถานที่เปิดกล้องวงจรปิดสำหรับหน้าจอได้ในการตั้งค่า Display Screens) หรือ no-cameras

การดำเนินการ:

• list: แสดงรายการในคลัง สื่อและแอป (แบ่งหน้า กรองตาม type, kind, tag หรือ name) หรือเมื่อใช้ type agent-apps จะแสดงแอป AI Agent ที่อนุญาตบนหน้าจอซึ่งคุณเผยแพร่ได้ด้วย display_publish content.agentAppId แต่ละรายการมี type ได้แก่ media, app หรือ agent-app
• cctv_sources: แสดงรายการแหล่งกล้องวงจรปิด กล้องของสถานที่และ Live Views ที่แชร์สำหรับ 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 ได้แก่ อัปโหลดรูปภาพและวิดีโอ สร้างแอปหน้าเว็บ แอป AI Agent และแอปมุมมองกล้องวงจรปิด แก้ไขชื่อ แท็ก ระยะเวลา และวันที่ ลบรายการที่ไม่ได้ใช้งาน และรีเฟรชตัวอย่างของแอป แอป 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: บันทึกวิดีโอและส่งคืนการอัปโหลดแบบ presigned (PUT ไฟล์ไปยัง upload.url พร้อม upload.headers ก่อน upload.expiresAt) จากนั้นเรียก transcode ด้วย contentRef ของวิดีโอนั้น ต้องระบุ name, mimeType, bytes
• transcode: ประมวลผลวิดีโอ แปลงวิดีโอสำหรับหน้าจอ: หลัง create_video_upload เมื่อลองใหม่หลังจากล้มเหลว หรือสำหรับวิดีโอเก่าที่หน้าจอเล่นไม่ได้ ต้องระบุ contentRef
• create_app: เพิ่มแอป เพิ่มหน้าเว็บ (kind url ระบุ url และจะตรวจสอบการแสดงในเฟรม) แอป AI Agent (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 ได้แก่ สื่อ เพลย์ลิสต์ แอป หน้าเว็บ แอป AI Agent หรือภาพสดจากกล้องวงจรปิด ไปยังหน้าจอ กลุ่ม สถานที่ แบรนด์ หรือองค์กรของสถานที่

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" ไว้

เฉพาะหน้าจอในโหมด player เท่านั้นที่แสดงเนื้อหาที่เผยแพร่ หน้าจออื่นจะแสดงอยู่ใน warnings ส่งคืน batchId ซึ่งใช้กับ display_schedule_write delete เพื่อยกเลิกการเผยแพร่ทั้งหมดได้ เมื่อระบุหลายหน้าจอ หลายกลุ่ม หรือหลายเป้าหมาย เครื่องมือนี้จะดำเนินการกับทั้งหมดในการเรียกครั้งเดียว โปรดสอบถามผู้ใช้ก่อนดำเนินการกับรายการจำนวนมาก

อ่านสิ่งที่เผยแพร่ไปยัง Display Screens: สำหรับหน้าจอหนึ่ง คือสิ่งที่แสดง ณ เวลาหนึ่งและตลอดช่วงเวลา (ตัดสินจากทุกชั้นและทุกเป้าหมายที่หน้าจอสืบทอดมา) พร้อมการกำหนดที่ไปถึงหน้าจอนั้น หรือการกำหนดที่เผยแพร่ไปยังกลุ่ม สถานที่ แบรนด์ หรือองค์กรของสถานที่

ID ของการกำหนด (as_…) และ ID ของชุด (bt_…) คือสิ่งที่ display_schedule_write ใช้อัปเดตหรือลบ เวลาเป็นแบบ ISO และช่วงเวลาอิงตามเขตเวลาของสถานที่

การดำเนินการ:

• get: ดูกำหนดการของหน้าจอ สิ่งที่หน้าจอแสดง ณ at (ค่าเริ่มต้นคือตอนนี้) ไทม์ไลน์จาก from ถึง to (ค่าเริ่มต้น 24 ชั่วโมง) และทุกการกำหนดที่ไปถึงหน้าจอนั้น ต้องระบุ screenId
• list_assignments: แสดงรายการการกำหนด การกำหนดที่เผยแพร่ไปยังกลุ่ม (groupId) หรือไปยังสถานที่ แบรนด์ หรือองค์กรของสถานที่ (target ค่าเริ่มต้น facility) แบ่งหน้า เรียงจากการเปลี่ยนแปลงล่าสุด

เปลี่ยนสิ่งที่เผยแพร่ไปยัง Display Screens: แก้ไขเวลา ลำดับความสำคัญ หรือเนื้อหาของการกำหนด (เลือกใช้กับการเผยแพร่ทั้งหมดได้) หรือนำการกำหนดหนึ่งรายการหรือการเผยแพร่ทั้งหมดออก ค้นหา ID ได้ด้วย display_schedule_read การนำเนื้อหาออกจากกำหนดการจะยังคงเก็บเนื้อหาไว้ในคลัง หากต้องการสิ้นสุด Takeover ก่อนเวลาแต่เก็บประวัติไว้ ให้ใช้ display_takeover_stop

การดำเนินการ:

• update: อัปเดตการกำหนด เปลี่ยนเวลา (ช่วงเวลารายสัปดาห์ from/to และ null คือล้างวันที่) ลำดับความสำคัญ หรือเนื้อหาของการกำหนด applyToBatch จะเปลี่ยนแบบเดียวกันกับทุกเป้าหมายของการเผยแพร่ Takeover เปลี่ยนได้เฉพาะเวลาสิ้นสุดใหม่ เนื้อหากล้องวงจรปิดต้องใช้ confirmCctv หลังจากผู้ใช้ยินยอม ต้องระบุ assignmentId
• delete: นำออกจากกำหนดการ นำการกำหนดหนึ่งรายการ (assignmentId) หรือทุกอย่างจากการเผยแพร่หนึ่งครั้ง (batchId) ออก หน้าจอจะกลับไปแสดงสิ่งที่ควรแสดงตามปกติภายในไม่กี่วินาที จะขอการยืนยัน

ส่งคำสั่งแบบเรียลไทม์ไปยัง Display Screens ที่สถานที่: reload (หน้าจอ player ดึงกำหนดการใหม่) 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" (เมื่อพูดกับผู้ใช้ ให้เรียกว่า "Templated content" เสมอ ห้ามใช้ชื่อเดิม) และ url คือ "Full-page website (Kiosk Mode)" เวลาเป็นแบบ ISO และจะส่งคืนเขตเวลาของสถานที่ด้วย

การดำเนินการ:

• list: แสดงรายการหน้าจอ หน้าจอที่สถานที่ (แบ่งหน้า) แต่ละหน้าจอพร้อมสถานะ heartbeat ล่าสุด กลุ่ม แท็ก และสิ่งที่แสดงอยู่ตอนนี้และถัดไป ส่งคืนกลุ่มด้วย
• get: ดูหน้าจอ รายละเอียดทั้งหมดของหน้าจอหนึ่ง (สถานะ heartbeat เวอร์ชัน player ข้อผิดพลาดล่าสุด) และสำหรับหน้าจอ player จะแสดงสิ่งที่หน้าจอแสดงตลอดช่วงเวลา (ค่าเริ่มต้น 24 ชั่วโมงถัดไป สูงสุด 14 วัน) ต้องระบุ screenId
• groups: แสดงรายการกลุ่มหน้าจอ กลุ่มหน้าจอที่สถานที่ (แบ่งหน้า) แต่ละกลุ่มพร้อมหน้าจอในกลุ่ม

เปลี่ยนแปลง Display Screens: จับคู่หน้าจอใหม่ด้วยรหัสจับคู่ เปลี่ยนชื่อหน้าจอ กำหนดกลุ่มและแท็ก หรือเปลี่ยนโหมดการแสดงผล (แสดงต่อผู้ใช้เป็น "Data Source") หมุนเวียนโทเค็นของหน้าจอ player สร้างลิงก์ตัวอย่างแบบจำกัดเวลาของหน้าจอหรือเนื้อหา หรือรีเซ็ตหน้าจอเป็นค่าจากโรงงาน (นำหน้าจอออกจากสถานที่)

โหมดการแสดงผล: player ("User managed content") url ("Full-page website (Kiosk Mode)" ระบุ url เฉพาะ https) program-builder ("Templated content" เมื่อพูดกับผู้ใช้ ให้เรียกว่า "Templated content" เสมอ ห้ามใช้ชื่อเดิม) การเปลี่ยนโหมดจะโหลดหน้าจอใหม่ทันทีและเปลี่ยนสิ่งที่สมาชิกเห็น จึงต้องให้ผู้ใช้ยืนยัน

การดำเนินการ:

• update: อัปเดตหน้าจอ ตั้งค่าชื่อ กลุ่ม (ID หรือชื่อ แทนที่กลุ่มปัจจุบัน) แท็ก (แทนที่แท็กเดิม) และ/หรือโหมดการแสดงผลของหน้าจอ การเปลี่ยนโหมดจะส่งคืน requiresConfirmation ก่อน ต้องระบุ screenId อาจขอการยืนยัน
• rotate_token: หมุนเวียนโทเค็นของหน้าจอ ออกโทเค็นใหม่ให้หน้าจอ player และโหลดหน้าจอใหม่ โทเค็นเดิมจะใช้งานไม่ได้อีก ใช้เมื่อ URL ของ player ของหน้าจออาจรั่วไหล ต้องระบุ screenId จะขอการยืนยัน
• create_preview_link: สร้างลิงก์ตัวอย่าง ลิงก์ (ใช้ได้ในเวลาจำกัด) ที่แสดงสิ่งที่หน้าจอแสดง หรือลักษณะของเนื้อหา โดยเลือกดู ณ เวลาในอนาคตได้ ทุกคนที่มีลิงก์จะดูได้จนกว่าลิงก์จะหมดอายุ
• reset: รีเซ็ตหน้าจอเป็นค่าจากโรงงาน นำหน้าจอออกจากสถานที่และรีเซ็ตเป็นค่าจากโรงงาน หน้าจอที่ปิดเครื่องอยู่จะรีเซ็ตเมื่อกลับมาออนไลน์ครั้งถัดไป แล้วแสดงหน้าจับคู่ ระบุ confirmName: ชื่อหน้าจอตรงตามที่ผู้ใช้พิมพ์ ต้องมี การจัดการอุปกรณ์ ต้องระบุ screenId, confirmName จะขอการยืนยัน
• pair: จับคู่หน้าจอใหม่ เพิ่มหน้าจอใหม่ให้สถานที่ด้วยรหัส 6 ตัวอักษรบนหน้าจับคู่ แล้วโหลดหน้าจอใหม่ สถานที่ที่มีเฉพาะ Display Screens จะเริ่มหน้าจอในโหมด player หากมี Templated content ด้วย mode จะเป็นตัวเลือก (ค่าเริ่มต้น program-builder) ต้องมี การจัดการอุปกรณ์ ต้องระบุ pairingCode, name จะขอการยืนยัน

จับภาพสิ่งที่ Display Screen แสดงอยู่ในขณะนี้และส่งคืนรูปภาพ เพื่อให้คุณตรวจสอบงานของตัวเองหลังการเผยแพร่ได้ (เลย์เอาต์ ขนาดข้อความ ไม่มีส่วนใดถูกตัดหรือเลื่อน) รอให้หน้าจอตอบกลับได้สูงสุด 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: บันทึกกำหนดการเปิดปิด เปลี่ยนเวลาที่หน้าจอเปิดและปิด โดยฟิลด์ที่คุณระบุจะรวมเข้ากับกำหนดการที่บันทึกไว้ ส่งคืนเวลาเปิด/ปิดของ 7 วันถัดไป ตรวจสอบด้วย display_settings_read power_schedule_preview ก่อน ต้องระบุ schedule
• save_automations: บันทึกระบบอัตโนมัติของการแสดงผล เปลี่ยนการตั้งค่าความสว่างอัตโนมัติ ระดับเสียงกริ่ง และการเปิดหน้าจอเมื่อเช็กอิน หลังจากนั้นสถานที่จะใช้การตั้งค่าของตัวเองแทนค่าเริ่มต้นส่วนกลาง

สิ้นสุด Takeover ของ Display Screens ที่กำลังทำงานอยู่ทันที: สำหรับการเผยแพร่หนึ่งครั้ง (batchId จาก display_publish) สำหรับเป้าหมาย (ค่าเริ่มต้น: Takeover ที่เผยแพร่ไปยังทั้งสถานที่) หรือใช้ allScreens สำหรับทุก Takeover ที่เผยแพร่ไปยังสถานที่ หน้าจอ หรือกลุ่มของหน้าจอ Takeover ระดับแบรนด์และองค์กรจะหยุดได้ด้วย 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