Built-in system commands, product config items (config channel), and device-initiated event reports.
System Commands ({"system":...})
CommandNotes
{"system":"info"}System info (id/key/mode/bench/version...)
{"system":"network"}Network info {"type","mac","ip","mask","gateway","dns"}: type is the current link (wifi/ether); ip/mask/gateway/dns describe the active adapter (WiFi-only fields like channel/signal/ssid have no desktop/mobile API and are omitted)
{"system":"state"}Device attributes (empty {} when none registered)
{"system":"reg"}Re-register (after rebind/bench transfer)
{"system":"ntp"}Force time sync
{"system":"restart"}Acknowledged only, not executed (a Flutter app cannot restart itself)
{"system":{"host":"..."}}Switch server (takes effect on next connect)
{"system":"private"/"platform"}Private/platform mode switch (no self-restart; applies after a manual restart)
ble_* / wifi_* etc.Hardware network management commands are meaningless for a player — always answered as unsupported
Device Config Items (config channel)

The platform declares config items in the product definition; they are read/written over the config topic (same mechanism as the console settings page). Current items:

nameMeaningValues
autorunLaunch on boot0 / 1
restoreRestore display on launch (reopen areas with their content)0 / 1
layoutDisplay area layout (AreaLayout JSON)JSON
ctrlcodeControl code (credential for remotes without sign-in; empty = disabled)6 digits / empty
speech_engineSpeech engine: follow system / system / bundled offline engine"" / system / sherpa
speech_langSpeech languagesys / zh / en
speech_volumeSpeech volume0~100
speech_rateSpeech rate factor0.5~2.0
bgm_volumeBackground music volume0~100
bgm_duckAudio ducking while speakingno / 10 / 20 / 30 / pause
orientationDisplay orientation (phones/tablets only)system / landscape / portrait
localeOn-device UI languagesys / zh / en
  • Cloud writes (config/server) apply immediately and persist; cloud reads (fetch) return the device's live state
  • On-device local changes are published on the config topic as numeric values like {"autorun":1} (not the event topic)
  • New config items added to the product definition later appear in the website settings panel automatically — no code changes needed
Device Event Reports (event/client)

One event concerns one display area; simultaneous changes across areas produce multiple events.

nameWhendata
onlineConnected (SDK built-in){"name":"online","state":{...}}
offlineLast-will on disconnect (SDK built-in){"name":"offline"}
openArea window opened{"name":"open","area":"a6"}
closeArea window closed (incl. crash){"name":"close","area":"a6"}
changeLayout changed{"name":"change","area":"a6","data":[t,l,w,h,layer]}; data is [] on removal
contentArea content changed (send/clear/restore){"name":"content","data":{"area":"a6","type":"video"}}; type is an empty string when cleared
userPage reports via SS.report() (device-level rate limit 30/min){"name":"user","area":"a6","data":{...}}
customPage reports via the legacy superScreenEvent handler (kept for compatibility){"name":"custom","area":"a6","data":{...}}
toggleUser switched work mode locally (command-path switches only show in replies, no such event){"name":"toggle","data":{"mode":"console|screen|remote"}} (no area)

Connectivity has only online/offline (SDK mechanism; no boot/shutdown). Subscribe to these events via the Open Platform's message push (see the API book).