Sonidos

SVITRIX usa el buzzer pasivo integrado en el Ulanzi TC001 para reproducir melodías RTTTL monofónicas.

Gestor de Melodías

La interfaz web incluye un gestor completo de melodías en el Tab Sonido:

Melodías Guardadas

Lista de todas las melodías almacenadas en /MELODIES/:

• ▶ Reproducir — reproduce la melodía en el dispositivo
• ✎ Editar — carga la melodía en el editor RTTTL
• ✕ Eliminar — elimina la melodía del dispositivo

Editor RTTTL

Editor integrado para crear y editar melodías:

Campo	Descripción
Nombre	Nombre del archivo (sin extensión)
Contenido	Código RTTTL de la melodía

Botones:

• 🔊 Pre-escuchar — reproduce la melodía en tu navegador usando Web Audio API (no requiere dispositivo)
• ▶ Reproducir en dispositivo — envía la melodía al buzzer del Ulanzi
• Guardar — guarda la melodía en /MELODIES/

Subir Melodía

Sube archivos de melodía desde tu computadora:

1. Selecciona un archivo .txt o .rtttl
2. Vista previa del contenido
3. Pre-escuchar localmente antes de subir
4. Subir al dispositivo

Reproducir Melodías vía API

Puedes reproducir melodías RTTTL de dos formas:

Vía API: Envía la cadena RTTTL directamente con tu petición API. Ver documentación para comandos:

• Sonidos individuales
• Con tu notificación

Vía archivo: Este método evita payloads JSON largos ya que el buffer de recepción es limitado. Ve al administrador de archivos en la interfaz web y crea un nuevo archivo de texto en la carpeta MELODIES. Nómbralo como quieras pero usa la extensión .txt, ej. alarma.txt. Dentro del archivo, coloca una melodía en formato RTTTL. Cuando hagas referencia al archivo de sonido en llamadas API, omite la extensión del archivo.

Recursos de Melodías RTTTL

Puedes encontrar muchas melodías en internet:

• Laub-Home Wiki: RTTTL Songs
• Reproductor RTTTL Online
• Editor RTTTL

Control de Volumen

El volumen controla el ciclo de trabajo PWM del buzzer. Rango: 0–30 (por defecto: 25).

Menú en pantalla: Navega al elemento de menú VOLUME en el reloj. Usa los botones izquierdo/derecho para ajustar. Mantén presionado seleccionar para guardar.

Vía API:

# Establecer volumen a 15
curl -X POST http://<ip>/api/settings -d '{"VOL": 15}'

# Obtener volumen actual
curl http://<ip>/api/settings

La configuración de volumen se guarda en flash y persiste entre reinicios.

Alternar Sonido

El sonido puede habilitarse o deshabilitarse globalmente:

Menú en pantalla: Navega al elemento de menú SOUND. Alterna con los botones izquierdo/derecho. Mantén presionado seleccionar para guardar.

Vía API:

{"SOUND": true}

Cuando el sonido está deshabilitado, toda la reproducción de melodías (notificaciones, sonido de arranque, llamadas API) está silenciada. El nivel de volumen se preserva y restaura cuando el sonido se vuelve a habilitar.