📚 Documentación oficial

AOS Palace Virtual
Manual de Usuario

Sistema de streaming integrado para las sesiones del congreso. Conecta YouTube, gestiona las emisiones por sala y ofrece acceso en directo a los participantes inscritos.

v1.0.0 AOS Palace Core requerido AOS Program requerido WordPress 6.0+ PHP 7.4+
🗺
Visión General
Qué hace AOS Palace Virtual y cómo encaja en el ecosistema

AOS Palace Virtual añade al ecosistema AOS Palace la capacidad de emitir en directo las sesiones del congreso a través de YouTube. El plugin separa claramente dos responsabilidades: el realizador gestiona qué se emite y cuándo desde la Torre de Control, mientras que el técnico en sala conecta la señal de vídeo usando su herramienta habitual (OBS Studio u otro software de captura).

Las emisiones se muestran automáticamente en las salas del programa del congreso. Los participantes con inscripción confirmada acceden al directo desde su perfil sin necesidad de salir del sitio web.

🎬
Torre de Control
El realizador prepara, arranca y finaliza las emisiones de cada sala desde un panel centralizado.
🖥
Vista de Sala
El técnico en sala obtiene la URL del servidor y la clave de stream para configurar OBS o cualquier codificador RTMP.
📺
Emisión en Directo
Las sesiones en directo se muestran automáticamente en las salas del programa mediante un reproductor incrustado.
📼
Acceso Diferido
Una vez finalizada la emisión, la grabación queda disponible en la misma sala sin ninguna acción adicional.
🔒
Paywall de Acceso
Solo los participantes con inscripción confirmada o socios activos pueden ver el directo. Los demás ven un mensaje de acceso restringido.
Pantalla de Espera
Si la sala está preparada pero aún no ha empezado, los participantes ven una pantalla de espera que se refresca automáticamente.

Roles del sistema

ActorQué hace en AOS Virtual
AdministradorConfigura la conexión con YouTube, supervisa todas las emisiones y tiene acceso completo a la Torre de Control y la Vista de Sala.
RealizadorGestiona las emisiones desde la Torre de Control: prepara, arranca y finaliza las transmisiones por sala.
Técnico en salaAccede a la Vista de Sala para obtener las credenciales RTMP y configurar el software de captura.
Participante inscritoVe el directo o la grabación en la sala del programa desde su navegador.
📋
Requisitos
Dependencias y compatibilidad del plugin
ComponenteVersión mínimaNotas
WordPress6.0Se recomienda la última versión estable
PHP7.4Compatible con PHP 8.1 y 8.2
AOS Palace CoreActivo y con licenciaNecesario para la gestión de participantes y el control de acceso
AOS ProgramActivoNecesario para las salas del programa. Las salas se definen en AOS Program.
Cuenta GoogleCon acceso a YouTubeNecesaria para crear las emisiones. Debe tener habilitadas las emisiones en directo en YouTube.
Proyecto Google CloudAPI de YouTube habilitadaNecesario para obtener las credenciales OAuth (Client ID y Client Secret).
⚠️

La cuenta de YouTube asociada debe tener las emisiones en directo habilitadas. YouTube puede requerir un período de verificación de hasta 24 horas en cuentas nuevas antes de activar esta función.

ℹ️

AOS Palace Virtual conecta con YouTube únicamente a través del panel de administración de WordPress. En ningún momento expone las credenciales de la cuenta a los participantes o al frontend público.

Instalación
Proceso de instalación y puesta en marcha inicial
  1. Verifica las dependencias

    Confirma que AOS Palace Core y AOS Program están activos y con licencia válida antes de instalar AOS Palace Virtual.

  2. Sube e instala el plugin

    Ve a Plugins → Añadir nuevo → Subir plugin, selecciona el archivo .zip de AOS Palace Virtual y haz clic en Instalar ahora.

  3. Activa el plugin

    Haz clic en Activar. El sistema creará automáticamente la tabla de emisiones en la base de datos.

  4. Crea el proyecto en Google Cloud

    Accede a console.cloud.google.com, crea un nuevo proyecto, habilita la YouTube Data API v3 y crea unas credenciales de tipo OAuth 2.0 — Aplicación web. Anota el Client ID y el Client Secret.

  5. Configura la URI de redirección

    En la configuración de las credenciales OAuth de Google Cloud, añade como URI de redirección autorizada la URL que aparece en AOS Virtual → Ajustes bajo el apartado URI de redirección. Guarda los cambios en Google Cloud.

  6. Conecta YouTube desde AOS Virtual

    Ve a AOS Virtual → Ajustes, introduce el Client ID y el Client Secret y pulsa Conectar con YouTube. Serás redirigido a Google para autorizar el acceso. Al volver, el estado mostrará Conectado.

La instalación está completa cuando el menú AOS Virtual aparece en el escritorio de WordPress y el estado de la conexión con YouTube muestra Conectado.

🔑
Conectar YouTube
Configuración de la cuenta de YouTube para las emisiones

AOS Palace Virtual utiliza la autenticación oficial de Google para conectar con YouTube de forma segura. El proceso solo hay que realizarlo una vez. A partir de entonces, el sistema gestiona automáticamente la renovación de la conexión.

Flujo de conexión

1
Introduce las credenciales del proyecto
En AOS Virtual → Ajustes, pega el Client ID y el Client Secret obtenidos en Google Cloud Console y guarda.
2
Pulsa «Conectar con YouTube»
El sistema te redirige a la página de autorización de Google. Inicia sesión con la cuenta de YouTube que usarás para las emisiones.
3
Autoriza el acceso
Acepta los permisos necesarios para crear y gestionar emisiones en directo. Google devuelve al sistema un código de autorización.
4
Conexión establecida
El estado pasa a Conectado. El sistema gestiona automáticamente la renovación de la sesión antes de cada operación, sin necesidad de volver a conectar.
💡

Las credenciales de la conexión se guardan de forma segura en la base de datos del servidor y nunca se muestran en el frontend ni son accesibles para los participantes.

⚠️

Si revocas el acceso desde la configuración de tu cuenta de Google o cambias de cuenta de YouTube, tendrás que repetir el proceso de conexión.

🎬
Torre de Control
Panel del realizador para gestionar todas las emisiones

Accede en AOS Virtual → Torre de Control. Este es el panel principal del realizador. Muestra todas las salas del programa con su estado de emisión actual y permite controlar el ciclo completo de cada transmisión.

Preparar una emisión

Para iniciar una nueva transmisión en una sala, pulsa el botón Preparar junto a la sala correspondiente. El sistema crea automáticamente la emisión en YouTube y muestra el Modal RTMP con las credenciales para el técnico en sala.

ℹ️

El técnico en sala no necesita ver el Modal RTMP desde la Torre de Control. Puede acceder a sus credenciales en cualquier momento desde la Vista de Sala, de forma independiente.

Ciclo de una emisión

📋
Preparar
El realizador pulsa Preparar. El sistema crea la emisión en YouTube y genera la clave de stream para el técnico. La sala entra en estado Programada.
🔧
Prueba de señal
El técnico conecta OBS con la clave de stream y ajusta audio y vídeo. El realizador verifica la señal desde YouTube Studio. La sala está en estado Prueba.
🔴
EN AIRE
El realizador pulsa EN AIRE. La emisión se activa en YouTube y el reproductor aparece automáticamente en la sala del programa. Estado: En directo.
Finalizar
Al terminar la sesión, el realizador pulsa Finalizar. La emisión cierra en YouTube y la grabación queda disponible en la sala automáticamente. Estado: Completada.
⚠️

En el modo de prueba de licencia, los botones Preparar y EN AIRE están deshabilitados una vez alcanzado el límite de transmisiones permitidas. Consulta la sección Modo Trial para más información.

🖥
Vista de Sala
Panel del técnico para obtener las credenciales de streaming

Accede en AOS Virtual → Vista de Sala. Este panel está pensado para el técnico físico que se encuentra en la sala y necesita configurar su software de captura. Es completamente independiente de la Torre de Control y siempre accesible, incluso en modo trial.

Cómo usar la Vista de Sala

  1. Selecciona la sala

    En el selector de sala, elige la sala en la que estás trabajando. Aparecerán las credenciales de la emisión activa o preparada para esa sala.

  2. Copia las credenciales RTMP

    El panel muestra la URL del servidor RTMP y la Clave de stream. Usa los botones de copiar junto a cada campo para evitar errores de transcripción.

  3. Configura OBS Studio

    En OBS, ve a Ajustes → Emisión, selecciona Servicio personalizado, pega la URL del servidor y la clave de stream, y guarda. La guía rápida de OBS incluida en el panel muestra los pasos visuales.

  4. Inicia la transmisión en OBS

    Pulsa Iniciar transmisión en OBS. La señal llega a YouTube y el realizador puede verificarla desde YouTube Studio antes de dar la orden de salir al aire.

💡

Si se corta la conexión de OBS por cualquier motivo (caída de red, reinicio), puedes volver a conectar con la misma clave de stream sin necesidad de avisar al realizador. La clave no cambia durante toda la sesión.

📡
Estados de Emisión
Ciclo de vida de una transmisión y qué ve el participante en cada estado

Cada emisión pasa por los siguientes estados a lo largo de su ciclo de vida. El estado determina tanto lo que ve el realizador en la Torre de Control como lo que el participante ve en el programa del congreso.

⚪ Sin emisión
No hay ninguna emisión preparada para esta sala. El programa muestra el enlace de sala habitual de AOS Program.
📋 Programada
La emisión está creada en YouTube y la clave RTMP está lista. El participante ve una pantalla de espera que se actualiza automáticamente cada 30 segundos.
🔧 Prueba
El técnico está ajustando la señal. El participante sigue viendo la pantalla de espera con actualización automática.
🔴 En directo
La sesión está en emisión. El participante ve el reproductor de YouTube incrustado con reproducción automática.
✅ Completada
La emisión ha finalizado. El participante puede ver la grabación completa en el mismo reproductor incrustado.
🔗
Integración con el Programa
Cómo aparecen las emisiones en las salas del programa del congreso

AOS Palace Virtual se conecta automáticamente al programa del congreso. No es necesario configurar nada adicional una vez que el plugin está activo. Cada sala del programa mostrará su emisión correspondiente según el estado en que se encuentre.

Cómo funciona

Cuando un participante abre la vista de una sala en el programa del congreso, AOS Virtual comprueba si existe una emisión activa para esa sala en la edición en curso y sustituye el contenido habitual por el reproductor correspondiente:

Estado de la emisiónQué ve el participante en el programa
Programada o PruebaPantalla de espera con el nombre de la sala. Se refresca automáticamente cada 30 segundos.
En directoReproductor de YouTube incrustado con reproducción automática.
CompletadaReproductor de YouTube incrustado con la grabación completa de la sesión.
Sin emisiónEl enlace de sala original de AOS Program, sin modificación.
ℹ️

La integración con el programa funciona sala a sala. Puedes tener varias salas emitiendo simultáneamente, cada una de forma independiente.

👥
Acceso de Participantes
Quién puede ver las emisiones y bajo qué condiciones

AOS Palace Virtual aplica automáticamente un control de acceso sobre el reproductor de cada sala. El participante solo ve el reproductor si cumple una de estas condiciones:

🎫
Inscripción confirmada
El participante tiene una inscripción al congreso con pago confirmado en la edición activa.
🏅
Socio activo
El participante es socio activo y confirmado de la organización, independientemente de si tiene inscripción.

Si el participante no cumple ninguna de las condiciones anteriores o no ha iniciado sesión, en lugar del reproductor verá un mensaje indicando que el acceso requiere inscripción al congreso.

💡

El control de acceso se realiza siempre en el servidor. No es posible saltarlo manipulando el navegador.

🔒
Modo Trial
Limitaciones de la versión de prueba y cómo activar la licencia completa

AOS Palace Virtual incluye un modo de prueba que permite evaluar el sistema antes de activar la licencia completa. El modo trial aplica una única restricción sobre el número de transmisiones.

FunciónModo trialLicencia completa
Vista de SalaAcceso completoAcceso completo
Ajustes y OAuthAcceso completoAcceso completo
Transmisiones en totalMáximo 2Ilimitadas
Botón Preparar / EN AIREBloqueado tras 2 emisionesSiempre disponible
ℹ️

El contador del trial suma las transmisiones que han estado en directo o que han finalizado, independientemente de la sala o la edición del congreso. Las emisiones preparadas o en prueba que nunca salieron al aire no se contabilizan.

💡

Para activar la licencia completa, ve a AOS Palace → Extensiones, localiza AOS Palace Virtual y sigue el proceso de activación de licencia AOSYS.

📖
Glosario
Términos clave de AOS Palace Virtual
TérminoDefinición
Torre de ControlPanel de administración donde el realizador gestiona el ciclo completo de las emisiones: preparar, iniciar prueba, salir al aire y finalizar.
Vista de SalaPanel simplificado con las credenciales RTMP para que el técnico configure su software de captura en la sala física.
RealizadorPersona que controla las emisiones desde la Torre de Control. Coordina con el técnico en sala y decide cuándo cada sala sale al aire.
Técnico en salaPersona que conecta físicamente la señal de vídeo y audio en la sala. Configura OBS Studio u otro codificador con las credenciales RTMP.
RTMPProtocolo de transmisión de vídeo que usan OBS Studio y otros codificadores para enviar la señal al servidor de YouTube. Requiere una URL de servidor y una clave de stream.
Clave de streamContraseña de acceso al canal de YouTube para enviar la señal de vídeo. No debe compartirse con personas ajenas al equipo técnico. No cambia durante la sesión.
PaywallControl de acceso que impide ver el directo a participantes sin inscripción confirmada o sin estado de socio activo.
SalaEspacio físico o virtual del congreso definido en AOS Program. Cada sala puede tener una emisión activa independiente.
Acceso diferidoPosibilidad de ver la grabación de una sesión después de que la emisión haya finalizado. La grabación queda disponible automáticamente en la misma sala.
OAuthSistema de autorización de Google que permite a AOS Virtual gestionar emisiones en YouTube sin necesidad de conocer la contraseña de la cuenta.
TrialModo de prueba que permite realizar hasta 2 transmisiones completas antes de activar la licencia. Las funciones de configuración y la Vista de Sala son siempre accesibles.
Preguntas Frecuentes
Respuestas a los problemas más comunes

OBS está conectado pero el realizador no ve señal en YouTube Studio.

Verifica que la clave de stream introducida en OBS corresponde a la emisión activa para esa sala. Puedes comprobarlo en la Vista de Sala o en el Modal RTMP de la Torre de Control. Si la clave es correcta, comprueba que la resolución y el bitrate de OBS estén dentro de los límites recomendados por YouTube.

El reproductor no aparece en el programa aunque la sala está en directo.

Comprueba que el participante tiene sesión iniciada y cumple los requisitos de acceso (inscripción confirmada o socio activo). Si el acceso es correcto, verifica en la Torre de Control que el estado de la emisión es En directo y no Prueba, ya que en el estado de prueba el reproductor no se muestra al público.

Se cortó la conexión de OBS a mitad de la emisión. ¿Hay que reiniciar la emisión desde cero?

No. La clave de stream sigue siendo válida. Simplemente vuelve a pulsar Iniciar transmisión en OBS con las mismas credenciales. La emisión de YouTube se reanudará automáticamente. No es necesario avisar al realizador ni crear una nueva emisión.

¿Puedo emitir en varias salas a la vez?

Sí. Cada sala gestiona su propia emisión de forma completamente independiente. Puedes tener tantas salas emitiendo simultáneamente como necesites, siempre que la cuenta de YouTube lo permita y dispongas de la licencia completa.

La grabación no aparece en la sala después de finalizar la emisión.

YouTube puede tardar varios minutos en procesar la grabación tras finalizar el directo. Si transcurridos 15–20 minutos la grabación sigue sin aparecer, accede a YouTube Studio y verifica que el vídeo no está en estado privado o borrador.

¿Puedo usar una cuenta de YouTube diferente para distintas ediciones del congreso?

Sí. Para cambiar de cuenta, ve a AOS Virtual → Ajustes y pulsa Desconectar. A continuación, repite el proceso de conexión con la nueva cuenta. Las emisiones ya creadas con la cuenta anterior quedan registradas en el historial pero no son gestionables desde el nuevo canal.