Abrir una sesión de voz
Abre un canal de voz para hablar en vivo por uno o varios parlantes de la sede. Los parlantes deben admitir audio bidireccional y la sede debe estar conectada.
- Llama a esta ruta con los parlantes en
serialsodeviceIds. - Con los datos de
talkback(url,roomNameytoken), conéctate a la sala de audio y publica el micrófono. - Al terminar, cierra la sesión con Cerrar una sesión de voz. Salir de la sala no la cierra; si no la cierras, se cierra sola a los 5 minutos.
Responde 200 si al menos un parlante quedó conectado; revisa results para ver cuáles fallaron.
IntegrationKeyX-Integration-Key<token>Tu clave de integración. Se crea en la consola de Fusehub, en Herramientas de desarrollo → API Keys.
site_id*Site IdCódigo de la sede.
application/json- body
serials?array<string>|Números de serie de los parlantes.
deviceIds?array<string>|Códigos de los parlantes en Fusehub. Se puede usar en lugar de serials o junto con él.
talkbackIdentity?|Nombre con el que el operador entra a la sala de audio. Si se omite, se genera uno.
Sesión abierta. Revisa results: puede que algunos parlantes no hayan quedado conectados.
application/json- response
ok?OktruetalkSessionId*TalksessionidCódigo de la sesión. Se usa para cerrarla.
talkback*results*array<>curl -X POST 'https://api.fusehub.lat/api/integration/v1/sites/string/speakers/talk/session' \ -H 'Content-Type: application/json' \ -d '{ "deviceIds": [], "serials": [ "SPK-ENTRADA", "SPK-PATIO" ], "talkbackIdentity": "operator_talk_1710000000000"}'{ "ok": true, "talkSessionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "talkback": { "url": "wss://livekit.example.com", "roomName": "site_00000000-0000-4000-8000-000000000044__talk_aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…", "identity": "operator_talk_1710000000000" }, "results": [ { "serial": "SPK-ENTRADA", "deviceId": "00000000-0000-4000-8000-000000000101", "name": "Parlante entrada", "ok": true }, { "serial": "SPK-PATIO", "deviceId": "00000000-0000-4000-8000-000000000102", "name": "Parlante patio", "ok": false, "error": "gateway_not_connected" } ]}Reproducir audio POST
Reproduce un audio en uno o varios parlantes de la sede. Para un audio del catálogo, envía JSON con `catalogAudioId` y los parlantes en `serials` o `deviceIds`. Para un audio propio que no se guarda, usa `type=recorded` y envía un formulario multipart con el archivo en `file` y los parlantes en `serials` o `deviceIds` como lista JSON. En ambos casos son opcionales `audioVolume` (por defecto 80) y `loopPlaybackTimes` (por defecto 1).
Cerrar una sesión de voz DELETE
Corta el audio en todos los parlantes de la sesión y libera el canal de voz. Si la sesión ya se cerró, responde 404.