# Eventos

Los **eventos** son acciones programadas que suenan de forma emergente: interrumpen la música brevemente, reproducen el audio, y la música se reanuda. Comparten el mismo formato `.com` que los comerciales.

## Archivos `.com` de eventos

Ruta: `~/.gradio/data/eventos/<hora>/<minuto>.com`

- Mismo formato que comerciales: `/ruta/audio.mp3|máscara_días|fecha_inicio|fecha_fin`
- Ejemplo: `~/.gradio/data/eventos/12/0.com` = evento del mediodía

## Cola activa `eventoslist`

`~/.gradio/data/tmp/eventoslist` — lista de rutas que el player procesará como evento emergente.

El player detecta cuando esta cola tiene contenido y la procesa de inmediato (interrumpe brevemente la música).

## Diferencia entre Comerciales, Eventos y Eventos-en-Espera

| Aspecto | Comerciales | Eventos | Eventos-en-Espera |
|---------|-------------|---------|-------------------|
| Directorio | `data/comerciales/` | `data/eventos/` | `data/eventos-espera/` |
| Cola activa | `tmp/comercialeslist4` | `tmp/eventoslist` | `tmp/eventos-esperalist` |
| Típico uso | Publicidad programada | Cuñas institucionales, separadores | Acciones espontáneas del operador |
| Scheduler | `comercial-scheduler` | `comercial-scheduler` | `comercial-scheduler` |

## Comandos útiles

```bash
# Ver eventos programados para hoy a las 12:00
cat ~/.gradio/data/eventos/12/0.com

# Ver cola activa de eventos
cat ~/.gradio/data/tmp/eventoslist

# Disparar un evento inmediatamente (reproducir ahora)
echo "/ruta/cuña.mp3" > ~/.gradio/data/tmp/eventoslist

# Agregar evento al mediodía todos los días
mkdir -p ~/.gradio/data/eventos/12
echo "/ruta/cuña_mediodia.mp3|1234567|20250101|20261231" >> ~/.gradio/data/eventos/12/0.com

# Vaciar la cola activa de eventos
> ~/.gradio/data/tmp/eventoslist

# Ver estado general del sistema (incluye num_eventos)
cat ~/.gradio/data/tmp/estado.json | python3 -c "import sys,json; d=json.load(sys.stdin); print('Eventos en cola:', d['num_eventos'])"
```

## Estado en `estado.json`

El campo `eventos_activos` indica si hay un evento reproduciéndose ahora mismo. `num_eventos` muestra cuántos hay en cola.

# Eventos en Espera

Los **eventos en espera** son acciones programadas que el operador prepara con antelación para disparar cuando lo decida, o que el scheduler carga automáticamente. Son el equivalente de una "lista de espera" de efectos.

## Archivos `.com`

Ruta: `~/.gradio/data/eventos-espera/<hora>/<minuto>.com`

- Mismo formato que comerciales y eventos: `/ruta/audio.mp3|máscara_días|fecha_inicio|fecha_fin`
- Ejemplo: `~/.gradio/data/eventos-espera/9/30.com` = evento en espera a las 9:30

## Cola activa `eventos-esperalist`

`~/.gradio/data/tmp/eventos-esperalist` — lista de rutas pendientes en espera.

El player la monitorea: cuando tiene contenido, lo reproduce en modo emergente (igual que `eventoslist`).

## Uso típico

Los eventos en espera se usan para:
- Anuncios de noticias que salen al aire cuando el operador decide
- Efectos especiales cargados con antelación
- Separadores y cortinas que se reproducen bajo demanda

## Comandos útiles

```bash
# Ver cola de eventos en espera
cat ~/.gradio/data/tmp/eventos-esperalist

# Poner un audio en la cola de espera (listo para reproducir)
echo "/ruta/noticia_urgente.mp3" > ~/.gradio/data/tmp/eventos-esperalist

# Agregar sin borrar los anteriores
echo "/ruta/efecto.mp3" >> ~/.gradio/data/tmp/eventos-esperalist

# Vaciar la cola de espera
> ~/.gradio/data/tmp/eventos-esperalist

# Programar evento en espera para las 10:30 todos los lunes-viernes
mkdir -p ~/.gradio/data/eventos-espera/10
echo "/ruta/noticia.mp3|12345|20250601|20251231" >> ~/.gradio/data/eventos-espera/10/30.com

# Estado: cuántos hay en la cola de espera
cat ~/.gradio/data/tmp/estado.json | python3 -c "import sys,json; d=json.load(sys.stdin); print('En espera:', d['num_eventos_espera'])"
```

## Resumen de las tres colas

```bash
# Ver el estado de todas las colas a la vez
echo "=== MÚSICA (playlist4) ==="
wc -l ~/.gradio/data/tmp/playlist4
echo "=== COMERCIALES activos ==="
cat ~/.gradio/data/tmp/comercialeslist4
echo "=== EVENTOS activos ==="
cat ~/.gradio/data/tmp/eventoslist
echo "=== EVENTOS EN ESPERA ==="
cat ~/.gradio/data/tmp/eventos-esperalist
```
