Adaptadores de Fuente
El parámetro source controla cómo el reproductor resuelve su URL de audio. Cuando se omite, el tipo de fuente se auto-detecta desde la URL src.
Local (predeterminado)
Reproduce la URL tal cual. Para enlaces directos de archivos de audio o recursos locales de Hugo.
AzuraCast
Obtiene la API nowplaying de AzuraCast para descubrir la URL del stream y enriquece el reproductor con metadatos de la canción actual.
Requiere el atributo data-azuracast-api-url:
Si se proporciona src junto con source="azuracast", se usa directamente sin consultar la API.
Auto-detección: se activa cuando la URL contiene azuracast o .stream..
iVoox
Obtiene la página del episodio de iVoox y extrae la URL de audio de:
- Meta propiedad
og:audio - Atributo
data-audio-url - Elemento
<audio><source>
Si falla la obtención, usa la URL src tal cual como respaldo.
Auto-detección: se activa cuando la URL contiene ivoox.com.
API de Eventos JavaScript
El componente emite eventos personalizados que burbujean a través del DOM. Escucha en cualquier elemento <podcast-player> o <podcast-footer>:
Referencia de Eventos
| Evento | Se emite en | Carga útil |
|---|---|---|
player-state | play, pause, seek | { paused, src, currentTime, duration } |
podcast-play | play (compat) | { src, title, url } |
podcast-pause | pause | { src } |
podcast-close | botón cerrar del pie | { src } |
podcast-seek | seek en cualquier reproductor | { src, currentTime } |
Persistencia en sessionStorage
El estado se guarda por fuente en sessionStorage usando el formato de clave:
Esto significa que múltiples reproductores en la misma página usan claves separadas y no interfieren entre sí.
Comportamiento entre Páginas
- Navegar fuera de una página pausa el audio en línea (guarda posición)
- Volver a una página no reproduce automáticamente: el reproductor se restaura en estado pausado
- El reproductor de pie persiste en todas las páginas sin interrupción
Atajos de Teclado
| Tecla | Acción |
|---|---|
Espacio | Alternar reproducir/pausa |
Flecha Izquierda | Retroceder 15 segundos |
Flecha Derecha | Adelantar 15 segundos |
M | Alternar silencio |
Funciona tanto en el reproductor en línea como en el de pie cuando el reproductor tiene el foco.
API Media Session
Wavecast se integra con la API Media Session, lo que significa:
- Los controles de reproducir/pausa aparecen en las pantallas de bloqueo y centros de notificación
- El título de la pista y la portada se muestran en los controles multimedia del sistema
- Las teclas multimedia de hardware (auriculares, teclado) controlan la reproducción
Esto es automático: no requiere configuración.