AudioBot permite reproducir audio en un canal de TeamTalk y controlarlo mediante mensajes de texto. En esta guía de MCVHost aprenderás a llevarlo a tu canal, buscar contenido, reproducir enlaces y controlar la reproducción.

AudioBot se encuentra actualmente en fase beta.

Algunas funciones pueden cambiar, presentar errores o dejar de funcionar temporalmente si los servicios externos utilizados por el bot modifican su funcionamiento. Si encuentras un problema, puedes comunicarlo al soporte de MCVHost indicando qué intentabas hacer y, si aparece, el mensaje de error recibido.

Requisitos y limitaciones

Para utilizar AudioBot necesitas:

• Acceso a un servidor TeamTalk donde el bot pueda conectarse.
• Permiso para enviar mensajes privados al bot.
• Permiso para entrar al canal donde quieras utilizarlo.
• Si el canal tiene contraseña, conocerla para proporcionársela al bot cuando la solicite.

AudioBot no puede entrar en canales para los que no tenga permisos suficientes.

La reproducción de enlaces depende de que el contenido sea accesible y de que el bot pueda obtener y decodificar su audio. Algunos sitios pueden requerir autenticación, tener restricciones geográficas, bloquear herramientas automatizadas o cambiar su funcionamiento sin previo aviso.

Primeros pasos

1. Conéctate al servidor de TeamTalk donde está disponible el bot.
2. Entra en el canal donde quieres escuchar el audio.
3. Localiza al bot en la lista de usuarios y abre una conversación privada con él. Su nombre depende de la configuración de la instancia. Si no sabes cuál es, consulta la información de tu AudioBot en el panel de MCVHost.
4. Envía ven para que intente unirse a tu canal.
5. Comprueba que el bot aparece en ese canal antes de comenzar la reproducción.

Si el canal tiene contraseña, el bot te la pedirá por privado. Responde en esa misma conversación con la contraseña del canal.

Para escuchar el audio, debes estar en el mismo canal que el bot. La reproducción se emite en el canal donde está el bot y la comparten los participantes que puedan recibir su audio.

Los mensajes privados pueden enviarse desde otro canal. Sin embargo, enviar una orden de reproducción no hace que el bot se traslade: para llevarlo a tu canal, usa ven.

Cómo enviar los comandos

Envía cada comando como un mensaje privado dirigido al bot. No necesitas añadir una barra ni otro prefijo. Escribe los comandos en minúsculas, tal como aparecen en los ejemplos.

Los comandos de reproducción, búsqueda, volumen y traslado no se procesan desde el chat del canal. Aunque el bot puede responder a ping fuera del privado, utiliza la conversación privada para seguir esta guía.

| Mensaje | Función | | --- | --- | | ayuda o help | Muestra los comandos disponibles. | | ping | Comprueba si el bot responde. La respuesta es pong. | | ven | Solicita que el bot se una al canal donde estás. | | busca texto | Inicia una búsqueda del texto indicado y permite elegir el servicio. | | reproduce URL | Intenta reproducir el audio del enlace indicado. | | Un enlace que empiece por http:// o https:// | Intenta reproducirlo directamente, sin escribir reproduce. | | volumen | Consulta el volumen actual del bot. | | volumen 50 | Ajusta el volumen del bot al 50 %. Acepta valores de 0 a 100. | | parar | Detiene la reproducción. |

Buscar contenido y reproducirlo

Para buscar, envía un mensaje como este:

text busca jazz instrumental

El bot te pedirá que elijas dónde buscar:

text 1. YouTube. 2. Audiocinemateca.

Responde con 1 para buscar en YouTube o con 2 para buscar en Audiocinemateca.

Configurar Audiocinemateca

Para utilizar Audiocinemateca, tu instancia de AudioBot debe tener configuradas las credenciales correspondientes.

Puedes proporcionarlas al ordenar el servicio o modificarlas posteriormente desde la tabla de robots en el panel de MCVHost.

Si las credenciales no están configuradas o dejan de ser válidas, las búsquedas mediante Audiocinemateca no estarán disponibles hasta que actualices la configuración.

Seleccionar un resultado

Después de realizar la búsqueda, recibirás una lista numerada de resultados. Envía el número del resultado que quieras escuchar. Por ejemplo:

text 3

selecciona el tercer resultado de esa lista.

El significado de un número depende del paso en el que te encuentres: primero sirve para elegir el servicio y después para elegir un resultado. Envía únicamente el número, sin puntos ni palabras adicionales.

Al iniciar una reproducción, el bot publica un aviso en el canal y actualiza su estado con el título o el enlace del contenido.

Reproducir un enlace

Si ya tienes un enlace, puedes enviarlo por privado con el comando reproduce seguido de un espacio y la URL completa:

text reproduce https://ejemplo.com/audio

También puedes enviar únicamente la URL:

text https://ejemplo.com/audio

AudioBot intentará obtener el audio automáticamente.

Tipos de enlaces compatibles

AudioBot puede intentar reproducir diferentes tipos de contenido, entre ellos:

• Enlaces de YouTube.
• Streams de audio directos.
• Archivos de audio accesibles mediante HTTP o HTTPS.
• Enlaces de vídeo de servicios compatibles de los que sea posible extraer el audio.

No todos los enlaces son necesariamente compatibles.

Un sitio puede impedir la reproducción si requiere inicio de sesión, utiliza protección contra acceso automatizado, aplica restricciones geográficas o cambia el formato con el que entrega su contenido.

Si un enlace no funciona, prueba con otro contenido o consulta la sección de solución de problemas de esta guía.

Iniciar una nueva reproducción

Cada instancia de AudioBot reproduce un contenido a la vez.

Si inicias una nueva reproducción mientras otra está activa, el comportamiento dependerá de la versión y configuración actual del servicio. En general, considera que los controles del bot afectan a la reproducción compartida de esa instancia.

Si varias personas utilizan el mismo AudioBot, coordinen las órdenes para evitar interrumpirse entre sí.

Estado del bot

Mientras reproduce contenido, AudioBot puede mostrar en su estado el título o el enlace actualmente en reproducción.

Esto permite identificar qué está reproduciendo sin necesidad de abrir la conversación privada con el bot.

El estado se actualiza automáticamente cuando comienza una nueva reproducción.

Ajustar el volumen y detener el audio

Para consultar el volumen actual del bot, envía:

text volumen

Para cambiarlo, añade un valor entre 0 y 100:

text volumen 50

Este ajuste modifica el audio que emite el bot y afecta a todas las personas que lo escuchan.

Si sólo quieres cambiar cómo lo oyes tú, utiliza los controles de volumen de tu cliente de TeamTalk.

Para detener la reproducción, envía:

text parar

Controles compartidos

Los comandos enviados a AudioBot modifican el estado compartido de esa instancia.

No son controles personales.

Por ejemplo:

• Cambiar el volumen afecta a todos los usuarios que estén escuchando al bot.
• Detener la reproducción detiene el audio para todos.
• Iniciar otro contenido puede modificar o sustituir la reproducción actual.
• Trasladar el bot con ven cambia el canal donde se escucha el audio.

Ten esto en cuenta cuando varias personas compartan la misma instancia.

Uso compartido del bot

Cada instancia del bot reproduce en el canal donde se encuentra. Si otra persona lo llama con ven, puede trasladarlo a otro canal.

Los controles no están reservados a la persona que inició la reproducción: otros usuarios que puedan enviarle mensajes privados también pueden solicitar cambios de volumen, detener el audio o llamar al bot.

Las búsquedas y las selecciones pendientes también se comparten dentro de la misma instancia.

Si dos personas buscan al mismo tiempo, una búsqueda puede reemplazar la lista de la otra. Para evitar seleccionar contenido equivocado, coordinen las búsquedas y completen una selección antes de iniciar la siguiente.

Privacidad y contenido externo

AudioBot necesita comunicarse con servicios externos para buscar o reproducir determinados contenidos.

Los términos de búsqueda, enlaces y otros datos necesarios para completar una solicitud pueden ser enviados a esos servicios.

No envíes mediante AudioBot:

• Contraseñas que no sean necesarias para entrar en un canal de TeamTalk.
• Tokens de acceso.
• Cookies.
• Enlaces privados sensibles.
• Credenciales de otros servicios.
• Información que no quieras que sea procesada por servicios externos.

Las credenciales de Audiocinemateca deben configurarse únicamente mediante las opciones proporcionadas por MCVHost para tu instancia.

Si algo no funciona

El bot no responde

Envía:

text ping

por privado.

Si no recibes pong, comprueba que el bot esté conectado y que puedas enviarle mensajes privados.

Para el resto de los comandos, verifica que estés escribiendo en la conversación privada con el bot y que uses el formato indicado en esta guía.

El bot responde, pero no escucho el audio

Comprueba que tú y el bot estén en el mismo canal.

Si está en otro, entra en el canal deseado y envíale:

text ven

Verifica también:

• Que el volumen del bot sea mayor que cero.
• Que tu cliente de TeamTalk permita recibir su audio.
• Que no tengas al bot silenciado localmente.
• Que el contenido haya comenzado correctamente.

El bot dice que se ha unido, pero no aparece en mi canal

Comprueba su ubicación en la lista de usuarios.

El mensaje de respuesta puede aparecer antes de que el servidor confirme completamente la entrada al canal.

Si no llega a unirse, revisa:

• La contraseña del canal.
• Los permisos de acceso.
• Los límites o restricciones configurados por la administración del servidor.

Audiocinemateca no aparece o no funciona

Comprueba que tu instancia tenga configuradas las credenciales de Audiocinemateca.

Puedes revisarlas o modificarlas desde la tabla de robots en el panel de MCVHost.

Si las credenciales son incorrectas, han caducado o el servicio no está disponible, las búsquedas mediante Audiocinemateca pueden fallar.

La búsqueda o el enlace fallan

Prueba con otro término o enlace.

Si el bot informa de un error de descarga, extracción o decodificación, comunica al soporte de MCVHost:

• El enlace o término que intentabas utilizar.
• El mensaje de error recibido.
• El nombre o identificador de tu instancia, si corresponde.

Debido a que AudioBot está en fase beta y depende de servicios externos, algunos sitios pueden dejar de funcionar temporalmente aunque anteriormente fueran compatibles.

Un número reproduce algo distinto de lo esperado

Otra persona puede haber iniciado una búsqueda en la misma instancia.

Envía de nuevo:

text busca texto

espera la nueva lista y selecciona el resultado cuando nadie más esté realizando otra búsqueda.

Referencia rápida

| Comando | Acción | | --- | --- | | ayuda | Muestra la ayuda. | | help | Muestra la ayuda. | | ping | Comprueba si el bot está respondiendo. | | ven | Lleva el bot a tu canal. | | busca texto | Busca contenido. | | reproduce URL | Reproduce un enlace. | | https://... | Intenta reproducir directamente el enlace. | | volumen | Consulta el volumen actual. | | volumen 0-100 | Cambia el volumen. | | parar | Detiene la reproducción. |