OSC

Адресное пространство OSC медиасервера; нормативный источник — контракт (osc/addresses.yaml, osc/legacy.yaml).

• UDP 7000 (OSC 1.0) — входящие; ответы и рассылки на адрес отправителя или replyPort (по умолчанию 7001); TCP 7000 со SLIP (OSC 1.1).
• {v} — площадка (_ = по умолчанию), {p} — плеер (_ = main).
• Аутентификации нет: у слушателя список разрешённых сетей ([osc] allow) и роль ([osc] role); адреса с пометкой admin CIDR — только из [osc] admin_allow. Остальные пакеты молча отбрасываются и учитываются в метрике.
• Пакеты с будущей временной меткой выполняются в указанное время (синхронный старт на нескольких узлах).
• Ошибки: /freedome/v1/error ,sss (код, описание, адрес). Подписки: /freedome/v1/subscribe ,s<топик> [,i<порт>].

Native (/freedome/v1)

Address	Dir	Args	Maps to	Scope
/freedome/v1/ping	in	s token?	ping	anon
/freedome/v1/info	in		getInfo	anon
/freedome/v1/subscribe	in	s topic i replyPort?	subscribe	events:subscribe
/freedome/v1/unsubscribe	in	s topic i replyPort?	unsubscribe	events:subscribe
/freedome/v1/venue/{v}/player/{p}/play	in	s id? i itemIndex? f position?	play	playback:control
/freedome/v1/venue/{v}/player/{p}/pause	in		pause	playback:control
/freedome/v1/venue/{v}/player/{p}/resume	in		resume	playback:control
/freedome/v1/venue/{v}/player/{p}/stop	in		stop	playback:control
/freedome/v1/venue/{v}/player/{p}/next	in		next	playback:control
/freedome/v1/venue/{v}/player/{p}/previous	in		previous	playback:control
/freedome/v1/venue/{v}/player/{p}/seek	in	f seconds	seek	playback:control
/freedome/v1/venue/{v}/player/{p}/rate	in	f rate	patchPlayer	playback:control
/freedome/v1/venue/{v}/player/{p}/loop	in	i loop	patchPlayer	playback:control
/freedome/v1/venue/{v}/player/{p}/volume	in	f volume	patchPlayer	playback:control
/freedome/v1/venue/{v}/output/brightness	in	f value	patchOutput	playback:control
/freedome/v1/venue/{v}/output/volume	in	f value	patchOutput	playback:control
/freedome/v1/venue/{v}/output/blackout	in	T	F True	patchOutput
/freedome/v1/venue/{v}/output/lighting	in	T	F True	patchOutput
/freedome/v1/venue/{v}/output/rotation	in	f degrees	patchOutput	playback:control
/freedome/v1/venue/{v}/cue/{c}/fire	in		fireCue	playback:control
/freedome/v1/venue/{v}/param/{path}	in	f	i	s
/freedome/v1/venue/{v}/display/{d}/pattern	in	s kind	setTestPattern	displays:control
/freedome/v1/venue/{v}/audio/master/gain	in	f gainDb	patchAudio	audio:control
/freedome/v1/venue/{v}/audio/zone/{z}/gain	in	f gainDb	patchAudioZone	audio:control
/freedome/v1/venue/{v}/audio/source/{id}/position	in	f azimuth f elevation f distance?	setSourcePosition	audio:control
/freedome/v1/engine/visual/backend	in	s backend	setComputeBackend	system:admin (admin CIDR)
/freedome/v1/event	out	s topic s json	event
/freedome/v1/venue/{v}/player/{p}/position	out	f position f duration	event
/freedome/v1/error	out	s code s detail s address	error

Legacy aliases (legacy profile only)

Address	Dir	Args	Maps to	Scope
/play	in	s mediaId	play	playback:control
/stop	in		stop	playback:control
/pause	in		pause	playback:control
/volume	in	f value	patchOutput	playback:control
/brightness	in	f value	patchOutput	playback:control
/rotation	in	f degrees	patchOutput	playback:control
/position	in	f seconds	seek	playback:control
/lighting	in	T	F True	patchOutput
/calibrate	in		startCalibrationJob	calibration:run (admin CIDR)
/freedome/play	in	s contentId?	play	playback:control
/freedome/stop	in		stop	playback:control
/freedome/status	in		getPlayer	playback:read
/freedome/capabilities	in		getInfo	anon
/freedome/render/single	in
/freedome/config/reload	in		getConfig	system:read (admin CIDR)
/freedome/backend/switch	in	s backend	setComputeBackend	system:admin (admin CIDR)
/freedome/backend/query	in		getEngine	info:read
/server/status	in		getHealth	anon
/server/subscribe	in	i replyPort?	subscribe	events:subscribe
/server/unsubscribe	in		unsubscribe	events:subscribe
/server/restart	in		restartEngine	system:admin (admin CIDR)
/server/shutdown	in		shutdownSystem	system:admin (admin CIDR)
/server/exit	in		rebootSystem	system:admin (admin CIDR)