Màn hình hiển thị
Nền tảng cốt lõidisplay_brand_settings_writeMàn hình hiển thị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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "save_boot_screen" | "reset_boot_screen" | "save_screen_defaults" | "save_templated" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
imageUrl | string | URL https công khai của hình ảnh (save_boot_screen) |
imageBase64 | string | Hình ảnh dưới dạng base64, khi không có URL (save_boot_screen) |
fit | "logo" | "fill" | (save_boot_screen) |
background | string | Màu nền (#RRGGBB) (save_boot_screen) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
orientation | "normal" | "left" | "right" | "inverted" | Screen rotation (save_screen_defaults) |
airplayEnabled | boolean | Screens accept AirPlay (save_screen_defaults) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (save_screen_defaults) |
sonosEnabled | boolean | Sonos speaker control (save_screen_defaults) |
duressEnabled | boolean | Bluetooth duress button monitoring (save_screen_defaults) |
cameraRestreamingEnabled | boolean | Restream local camera feeds from the screen (save_screen_defaults) |
wifiSupport | boolean | Captive Wi-Fi setup portal (save_screen_defaults) |
showSourceName | boolean | (save_templated) |
showWorkoutNames | boolean | (save_templated) |
showProgramsInSchedule | boolean | (save_templated) |
programLookaheadDays | integernull | Số ngày hiển thị trước (0–90), hoặc null để không giới hạn (save_templated) |
showTrainingPhases | boolean | (save_templated) |
phaseLookaheadDays | integernull | Số ngày hiển thị trước (0–90), hoặc null để không giới hạn (save_templated) |
showTrainingCamps | boolean | (save_templated) |
campLookaheadDays | integernull | Số ngày hiển thị trước (0–90), hoặc null để không giới hạn (save_templated) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_groups_writeMàn hình hiển thịTạo, đổi tên và xóa các nhóm Display Screen tại một cơ sở và đặt những màn hình nào thuộc nhóm. Nhóm là đích xuất bản (display_publish targets.groupIds) và đích lệnh (display_screen_command groupIds). Khi có nhiều màn hình, nhóm hoặc đích, công cụ sẽ tác động lên tất cả trong một lần gọi; hãy hỏi lại người dùng trước khi tác động lên nhiều mục.
Các hành động:
- save: Lưu một nhóm. Tạo: name (và tùy chọn screenIds). Đổi tên: groupId (id hoặc tên hiện tại) và name. screenIds thay thế các thành viên; màn hình không được liệt kê sẽ rời nhóm này nhưng vẫn giữ các nhóm khác.
- delete: Xóa một nhóm. Xóa nhóm: các màn hình rời khỏi nhóm (vẫn giữ các nhóm khác) và nội dung đã xuất bản cho nhóm bị gỡ khỏi lịch. Cần groupId. Yêu cầu xác nhận.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "save" | "delete" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
groupId | string | ID hoặc tên của nhóm hiện có, để đổi tên hoặc thay đổi thành viên |
name | string | Tên nhóm (bắt buộc khi tạo) (save) |
screenIds | array | Các màn hình trong nhóm; thay thế các thành viên hiện tại (save) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_hosted_apps_writeMàn hình hiển thịXuất bản ứng dụng HTML tĩnh ("ứng dụng được lưu trữ") cho Display Screens. Trước tiên hãy gọi display_library_read app_guidelines để biết kích thước màn hình, quy tắc thiết kế, giới hạn và SDK, sau đó gọi display_screenshot để kiểm tra kết quả trên màn hình. Khi có nhiều màn hình, nhóm hoặc đích, công cụ sẽ tác động lên tất cả trong một lần gọi; hãy hỏi lại người dùng trước khi tác động lên nhiều mục.
Các hành động:
- publish: Xuất bản ứng dụng được lưu trữ. Tạo ứng dụng được lưu trữ (name + files) hoặc xuất bản phiên bản mới (appId + files; phiên bản mới có hiệu lực ở mọi nơi ứng dụng đang hiển thị, rollback sẽ hoàn tác). publishTo cũng đưa ứng dụng lên màn hình, giống như display_publish; đích là thương hiệu hoặc tổ chức cần confirm. Cần files. Có thể yêu cầu xác nhận.
- rollback: Khôi phục phiên bản trước của ứng dụng được lưu trữ. Đặt lại một phiên bản cũ hơn làm phiên bản hiện hành, ở mọi nơi ứng dụng đang hiển thị. Liệt kê các phiên bản bằng display_library_read app_versions. Cần appId, version.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "publish" | "rollback" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
appId | string | ID ứng dụng được lưu trữ hiện có (app_…) để xuất bản phiên bản mới |
name | string | Tên ứng dụng (bắt buộc khi tạo) (publish) |
files | array | Các tệp của ứng dụng. encoding là utf8 (mặc định) hoặc base64 cho tệp nhị phân. (publish) |
entry | string | Tệp HTML đầu vào (mặc định index.html) (publish) |
durationSec | number | Thời gian hiển thị mặc định trên màn hình trong danh sách phát, tính bằng giây (publish) |
tags | array | (publish) |
ownerScope | "facility" | "brand" | "organisation" | Ai sở hữu nội dung mới (mặc định facility). brand và organisation cần quyền truy cập toàn tổ chức. (publish) |
publishTo | object | (publish) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
version | integer | Phiên bản cần đặt làm hiện hành (rollback) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_library_readMàn hình hiển thịĐọc thư viện nội dung Display Screens mà một cơ sở nhìn thấy: phương tiện (hình ảnh, video), ứng dụng (trang web, ứng dụng HTML được lưu trữ, ứng dụng AI Agent, chế độ xem camera giám sát) và danh sách phát, cùng các ứng dụng AI Agent và nguồn camera giám sát có thể thêm.
Mỗi mục có một contentRef (media#…, app#…, playlist#…) dùng cho display_publish và danh sách phát. ownerScope cho biết ai sở hữu mục đó (facility#, brand# hoặc org#); nội dung chỉ có thể được xuất bản trong phạm vi chủ sở hữu. Phương tiện có trạng thái processing chưa sẵn sàng; failed cần tải lên lại. Trang web có frameable: false không thể phát trong danh sách phát, chỉ có thể làm màn hình toàn trang. Màn hình bỏ qua các mục có displayIssue: ứng dụng AI Agent chưa xuất bản, đang tạm dừng, display-off, giới hạn đối tượng hoặc không có Custom Apps; chế độ xem camera giám sát có no-cctv, cctv-off (quản trị viên cơ sở bật camera giám sát cho màn hình trong cài đặt Display Screens) hoặc no-cameras.
Các hành động:
- list: Liệt kê các mục trong thư viện. Phương tiện và ứng dụng (phân trang; lọc theo type, kind, tag hoặc tên), hoặc với type agent-apps là các ứng dụng AI Agent được phép hiển thị trên màn hình mà bạn có thể xuất bản bằng display_publish content.agentAppId. Mỗi mục có một type: media, app hoặc agent-app.
- cctv_sources: Liệt kê nguồn camera giám sát. Các camera và Xem trực tiếp được chia sẻ của cơ sở dùng cho display_publish content.cctv, và camera giám sát trên màn hình có đang bật hay không. Cần quyền truy cập camera giám sát tại cơ sở.
- get: Lấy một mục trong thư viện. Một mục phương tiện, ứng dụng hoặc danh sách phát theo contentRef. Cần contentRef.
- usages: Nơi nội dung được sử dụng. Các phân công lịch đang hoạt động và danh sách phát sử dụng một mục phương tiện hoặc ứng dụng (hoặc các phân công của một danh sách phát). Không thể xóa nội dung đang được sử dụng. Cần contentRef.
- app_versions: Liệt kê các phiên bản ứng dụng được lưu trữ. Các phiên bản của một ứng dụng được lưu trữ và phiên bản nào đang hiện hành, dùng cho display_hosted_apps_write rollback. Cần appId.
- app_guidelines: Hướng dẫn về ứng dụng được lưu trữ. Kích thước màn hình, quy tắc thiết kế, giới hạn gói, Display App SDK và một mẫu khởi đầu. Gọi công cụ này trước khi xây dựng ứng dụng cho display_hosted_apps_write publish.
- check_url: Kiểm tra một trang web. Trang web có thể hiển thị trong danh sách phát hay không (một số trang web từ chối được nhúng khung), kèm gợi ý về cách trang hiển thị. Trang từ chối nhúng khung vẫn có thể làm màn hình toàn trang. Cần url.
- playlists: Liệt kê danh sách phát. Các danh sách phát mà cơ sở nhìn thấy (phân trang), mỗi danh sách kèm các mục của nó (contentRef, duration, fit).
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "list" | "cctv_sources" | "get" | "usages" | "app_versions" | "app_guidelines" | "check_url" | "playlists" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
type | "media" | "apps" | "agent-apps" | Chỉ một loại mục (mặc định: phương tiện và ứng dụng) (list) |
kind | "image" | "video" | "url" | "hosted" | "agent-app" | "cctv-view" | (list) |
tag | string | Chỉ các mục có thẻ này (list) |
search | string | Bộ lọc tên không phân biệt chữ hoa chữ thường (list) |
limit | integer | Số mục mỗi trang (mặc định 25, tối đa 100) (list, playlists) |
cursor | string | nextCursor từ trang trước (list, playlists) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. (list, cctv_sources, get, usages, app_versions, check_url, playlists) |
contentRef | string | media#<id>, app#<id> hoặc playlist#<id>, từ display_library_read list hoặc playlists (get, usages) |
appId | string | ID ứng dụng được lưu trữ (app_…) (app_versions) |
url | string | URL https công khai (check_url) |
display_library_writeMàn hình hiển thịThêm và thay đổi nội dung thư viện Display Screens: tải lên hình ảnh và video, tạo ứng dụng trang web, ứng dụng AI Agent và ứng dụng chế độ xem camera giám sát, sửa tên, thẻ, thời lượng và ngày, xóa các mục không dùng đến và làm mới bản xem trước của ứng dụng. Ứng dụng HTML được lưu trữ được xuất bản bằng display_hosted_apps_write; danh sách phát bằng display_playlists_write.
Thiết kế hình ảnh ở kích thước 1920×1080 (ngang) hoặc 1080×1920 (dọc). Phương tiện mới bắt đầu ở trạng thái processing trong khi các phiên bản dùng cho web được tạo; có thể đưa vào danh sách phát ngay và sẽ phát khi sẵn sàng. ownerScope: facility (mặc định), brand hoặc organisation (brand và organisation cần quyền truy cập toàn tổ chức).
Các hành động:
- upload_media: Tải lên hình ảnh hoặc video. Thêm hình ảnh hoặc video từ url https công khai (nên dùng; hình ảnh tối đa 25 MB, video tối đa 200 MB) hoặc base64 kèm mimeType (tối đa 20 MB). Hình ảnh JPEG, PNG, WebP, GIF; video MP4, WebM, MOV (được chuyển đổi sang H.264 MP4 tối đa 1080p). Video lớn hơn: create_video_upload.
- create_video_upload: Bắt đầu tải lên video lớn. Với video tối đa 2 GB: ghi nhận video và trả về một lượt tải lên được ký sẵn (PUT tệp lên upload.url với upload.headers trước upload.expiresAt), sau đó gọi transcode với contentRef của video. Cần name, mimeType, bytes.
- transcode: Xử lý video. Chuyển đổi video cho màn hình: sau create_video_upload, lại sau khi thất bại, hoặc với video cũ mà màn hình không phát được. Cần contentRef.
- create_app: Thêm ứng dụng. Thêm trang web (kind url, truyền url; được kiểm tra khả năng nhúng khung), ứng dụng AI Agent (kind agent-app, truyền agentAppId từ display_library_read list type agent-apps) hoặc chế độ xem camera giám sát (kind cctv-view, thuộc sở hữu của cơ sở, cần quyền truy cập camera giám sát). Cần kind, name.
- update: Cập nhật một mục trong thư viện. Thay đổi tên, thẻ hoặc thời lượng của mục phương tiện hoặc ứng dụng; validFrom/validTo của mục phương tiện (ISO, null để xóa; ngoài khoảng này mục sẽ bị bỏ qua); url của trang web; hoặc camera, chế độ xem, bố cục hay chất lượng của chế độ xem camera giám sát. Cần contentRef.
- delete: Xóa một mục trong thư viện. Xóa một mục phương tiện hoặc ứng dụng. Bị chặn khi mục đang nằm trong lịch đang hoạt động hoặc danh sách phát: thông báo lỗi sẽ liệt kê chúng (hãy gỡ chúng trước bằng display_schedule_write delete hoặc display_playlists_write save). Cần contentRef. Yêu cầu xác nhận.
- refresh_preview: Làm mới bản xem trước của ứng dụng. Chụp ảnh màn hình mới của ứng dụng cho bản xem trước trong thư viện (ví dụ sau khi trang thay đổi). Cần contentRef.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "upload_media" | "create_video_upload" | "transcode" | "create_app" | "update" | "delete" | "refresh_preview" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
url | string | URL https công khai của hình ảnh hoặc video (nên dùng) (upload_media, create_app, update) |
base64 | string | Nội dung tệp dưới dạng base64 (tối đa 20 MB), khi không có URL (upload_media) |
mimeType | string | Bắt buộc khi dùng base64, ví dụ image/png (upload_media, create_video_upload) |
name | string | Tên trong thư viện (upload_media, create_video_upload, create_app, update) |
tags | array | Thẻ (thay thế các thẻ hiện tại) (upload_media, create_video_upload, create_app, update) |
ownerScope | "facility" | "brand" | "organisation" | Ai sở hữu nội dung mới (mặc định facility). brand và organisation cần quyền truy cập toàn tổ chức. (upload_media, create_video_upload, create_app) |
durationSec | number | Thời gian hiển thị mặc định trên màn hình cho hình ảnh, tính bằng giây (upload_media, create_app, update) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
bytes | integer | Kích thước tệp tính bằng byte (create_video_upload) |
resolution | "720" | "1080" | "1440" | "2160" | "original" | Kích thước lớn nhất mà video được chuyển đổi cho màn hình (mặc định 1080; original giữ nguyên kích thước) (create_video_upload, transcode) |
contentRef | string | media#<id>, app#<id> hoặc playlist#<id>, từ display_library_read list hoặc playlists (transcode, update, delete, refresh_preview) |
kind | "url" | "agent-app" | "cctv-view" | (create_app) |
agentAppId | string | Ứng dụng AI Agent: ID ứng dụng (create_app) |
source | "view" | "cameras" | Chế độ xem camera giám sát: view (truyền viewId) hoặc cameras (truyền cameras) (create_app, update) |
viewId | string | Chế độ xem camera giám sát: ID Xem trực tiếp (display_library_read cctv_sources) (create_app, update) |
cameras | array | Chế độ xem camera giám sát: ID camera (display_library_read cctv_sources) (create_app, update) |
layout | "auto" | "1x1" | "2x1" | "1+2" | "2x2" | "1+5" | "2x3" | "3x3" | Chế độ xem camera giám sát: bố cục ô (create_app, update) |
quality | "auto" | "native" | "1080p" | "720p" | "480p" | "360p" | "240p" | Chế độ xem camera giám sát: chất lượng luồng (create_app, update) |
showNames | boolean | Chế độ xem camera giám sát: hiển thị tên camera trên các ô (create_app, update) |
validFrom | stringnull | Phương tiện: ngày giờ ISO bắt đầu phát; null để xóa (update) |
validTo | stringnull | Phương tiện: ngày giờ ISO ngừng phát; null để xóa (update) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_playlists_writeMàn hình hiển thịTạo, cập nhật và xóa danh sách phát Display Screens: các vòng lặp có thứ tự gồm phương tiện và ứng dụng. Thay đổi đến được mọi màn hình đang hiển thị danh sách phát trong vài giây. Xuất bản danh sách phát bằng display_publish content.contentRef "playlist#
Các hành động:
- save: Lưu danh sách phát. Tạo: name + items (items có thể trống). Cập nhật: playlistId + bất kỳ trường nào trong name, items, transition; items thay thế toàn bộ danh sách, vì vậy hãy gửi mọi mục theo thứ tự.
- delete: Xóa danh sách phát. Xóa một danh sách phát. Bị chặn khi danh sách phát đang được xuất bản ở bất kỳ đâu: thông báo lỗi sẽ liệt kê các phân công cần gỡ trước (display_schedule_write delete). Cần playlistId. Yêu cầu xác nhận.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "save" | "delete" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
playlistId | string | ID danh sách phát hiện có (pl_…) cần cập nhật |
name | string | Tên danh sách phát (bắt buộc khi tạo) (save) |
transition | "fade" | "none" | (save) |
ownerScope | "facility" | "brand" | "organisation" | Ai sở hữu nội dung mới (mặc định facility). brand và organisation cần quyền truy cập toàn tổ chức. (save) |
items | array | Toàn bộ danh sách, theo thứ tự (thay thế các mục hiện tại; giữ itemId để giữ lại một mục). Trang web có frameable: false sẽ không phát. (save) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_publishMàn hình hiển thịĐưa nội dung lên Display Screens: một mục phương tiện, danh sách phát, ứng dụng, trang web, ứng dụng AI Agent hoặc Xem trực tiếp camera giám sát, lên màn hình, nhóm, cơ sở, thương hiệu hoặc tổ chức của cơ sở.
mode: now (mặc định) thay thế nội dung mà các đích thường hiển thị; scheduled chỉ hiển thị trong các khung giờ hằng tuần (theo múi giờ của cơ sở) và/hoặc giữa from và to; takeover ngắt mọi nội dung trong durationMin (hoặc đến một thời điểm), sau đó tự kết thúc (dừng sớm bằng display_takeover_stop). Màn hình xác định nội dung cần hiển thị theo lớp (takeover > scheduled > default), sau đó theo mức độ cụ thể của đích (screen > group > facility > brand > organisation).
Camera giám sát: bất kỳ ai ở gần màn hình đều có thể thấy hình ảnh camera trực tiếp. Lần gọi đầu tiên trả về requiresConfirmation (mã CCTV_CONFIRMATION_REQUIRED); hãy hỏi người dùng, rồi gọi lại với confirmCctv: true. Cơ sở phải bật "Allow CCTV on display screens".
Chỉ màn hình ở chế độ player mới hiển thị nội dung đã xuất bản; các màn hình khác được liệt kê trong warnings. Trả về một batchId; display_schedule_write delete với batchId này sẽ hoàn tác toàn bộ lần xuất bản. Khi có nhiều màn hình, nhóm hoặc đích, công cụ sẽ tác động lên tất cả trong một lần gọi; hãy hỏi lại người dùng trước khi tác động lên nhiều mục.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
targets* | object | Nơi nội dung được đưa đến. Có thể kết hợp bất kỳ mục nào sau đây. Có thể dùng tên nhóm thay cho ID. brand và organisation cần quyền truy cập Display Screens toàn tổ chức. |
content* | object | Nội dung hiển thị: đúng một trong contentRef, url, agentAppId hoặc cctv. |
mode | "now" | "default" | "scheduled" | "takeover" | `now`/`default` (mặc định): thay thế nội dung mà các đích thường hiển thị. `scheduled`: chỉ trong các khung giờ và/hoặc giữa from và to. `takeover`: ngắt mọi nội dung trong durationMin (hoặc đến một thời điểm), sau đó tự kết thúc. |
windows | array | Các khung giờ hằng tuần theo múi giờ của cơ sở. days là các ngày trong tuần theo ISO (1 = thứ Hai … 7 = Chủ Nhật); start/end có dạng "HH:MM" (cho phép end "24:00"). |
from | string | Ngày giờ ISO bắt đầu lần xuất bản theo lịch |
to | string | Ngày giờ ISO kết thúc lần xuất bản theo lịch |
durationMin | number | Thời lượng Takeover tính bằng phút (tối đa 7 ngày) |
until | string | Ngày giờ ISO kết thúc Takeover (thay cho durationMin) |
priority | integer | Phân định khi các mục theo lịch chồng lấn nhau (giá trị cao hơn được ưu tiên) |
confirmCctv | boolean | Chỉ đặt sau khi người dùng đã xác nhận rõ ràng việc hiển thị camera giám sát trực tiếp |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_schedule_readMàn hình hiển thịĐọc nội dung đã xuất bản lên Display Screens: với một màn hình, nội dung nó hiển thị tại một thời điểm và trong một khoảng thời gian (được xác định qua mọi lớp và đích mà màn hình kế thừa) cùng các phân công áp dụng cho nó; hoặc các phân công đã xuất bản cho một nhóm, cơ sở, thương hiệu hoặc tổ chức của cơ sở.
ID phân công (as_…) và ID lô (bt_…) là những gì display_schedule_write cập nhật hoặc xóa. Thời gian theo định dạng ISO; khung giờ theo múi giờ của cơ sở.
Các hành động:
- get: Lấy lịch của một màn hình. Nội dung màn hình hiển thị tại
at(mặc định là bây giờ), dòng thời gian từfromđếnto(mặc định 24 giờ) và mọi phân công áp dụng cho màn hình. Cần screenId. - list_assignments: Liệt kê phân công. Các phân công đã xuất bản cho một nhóm (groupId), hoặc cho cơ sở, thương hiệu hoặc tổ chức của cơ sở (target, mặc định facility). Phân trang, thay đổi mới nhất trước.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "get" | "list_assignments" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
screenId | string | ID màn hình (mã 6 ký tự) từ display_screens_read list (get) |
at | string | Ngày giờ ISO để kiểm tra nội dung đang hiển thị (mặc định là bây giờ) (get) |
from | string | Thời điểm bắt đầu dòng thời gian theo ISO (mặc định là at, nếu không thì bây giờ) (get) |
to | string | Thời điểm kết thúc dòng thời gian theo ISO (mặc định 24 giờ sau from) (get) |
includeExpired | boolean | Bao gồm các phân công đã kết thúc |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
groupId | string | ID hoặc tên nhóm màn hình, từ display_screens_read groups (list_assignments) |
target | "facility" | "brand" | "organisation" | Khi không có groupId (mặc định facility) (list_assignments) |
limit | integer | Số mục mỗi trang (mặc định 25, tối đa 100) (list_assignments) |
cursor | string | nextCursor từ trang trước (list_assignments) |
display_schedule_writeMàn hình hiển thịThay đổi nội dung đã xuất bản lên Display Screens: sửa thời gian, mức ưu tiên hoặc nội dung của một phân công (tùy chọn áp dụng cho toàn bộ lần xuất bản), hoặc gỡ một phân công hay toàn bộ một lần xuất bản. Tìm ID bằng display_schedule_read. Gỡ nội dung khỏi lịch vẫn giữ nội dung đó trong thư viện; để kết thúc sớm một Takeover nhưng vẫn giữ lịch sử, hãy dùng display_takeover_stop.
Các hành động:
- update: Cập nhật một phân công. Thay đổi thời gian (khung giờ hằng tuần, from/to; null để xóa một ngày), mức ưu tiên hoặc nội dung của một phân công. applyToBatch áp dụng cùng thay đổi cho mọi đích của lần xuất bản. Takeover chỉ có thể nhận thời điểm kết thúc mới. Nội dung camera giám sát cần confirmCctv sau khi người dùng đồng ý. Cần assignmentId.
- delete: Gỡ khỏi lịch. Gỡ một phân công (assignmentId) hoặc mọi thứ của một lần xuất bản (batchId). Màn hình quay lại nội dung lẽ ra sẽ hiển thị trong vài giây. Yêu cầu xác nhận.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "update" | "delete" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
assignmentId | string | Một phân công (as_…) từ display_schedule_read |
applyToBatch | boolean | Áp dụng cùng thay đổi cho mọi đích của lần xuất bản (update) |
windows | array | Các khung giờ hằng tuần theo múi giờ của cơ sở. days là các ngày trong tuần theo ISO (1 = thứ Hai … 7 = Chủ Nhật); start/end có dạng "HH:MM" (cho phép end "24:00"). (update) |
from | stringnull | Ngày giờ ISO bắt đầu; null để xóa (update) |
to | stringnull | Ngày giờ ISO kết thúc; null để xóa (update) |
priority | integer | Phân định khi các mục theo lịch chồng lấn nhau (giá trị cao hơn được ưu tiên) (update) |
contentRef | string | media#<id>, app#<id> hoặc playlist#<id>, từ display_library_read list hoặc playlists (update) |
confirmCctv | boolean | Chỉ đặt sau khi người dùng đã xác nhận rõ ràng việc hiển thị camera giám sát trực tiếp (update) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
batchId | string | Toàn bộ một lần xuất bản (bt_…) từ display_publish hoặc display_schedule_read, trên tất cả các đích của nó (delete) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_screen_commandMàn hình hiển thịGửi lệnh trực tiếp đến Display Screens tại một cơ sở: reload (màn hình player tải lại lịch), identify (nháy tên và mã của màn hình để tìm nó tại địa điểm), displayOn/displayOff (bảng TV), rebootDevice (khởi động lại máy tính của màn hình, màn hình trống 1–2 phút; cần confirm: true) hoặc osd (một thông báo ngắn trên màn hình; truyền message).
Chọn màn hình bằng screenIds và/hoặc groupIds (mọi màn hình thuộc các nhóm đó tại cơ sở), hoặc allScreens: true cho mọi màn hình tại cơ sở (khi đó displayOn/displayOff cũng áp dụng cho màn hình Templated content). Trả về kết quả theo từng màn hình. Khi có nhiều màn hình, nhóm hoặc đích, công cụ sẽ tác động lên tất cả trong một lần gọi; hãy hỏi lại người dùng trước khi tác động lên nhiều mục.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
screenIds | array | ID màn hình (mã 6 ký tự) từ display_screens_read list. Bỏ qua khi dùng allScreens. |
groupIds | array | ID hoặc tên nhóm màn hình: mọi màn hình thuộc các nhóm đó tại cơ sở |
allScreens | boolean | Mọi màn hình tại cơ sở, bao gồm cả màn hình Templated content |
command* | "reload" | "identify" | "displayOn" | "displayOff" | "rebootDevice" | "osd" | Việc cần làm (rebootDevice cần confirm) |
message | string | Văn bản cho osd |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_screens_readMàn hình hiển thịĐọc Display Screens của một cơ sở: liệt kê màn hình kèm trạng thái và nội dung đang hiển thị và sắp hiển thị (lọc theo nhóm, trạng thái hoặc chế độ hiển thị), lấy toàn bộ thông tin và dòng thời gian của một màn hình, hoặc liệt kê các nhóm màn hình cùng màn hình của chúng.
Chế độ hiển thị được hiển thị cho người dùng là "Data Source": player là "User managed content", program-builder là "Templated content" (không bao giờ dùng tên cũ của chế độ này với người dùng), url là "Full-page website (Kiosk Mode)". Thời gian theo định dạng ISO; múi giờ của cơ sở được trả về.
Các hành động:
- list: Liệt kê màn hình. Các màn hình tại cơ sở (phân trang), mỗi màn hình kèm trạng thái, tín hiệu hoạt động gần nhất, nhóm, thẻ và nội dung đang hiển thị và sắp hiển thị. Đồng thời trả về các nhóm.
- get: Lấy một màn hình. Toàn bộ thông tin của một màn hình (trạng thái, tín hiệu hoạt động, phiên bản player, lỗi gần đây) và, với màn hình player, nội dung hiển thị trong một khoảng thời gian (mặc định 24 giờ tới, tối đa 14 ngày). Cần screenId.
- groups: Liệt kê nhóm màn hình. Các nhóm màn hình tại cơ sở (phân trang), mỗi nhóm kèm các màn hình của nó.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "list" | "get" | "groups" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
groupId | string | Chỉ các màn hình trong nhóm này (ID hoặc tên) (list) |
status | "playing" | "provisioning" | "display-off" | "not-responding" | "offline" | "online" | (list) |
mode | "player" | "program-builder" | "url" | (list) |
limit | integer | Số mục mỗi trang (mặc định 25, tối đa 100) (list, groups) |
cursor | string | nextCursor từ trang trước (list, groups) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
screenId | string | ID màn hình (mã 6 ký tự) từ display_screens_read list (get) |
from | string | Thời điểm bắt đầu dòng thời gian theo ISO (mặc định là bây giờ) (get) |
to | string | Thời điểm kết thúc dòng thời gian theo ISO (mặc định 24 giờ sau from) (get) |
display_screens_writeMàn hình hiển thịQuản lý thiết bịThay đổi Display Screens: ghép nối màn hình mới bằng mã ghép nối; đổi tên màn hình, đặt nhóm và thẻ, hoặc chuyển chế độ hiển thị (được hiển thị cho người dùng là "Data Source"); xoay vòng token của màn hình player; tạo liên kết xem trước có thời hạn cho một màn hình hoặc nội dung; hoặc khôi phục cài đặt gốc cho màn hình (gỡ màn hình khỏi cơ sở).
Các chế độ hiển thị: player ("User managed content"), url ("Full-page website (Kiosk Mode)", truyền url, chỉ https), program-builder ("Templated content"; không bao giờ dùng tên cũ của chế độ này với người dùng). Thay đổi chế độ sẽ tải lại màn hình ngay và thay đổi những gì hội viên nhìn thấy, vì vậy cần người dùng xác nhận.
Các hành động:
- update: Cập nhật màn hình. Đặt tên, nhóm (ID hoặc tên; thay thế các nhóm hiện tại), thẻ (thay thế các thẻ hiện tại) và/hoặc chế độ hiển thị của màn hình. Thay đổi chế độ sẽ trả về requiresConfirmation trước. Cần screenId. Có thể yêu cầu xác nhận.
- rotate_token: Xoay vòng token màn hình. Cấp token mới cho màn hình player và tải lại màn hình; token cũ ngừng hoạt động. Dùng khi URL player của màn hình có thể đã bị lộ. Cần screenId. Yêu cầu xác nhận.
- create_preview_link: Tạo liên kết xem trước. Một liên kết (có hiệu lực trong thời gian giới hạn) hiển thị nội dung của màn hình hoặc giao diện của nội dung, tùy chọn tại một thời điểm trong tương lai. Bất kỳ ai có liên kết đều có thể xem cho đến khi liên kết hết hạn.
- reset: Khôi phục cài đặt gốc cho màn hình. Gỡ màn hình khỏi cơ sở và khôi phục cài đặt gốc; màn hình đang tắt sẽ được đặt lại khi trực tuyến trở lại, sau đó hiển thị trang ghép nối. Truyền confirmName: tên màn hình đúng như người dùng đã nhập. Cần Quản lý thiết bị. Cần screenId, confirmName. Yêu cầu xác nhận.
- pair: Ghép nối màn hình mới. Thêm màn hình mới vào cơ sở bằng mã 6 ký tự trên trang ghép nối, sau đó tải lại màn hình. Cơ sở chỉ có Display Screens sẽ khởi động màn hình ở chế độ player; nếu có cả Templated content, mode sẽ quyết định (mặc định program-builder). Cần Quản lý thiết bị. Cần pairingCode, name. Yêu cầu xác nhận.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "update" | "rotate_token" | "create_preview_link" | "reset" | "pair" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
screenId | string | ID màn hình (mã 6 ký tự) từ display_screens_read list (update, rotate_token, create_preview_link, reset) |
name | string | Tên màn hình (update, pair) |
groupIds | array | ID hoặc tên nhóm; thay thế các nhóm hiện tại (tạo nhóm bằng display_groups_write save) (update) |
tags | array | Thay thế các thẻ hiện tại (update) |
mode | "player" | "program-builder" | "url" | Chế độ hiển thị ("Data Source") (update, pair) |
url | string | Trang web cho chế độ url (https) (update) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
contentRef | string | media#<id>, app#<id> hoặc playlist#<id>, từ display_library_read list hoặc playlists (create_preview_link) |
orientation | "landscape" | "portrait" | Cho bản xem trước contentRef (mặc định landscape) (create_preview_link) |
at | string | Ngày giờ ISO để xem trước (mặc định là bây giờ) (create_preview_link) |
confirmName | string | Tên màn hình do người dùng nhập để xác nhận (phải khớp chính xác) (reset) |
pairingCode | string | Mã mà màn hình hiển thị trên trang ghép nối (số 0 và chữ O trông giống nhau) (pair) |
contentStream | string | Templated content: luồng (vòng) mà màn hình phát, mặc định 1 (pair) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_screenshotMàn hình hiển thịChụp nội dung mà một Display Screen đang hiển thị và trả về hình ảnh, để bạn có thể kiểm tra kết quả sau khi xuất bản (bố cục, cỡ chữ, không có gì bị cắt hoặc phải cuộn). Chờ tối đa 15 giây để màn hình phản hồi; màn hình ngoại tuyến sẽ hết thời gian chờ. Đồng thời trả về một URL cổng thông tin cho tệp JPEG (chỉ người dùng đã đăng nhập, lưu trong 10 phút).
Ảnh chụp màn hình có thể chứa hình ảnh camera giám sát trực tiếp và những hội viên trong khung hình; không chia sẻ chúng ra ngoài cuộc trò chuyện.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
screenId* | string | ID màn hình (mã 6 ký tự) từ display_screens_read list |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
display_settings_readMàn hình hiển thị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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "settings" | "power_schedule" | "power_schedule_preview" | "automations" | "boot_screen" | "screen_defaults" | "templated" | "program_dates" | "templated_schedule" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
schedule | object | Màn hình bật trong giờ có nhân viên (mở rộng theo các khoảng chênh lệch) hoặc trong các khung giờ hằng tuần tùy chỉnh, kèm quy tắc cho ngày lễ. (power_schedule_preview) |
facilityIds | array | Nhiều ID cơ sở, để chạy cùng một yêu cầu tại từng cơ sở. Dùng thay cho facilityId. (automations) |
from | string | Ngày đầu tiên (YYYY-MM-DD) (templated_schedule) |
to | string | Ngày cuối cùng (YYYY-MM-DD) (templated_schedule) |
display_settings_writeMàn hình hiển thịThay đổi cài đặt Display Screens của một cơ sở: Fallback Slate, chu kỳ truy vấn và tải lại hằng đêm, và "Allow CCTV on display screens"; lịch bật/tắt màn hình; và các tự động hóa (độ sáng, âm lượng chuông, bật màn hình khi check-in). Các trường bạn bỏ qua giữ nguyên giá trị hiện tại. Cài đặt toàn thương hiệu (màn hình khởi động, Templated content) nằm trong display_brand_settings_write.
Các hành động:
- save_settings: Lưu cài đặt hiển thị của cơ sở. Fallback Slate hiển thị khi không có nội dung theo lịch, chu kỳ truy vấn (30–300 s), thời điểm tải lại hằng đêm (HH:mm) và allowCctv. Bật allowCctv cần người dùng xác nhận và một quản trị viên cơ sở có quyền truy cập camera giám sát. Có thể yêu cầu xác nhận.
- save_power_schedule: Lưu lịch bật/tắt. Thay đổi thời điểm màn hình bật và tắt; các trường bạn truyền vào được hợp nhất vào lịch đã lưu. Trả về thời gian bật/tắt trong 7 ngày tới. Hãy kiểm tra trước bằng display_settings_read power_schedule_preview. Cần schedule.
- save_automations: Lưu các tự động hóa hiển thị. Thay đổi cài đặt độ sáng tự động, âm lượng chuông và bật màn hình khi check-in. Sau đó cơ sở giữ cài đặt riêng thay cho các giá trị mặc định chung.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "save_settings" | "save_power_schedule" | "save_automations" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
slate | object | (save_settings) |
pollIntervalSec | integer | (save_settings) |
nightlyReloadTime | string | HH:mm (save_settings) |
allowCctv | boolean | Cho phép camera giám sát trên màn hình hiển thị (save_settings) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
schedule | object | Màn hình bật trong giờ có nhân viên (mở rộng theo các khoảng chênh lệch) hoặc trong các khung giờ hằng tuần tùy chỉnh, kèm quy tắc cho ngày lễ. (save_power_schedule) |
autoPowerDisplays | boolean | Bật/tắt tự động hóa nguồn cũ (lịch bật/tắt sẽ thay thế nó) (save_automations) |
minsBeforeOpenDisplayOn | integer | Tự động hóa nguồn cũ: số phút trước giờ mở cửa (save_automations) |
minsAfterCloseDisplayOff | integer | Tự động hóa nguồn cũ: số phút sau giờ đóng cửa (save_automations) |
displaysOnCheckIn | boolean | Bật màn hình khi có người check-in (save_automations) |
minsLastCheckInDisplayOff | integer | Với displaysOnCheckIn: số phút sau lần check-in cuối cùng thì màn hình tắt (save_automations) |
enableAutoBrightness | boolean | Chuyển đổi giữa độ sáng ban ngày và ban đêm (save_automations) |
dayTriggerType | "auto" | "staffed" | "custom" | Thời điểm độ sáng ban ngày bắt đầu (save_automations) |
dayTimeStart | string | Với dayTriggerType custom: HH:mm (giờ của cơ sở) (save_automations) |
dayOffsetMinutes | integer | Số phút sau bình minh hoặc sau giờ mở cửa (save_automations) |
dayBrightnessLevel | integer | Độ sáng ban ngày, % (save_automations) |
nightTriggerType | "auto" | "staffed" | "custom" | Thời điểm độ sáng ban đêm bắt đầu (save_automations) |
nightTimeStart | string | Với nightTriggerType custom: HH:mm (giờ của cơ sở) (save_automations) |
nightOffsetMinutes | integer | Số phút sau khi trời tối, hoặc trước giờ đóng cửa (save_automations) |
nightBrightnessLevel | integer | Độ sáng ban đêm, % (save_automations) |
bellMasterLevel | integer | Âm lượng chuông tổng, % (save_automations) |
bellClubHoursLevel | integer | Âm lượng chuông trong giờ có nhân viên, % (save_automations) |
bellExtendedHoursLevel | integer | Âm lượng chuông trong giờ mở rộng, % (save_automations) |
enableBellAutoVolume | boolean | Tuân theo lịch âm lượng chuông (save_automations) |
bellVolumeSchedule | object | Các khối âm lượng chuông hằng tuần theo từng ngày (mon … sun); thay thế toàn bộ lịch (save_automations) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |
display_takeover_stopMàn hình hiển thịKết thúc ngay các Takeover đang chạy trên Display Screens: cho một lần xuất bản (batchId từ display_publish), cho các đích (mặc định: các Takeover được xuất bản cho toàn bộ cơ sở), hoặc với allScreens cho mọi Takeover được xuất bản cho cơ sở, các màn hình hoặc nhóm của chúng. Takeover của thương hiệu và tổ chức chỉ dừng được bằng batchId. Màn hình quay lại nội dung theo lịch hoặc mặc định trong vài giây; trả về số Takeover đã dừng. Khi có nhiều màn hình, nhóm hoặc đích, công cụ sẽ tác động lên tất cả trong một lần gọi; hãy hỏi lại người dùng trước khi tác động lên nhiều mục.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
batchId | string | Lần xuất bản Takeover (bt_…) từ display_publish |
targets | object | Nơi nội dung được đưa đến. Có thể kết hợp bất kỳ mục nào sau đây. Có thể dùng tên nhóm thay cho ID. brand và organisation cần quyền truy cập Display Screens toàn tổ chức. |
allScreens | boolean | Mọi Takeover được xuất bản cho cơ sở, các màn hình hoặc nhóm của chúng |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
display_templated_writeMàn hình hiển thịĐiều khiển màn hình Templated content (chế độ hiển thị "Templated content" trong display_screens_read): tải chương trình tập luyện của một ngày lên màn hình, hoặc điều khiển bộ hẹn giờ vòng. Màn hình User managed content và màn hình trang web toàn trang không bao giờ bị ảnh hưởng.
Các hành động:
- load_program: Tải chương trình tập luyện. Tải chương trình tập luyện của một ngày (YYYY-MM-DD, mặc định hôm nay) từ nguồn dữ liệu của cơ sở lên mọi màn hình Templated content tại một hoặc nhiều cơ sở; màn hình tải lại trong vài giây. Dùng để hiển thị bài tập hôm nay hoặc của ngày khác, hoặc khi màn hình hiển thị sai bài. Nhiều cơ sở cần confirm. Có thể yêu cầu xác nhận.
- clock: Điều khiển bộ hẹn giờ vòng. Phát, tạm dừng, bắt đầu lại hoặc dừng bộ hẹn giờ vòng trên màn hình Templated content, tắt hoặc bật âm thanh vòng, đặt âm lượng chuông (setvolume với volume 0–100) hoặc hỏi trạng thái của bộ hẹn giờ. Cần Templated content tại cơ sở. Cần command.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "load_program" | "clock" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
facilityIds | array | Nhiều ID cơ sở, để chạy cùng một yêu cầu tại từng cơ sở. Dùng thay cho facilityId. (load_program) |
date | string | Ngày tập luyện, YYYY-MM-DD (mặc định hôm nay) (load_program) |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
command | "getstate" | "play" | "pause" | "restart" | "stop" | "mute" | "unmute" | "setvolume" | (clock) |
volume | integer | Với setvolume: âm lượng chuông, % (clock) |
confirm | boolean | Chỉ đặt sau khi người dùng đã xác nhận bản xem trước do lần gọi đầu tiên trả về |