Push-to-Talk (PTT) y comms

Las comms de ARGUS se construyen en torno a un widget PTT flotante anclado en la esquina inferior derecha de la consola de operación. Se sitúa sobre todos los tiles para que puedas transmitir desde cualquier vista.

Anatomía del widget

De arriba abajo, anclado al borde derecho de la consola:

1. Burbuja de transcripción — una tarjeta flotante translúcida que muestra la salida más reciente finalizada de speech-to-text. Aparece solo mientras el servicio de transcripción está en marcha. Las coincidencias de comandos de voz (ver comandos de voz) también aparecen aquí con una insignia de icono.
2. Insignia de comandante — un pequeño chip “COMMANDER”, mostrado solo si el usuario autenticado es el comandante de la misión. Puramente informativo — indica que tienes derecho a gestionar canales y operar la master caution.
3. Botón PTT — el botón grande y redondo que pulsas y mantienes para transmitir. Su estado visual refleja en qué fase están las comms:
   • Inactivo: icono mic, gris, etiqueta “PTT”.
   • Recibiendo (alguien más está hablando en uno de tus canales sintonizados): icono hearing, azul apagado, etiqueta “RX”, un anillo pulsante alrededor del botón.
   • Transmitiendo (estás manteniendo): icono graphic_eq, rojo, etiqueta “TX”, un anillo pulsante más brillante.
   • Bloqueado: el botón se vuelve gris si tu mic no tiene permiso — haz clic en el chip de estado de red para llegar a la ayuda de permisos del navegador.
4. Chip de canal — una pequeña pastilla que muestra el canal TX actual (p. ej. “TAC 1”) o “ALL” cuando no hay un canal TX específico elegido. Tócalo para abrir el panel de canales.

Pulsar para hablar

El PTT es solo puntero — pulsa y mantén el botón con ratón, pantalla táctil o lápiz. Suelta para dejar de transmitir.

• No hay atajo de barra espaciadora en la build actual. Mantener la barra espaciadora en el shell no transmite.
• Los eventos de release incluyen pointer-leave y pointer-cancel, así que si arrastras fuera del botón o el navegador roba el puntero (p. ej. cambias de ventana), la transmisión termina limpiamente.
• Puedes arrastrar hacia la región del botón para iniciar y soltar fuera — la transmisión comienza en pointerdown y termina en pointerup/pointercancel independientemente de dónde se haya movido el puntero.

El panel de canales

Haz clic en el chip de canal — el panel se abre como popover sobre el widget.

Canales de recepción

Cada canal que expone tu misión aparece en una lista con una casilla etiquetada Tune. Marcar un canal te suscribe a su audio; desmarcarlo lo silencia solo para ti (los demás lo siguen oyendo). Marcar varios canales a la vez significa que oirás el audio de cualquiera de ellos — el indicador RX se enciende siempre que alguien en un canal sintonizado esté transmitiendo.

Canal de transmisión

Elige un único canal del desplegable Transmit on. Tus pulsaciones PTT salen solo por ese canal. La opción predeterminada ALL transmite simultáneamente a cada canal que tengas sintonizado — útil para emisiones del comandante.

Comportamiento del gating de audio

Cuando conmutas Tune en un canal, ARGUS reevalúa inmediatamente el gating de audio entre todos los peers conectados para que empieces o dejes de oírlos en menos de un frame de render. Esto también aplica cuando un peer entra o sale a mitad de operación — la sintonización está siempre al día.

Crear y gestionar canales (solo comandante)

Los comandantes (y los admins de la organización) ven un botón Manage (icono tune) en la parte superior del panel de canales. Haz clic para abrir el diálogo Channels:

• Lista de canales existentes con nombre, ID y un icono de papelera para eliminar.
• Formulario New channel — escribe un nombre, haz clic en Add. El canal aparece para cada participante inmediatamente.
• Renombrar — haz clic en el nombre existente en línea para editar.

Los canales se almacenan en un documento de Firestore acotado a la misión. Su lista es reactiva, así que los no-comandantes ven los canales nuevos aparecer en su lista RX sin refrescar.

Quién ve qué: cada canal creado en la misión es visible para todos los participantes. Los canales “privados” (visibles solo para ciertos equipos) no están actualmente soportados.

Enrutamiento de audio

Los selectores de dispositivos de audio (mic / altavoz) no están actualmente expuestos en la consola de operación — ARGUS usa los dispositivos de entrada y salida predeterminados de tu navegador. Cámbialos en los permisos del sitio de tu navegador / el panel de sonido del SO. Un ticket de seguimiento rastrea la adición de selectores in-app para operadores que usan varios auriculares.

No hay audio-ducking (PTT entrante reduciendo el volumen del stream del dron). Si necesitas oír la radio sobre el video, baja manualmente el mute/volumen del stream del dron dentro del tile.

Qué hace el botón mic-mute

No hay un interruptor global de kill de micrófono en la build actual. Si necesitas silenciarte por completo, usa el mute a nivel de sistema operativo (la mayoría de auriculares tienen un interruptor de mute por hardware, y Windows/macOS tienen mute por teclado). Un kill-switch por software está en la hoja de ruta.

Transcripción + comandos de voz

Mientras la transcripción está habilitada para la operación, cada ráfaga PTT es transcrita por el agente en la nube. La burbuja de transcripción sobre el botón PTT muestra la última enunciación finalizada para una revisión rápida de lo que acabas de decir. El detector de comandos de voz lee el mismo stream y, cuando una frase reconocida coincide, emite un evento en línea que verás como una insignia de color en la burbuja.

Solución de problemas

• Nadie me oye — verifica que elegiste un canal TX (si muestra “ALL” estás emitiendo a todos los canales sintonizados, pero tus compañeros también deben estar sintonizados). Verifica también que el navegador tiene permiso de mic — el icono mic se vuelve gris con una barra roja si el permiso está denegado.
• Estoy en RX pero no suena audio — el dispositivo de salida del sistema está mal, o la pestaña del navegador está silenciada (busca el icono de altavoz silenciado en la franja de pestañas de tu navegador). Haz clic en el área principal de la consola para que el navegador pueda reproducir audio automáticamente.
• Todo suena robótico — pérdida de paquetes. El chip de estado de red en la barra superior parpadeará en ámbar; haz clic para ver el tiempo de ida y vuelta.
• Me falta la insignia de comandante — no eres el comandante de esta operación. Haz que el comandante actual te promueva en la página de detalle de misión.

Relacionado

• Tile de Comms — una vista a nivel de tile del registro de comms con historial completo de transcripción.
• Comandos de voz — las 17 frases reconocidas.
• Chat — canal de solo texto paralelo a la voz.