Configuración de la API de Google y YouTube

Antes de conectar el plugin con YouTube, es necesario crear un proyecto en Google Cloud Console y obtener las credenciales OAuth 2.0[cite: 20]. Este proceso se realiza una sola vez[cite: 21].

2.1 Crear proyecto en Google Cloud Console

1. Accede a console.cloud.google.com con tu cuenta de Google[cite: 23].
2. Haz clic en el selector de proyectos (esquina superior izquierda) y selecciona "Nuevo Proyecto"[cite: 24].
3. Ponle un nombre descriptivo, por ejemplo: "AOS Congreso Streaming"[cite: 25].
4. Haz clic en "Crear" y espera a que el proyecto se active[cite: 26].

2.2 Activar la YouTube Data API v3

1. Dentro del proyecto, ve al menú "APIs y Servicios" > "Biblioteca"[cite: 28].
2. Busca "YouTube Data API v3" en el buscador[cite: 29].
3. Haz clic en el resultado y pulsa el botón "Habilitar"[cite: 30].
4. Espera a que la API quede en estado activo[cite: 31].

2.3 Crear credenciales OAuth 2.0

1. Ve a "APIs y Servicios" > "Credenciales"[cite: 34].
2. Haz clic en "+ Crear credenciales" > "ID de cliente OAuth 2.0"[cite: 35].
3. Si se te pide configurar la "Pantalla de Consentimiento OAuth", hazlo primero: elige "Externo", rellena el nombre de la app y el email de contacto, y guarda[cite: 36].
4. En tipo de aplicación selecciona "Aplicación Web"[cite: 37].
5. En el campo "Orígenes autorizados de JavaScript" no es necesario añadir nada[cite: 38].
6. En "URIs de redireccionamiento autorizados" añade exactamente esta URL (sustituye tu-dominio.com por el dominio real)[cite: 39]:

https://tu-dominio.com/wp-admin/admin.php?page=aos-palace-virtual-settings&tab=youtube [cite: 40]

Haz clic en "Crear"[cite: 41]. Se mostrará una ventana con el Client ID y el Client Secret[cite: 41]. Copia ambos valores[cite: 42]. Los necesitarás en el siguiente paso[cite: 42].

2.4 Modo de publicación de la app OAuth y YouTube Live

Por defecto, la app OAuth estará en modo "Pruebas"[cite: 45]. En este modo, solo los usuarios que añadas como "testers" pueden autenticarse[cite: 45]. Añade el email de la cuenta de YouTube como usuario de prueba[cite: 47]. Para publicación amplia o producción: pulsa "Publicar app" en la pantalla de consentimiento[cite: 48].

Activar Live Streaming: Accede a studio.youtube.com con la cuenta que usarás para transmitir[cite: 54]. Haz clic en "Crear" > "Transmitir en vivo"[cite: 55]. Si el canal nunca ha transmitido, YouTube pedirá verificar el número de teléfono[cite: 56]. La activación puede tardar hasta 24 horas[cite: 57].

Configuración recomendada en YouTube Studio [cite: 60]

Ajuste	Valor recomendado
Privacidad del broadcast [cite: 62]	No listado (acceso por enlace, no indexado en buscadores) [cite: 62]
Inicio automático [cite: 62]	Desactivado (el plugin controla el inicio) [cite: 62]
Fin automático [cite: 62]	Activado (el broadcast se cierra al detener la señal) [cite: 62]
Stream de monitorización [cite: 62]	Activado (permite verificar señal antes de emitir) [cite: 62]
Latencia [cite: 62]	Baja latencia para eventos en directo [cite: 62]

Instalación, Activación y Ajustes Generales

4. Instalación del Plugin

Ve a "Plugins" > "Añadir nuevo" > "Subir plugin" y sube el archivo aos-palace-virtual.zip[cite: 66, 67]. El plugin comprobará al activarse que AOS Palace Core está instalado y activo[cite: 71].

Para activar la licencia, ve a "AOS Virtual" > "Ajustes" > pestaña "Licencia"[cite: 74]. Introduce la clave y haz clic en "Activar licencia"[cite: 75, 76].

5. Conectar con YouTube (OAuth)

1. Ve a "AOS Virtual" > "Ajustes" > pestaña "YouTube OAuth"[cite: 82].
2. Pega el Client ID y el Client Secret obtenidos en Google Cloud Console[cite: 83, 84]. Haz clic en "Guardar Credenciales"[cite: 85].
3. Aparecerá el bloque "Estado de la Conexión"[cite: 87]. Haz clic en el botón "Conectar con YouTube"[cite: 88].
4. Se abrirá la pantalla de autorización de Google[cite: 89]. Selecciona la cuenta y haz clic en "Continuar"[cite: 89, 90].
5. Google redirigirá de vuelta al plugin y el estado cambiará a "Conectado a YouTube"[cite: 91].

6. Ajustes Generales y Paywall

Ve a "AOS Virtual" > "Ajustes" > pestaña "General"[cite: 97].

Ajuste	Descripción
Proveedor por defecto [cite: 98]	Motor de streaming a usar[cite: 98]. Actualmente disponible: YouTube Live[cite: 98]. Vimeo y AWS IVS disponibles en versiones futuras[cite: 98].
Paywall activo [cite: 98]	Si está activado, solo los usuarios con inscripción activa en AOS Palace Core pueden ver el streaming[cite: 98]. Recomendado para congresos de pago[cite: 98].
Mensaje del paywall [cite: 98]	Texto que se muestra a los usuarios sin acceso cuando intentan ver una sala de streaming[cite: 98]. Personalizable para cada congreso[cite: 98].

Cómo funciona el paywall: El plugin verifica la inscripción del usuario a través de la función aos_ev_get_participant_status() del Core, o bien el meta "aos_member_status" del usuario[cite: 99]. Si ninguno indica inscripción activa, se muestra el mensaje de paywall con un botón de acceso al login[cite: 99].

Torre de Control y Gestión Técnica

La Torre de Control es la vista principal del realizador[cite: 101]. Desde aquí se gestiona el ciclo de vida completo de cada transmisión: creación, prueba de señal, emisión en vivo y finalización[cite: 102]. Acceso: menú "AOS Virtual" > "Torre de Control"[cite: 103].

7.1 Vista general

Muestra una cuadrícula con todas las salas del congreso (obtenidas de la taxonomía "Salas / Ubicaciones" de AOS Program)[cite: 105]. Cada tarjeta muestra:

• Nombre de la sala y título de la emisión activa[cite: 107].
• Estado actual del broadcast con código de color[cite: 108].
• Indicador visual "SEÑAL EN VIVO" parpadeante cuando la emisión está activa[cite: 109].
• Enlace directo a YouTube para verificar el broadcast[cite: 111].

Estados del broadcast [cite: 112]

Estado	Significado
○ Sin emisión [cite: 113]	No hay broadcast creado para esta sala[cite: 113]. Acción disponible: Preparar[cite: 113].
◷ Programada [cite: 113]	Broadcast creado en YouTube[cite: 113]. OBS puede conectarse con la clave RTMP[cite: 113].
◎ En pruebas [cite: 113]	Señal de prueba activa[cite: 113]. Verificar en YouTube Studio que el vídeo llega correctamente[cite: 113].
● EN AIRE [cite: 113]	Emisión activa y visible para los participantes[cite: 113]. El iframe se muestra en el frontend[cite: 113].
✓ Finalizada [cite: 113]	Emisión concluida[cite: 113]. El VOD queda disponible en YouTube automáticamente[cite: 113].

7.3 Flujo completo de una emisión [cite: 114]

1. Preparar (realizador): El realizador pulsa "Preparar" en la sala correspondiente[cite: 115]. El plugin crea el broadcast en YouTube y devuelve la URL RTMP y la clave de stream[cite: 115]. Se muestra un modal con estos datos para el técnico[cite: 115].
2. Conectar OBS (técnico): El técnico accede a la Vista de Sala, selecciona su sala, copia la URL del servidor y la clave de stream, y las introduce en OBS Studio[cite: 115]. Pulsa "Iniciar emisión" en OBS[cite: 115].
3. Iniciar prueba de señal (realizador): El realizador pulsa "Iniciar prueba de señal"[cite: 115]. YouTube activa el modo de prueba[cite: 115]. El realizador verifica en YouTube Studio que la señal de vídeo llega con calidad correcta[cite: 115].
4. EN AIRE (realizador): Cuando la señal es satisfactoria, el realizador pulsa "EN AIRE"[cite: 115]. La emisión se hace visible para los participantes en el frontend del congreso[cite: 115].
5. Finalizar (realizador): Al terminar la sesión, el realizador pulsa "Finalizar"[cite: 115]. La emisión se detiene y el VOD queda disponible en YouTube automáticamente en pocos minutos[cite: 115].

Nota: Cada tarjeta activa tiene un botón de actualización (icono circular)[cite: 117]. Al pulsarlo, el plugin consulta el estado real en la API de YouTube y actualiza la vista si ha habido cambios[cite: 118].

8. Vista de Sala (Técnico)

Es una interfaz simplificada pensada para el técnico físico presente en cada sala del congreso[cite: 120]. Acceso: menú "AOS Virtual" > "Vista de Sala"[cite: 122]. Usa el desplegable para seleccionar la sala en la que estás trabajando y haz clic en "Ver datos de sala"[cite: 124, 125].

Mostrará los siguientes datos[cite: 128]:

• URL del Servidor (Ingest URL): Dirección del servidor RTMP de YouTube[cite: 129]. Ejemplo: rtmp://a.rtmp.youtube.com/live2[cite: 129].
• Clave de Stream (Stream Key): Clave única para este broadcast[cite: 129]. Mantenerla confidencial[cite: 129].

Guía rápida OBS Studio [cite: 133]

Abre OBS Studio > Configuración > Emisión[cite: 135]. Servicio: "Custom..." (Personalizado)[cite: 136]. Servidor: pega la URL del servidor[cite: 137]. Clave de emisión: pega la clave de stream[cite: 138]. Pulsa Aplicar > Aceptar[cite: 139]. Pulsa "Iniciar emisión" en OBS[cite: 140].

Experiencia del Participante y Troubleshooting

El plugin inyecta automáticamente el reproductor de streaming en las salas del programa del congreso, integrándose con AOS Program sin necesidad de configuración adicional[cite: 143].

9.1 Visualización según estado [cite: 144]

Estado del broadcast [cite: 145]	Lo que ve el participante [cite: 145]
Sin emisión [cite: 145]	El enlace habitual de la sala de AOS Program (sin cambios)[cite: 145].
Programada / En pruebas [cite: 145]	Pantalla de espera con mensaje y contador[cite: 145]. Se refresca automáticamente cada 30 segundos[cite: 145].
EN AIRE [cite: 145]	Reproductor de YouTube incrustado (iframe) con autoplay[cite: 145]. Ocupa el 100% del ancho[cite: 145].
Finalizada [cite: 145]	Reproductor VOD de YouTube con la grabación de la sesión[cite: 145].

Si el paywall está activado y el usuario no tiene acceso, ve un bloque con icono de candado, el mensaje personalizado y un botón de acceso al formulario de login/inscripción[cite: 147, 148, 149, 150].

10. Solución de Problemas [cite: 154]

• "The user is not enabled for live streaming": Este error aparece al preparar un broadcast cuando el canal de YouTube no tiene el live streaming habilitado[cite: 155, 156]. Solución: Accede a studio.youtube.com, ve a Crear > Transmitir en vivo y completa la verificación de teléfono[cite: 157]. Puede tardar hasta 24 horas[cite: 158].
• El estado de la conexión muestra "Sin conectar" tras autorizar: Puede ocurrir si hay un problema con el flujo OAuth[cite: 159, 160]. Verifica que la URI de redireccionamiento coincide exactamente con la URL en los ajustes[cite: 161]. Asegúrate de que la app OAuth no está en modo "Pruebas" sin tu email[cite: 162].
• No aparecen salas en la Torre de Control: Las salas se obtienen de la taxonomía "aos_location" de AOS Program[cite: 164, 165]. Verifica que AOS Program está activo[cite: 166]. Ve a AOS Program > Salas / Ubicaciones y comprueba que existen términos creados[cite: 167].
• OBS no consigue conectar con el servidor RTMP: Verifica que el broadcast está en estado "Programada" (no en "idle")[cite: 168, 169]. Comprueba que la URL del servidor y la clave de stream se copiaron completas[cite: 170]. Asegúrate de que el firewall no bloquea el puerto 1935 (RTMP)[cite: 171].

11. Soporte y Recursos [cite: 176]

• Documentación oficial: olbiasystem.com/docs/aos-palace-virtual/ [cite: 177]
• Soporte técnico: olbiasystem.com/soporte/ [cite: 177]
• Google Cloud Console: console.cloud.google.com [cite: 177]
• YouTube Studio: studio.youtube.com [cite: 177]
• OBS Studio: obsproject.com [cite: 177]

Puedes consultar las versiones instaladas del plugin, WordPress, PHP y el estado de la conexión con YouTube en la pestaña "Soporte" de los ajustes del plugin[cite: 178].