Add commands verified from the official Loxone App V17 (Loxone Radio, loudness, queue ops, room favorites, events)

[mschlenstedt]

Summary

I decompiled the official Loxone App for Windows, version 17.1.2 (17482) (Electron bundle, resources/app.asar) and audited every AudioServer-related command it can send — both the new typed WebSocket API (app/scripts/AudioServer/datasource/parsing/v1_6/command/**, Zod schemas) and the Miniserver control command catalogue. This PR adds everything the App actually sends that was missing here, and documents how the App connects and which features are firmware-gated. Legacy Music-Server-(V1)-only commands were deliberately left out.

openapi.yaml

New endpoints

• Loxone Radio (firmware ≥ 17.0.0.0): documented the loxoneradio service on getservicefolder (user is always noUser, root folder start) and serviceplay
• audio/{zoneId}/loudness get/set (firmware ≥ 18.1.0.0)
• Queue operations: queueadd/{itemId}, queueinsert/{itemId}, queue/play/{id}, queue/remove/{id}, queue/move/{id}/before/{id}
• Room favorites management: roomfavs/{playerId}/add|delete|reorder|setname|setid|setplus, paginated getroomfavs/{playerId}/{offset}/{limit}
• geteq/{playerId}, seteq/{playerId}/{bands}, input/{inputId}/rename|type

Corrections / enrichments

• roomfavs/.../copy/...: the App sends the source zone first and supports comma-separated target zones (was documented the other way round)
• playlist/update: documented the edit-session protocol (start → additem:/addbrowsable:/moveById/removeById → finish/finishnochanges)
• volume/{value}: relative steps +n / -n
• Play commands: optional parentid/parentpath context segments (Spotify) and the ?q&{base64url("enforceUser=true")} suffix (PlayWithEnforcedUser, fw ≥ 15.5.01.13)
• radios/modify: optional basic-auth suffix (AuthenticatedCustomUrls, fw ≥ 17.0.0.0)
• dgroup/update and globalsearch: full parameter forms
• Note on cfg/input/{playerId}/{inputId}: the App selects line-ins via audio/{zoneId}/linein/{inputId}; cfg/input/… is used for configuration
• 10 additional WebSocket events (playlistchanged_event, reloadmusicapp_event, service_changed_event, customurl_changed_event, mastervolumechanged_event, usbchanged_event, restart_event, reboot_event, dialog_event, hw_event)

miniserver-api.yaml

• progress/{seconds} (seek), volstep (default step size), playzonefav/{favId} (lower-case variant used by the App's shortcut/NFC screens, addresses by item ID), roomfav/plus

README.md

• New chapter "How the official App connects to the AudioServer": connection order (P2P TLS via {ip-with-dashes}.{mac}.dyndns.loxonecloud.com:7091, plain ws://host:7091, Miniserver proxy /proxy/{uuidAction}/), subprotocol remotecontrol, and the getkey → secure/authenticate handshake re-using the Miniserver JWT
• New chapter "AudioServer feature gates": firmware version table (RecentlyPlayed … LoudnessSwitch) plus known service IDs
• Extended WebSocket event table
• Added the analysed App build to Sources: http://updatefiles.loxone.com/windows/Beta/171217482.exe

Verification

• Both YAML files parse cleanly (yaml.safe_load); openapi path count 117 → 135
• Every added command is backed by an actual call site in the App code (schema definitions in comps.js / AppHub.js, command assembly [command, ...params].join('/')), not just by constants — commands that are only defined but never sent were excluded (e.g. audio/cfg/airplay state GET); the one exception (roomfav/plus on the Miniserver path) is marked as "defined in the App's command catalogue"

🤖 Generated with Claude Code