🎓¿Cómo mostrar en pantallas WebOS una fuente externa de video usando el control de Input Source?

Este documento explica cómo configurar y utilizar un control personalizado llamado “Input Source” en webOS para seleccionar la entrada HDMI correcta. La clave es especificar la fuente indicando el puerto HDMI al que está conectada (p. ej., HDMI 1, HDMI 2). La sintaxis del valor de la fuente utiliza el esquema ext:// con el formato ext://hdmi:{numero de puerto}. Ejemplo: ext://hdmi:1.

Cuándo usar este control

  • Al diseñar una UI personalizada que permita cambiar entre distintas entradas físicas (HDMI 1, HDMI 2, etc.).

  • Para garantizar que el televisor/webOS apunte exactamente al puerto HDMI donde está conectada la fuente externa (decodificador, consola, reproductor).

Formato de la fuente (URI de entrada)

El valor de la fuente debe seguir estrictamente este formato:

ext://hdmi:{numero de puerto}

  • El prefijo es fijo: ext://hdmi:

  • El número de puerto es un entero positivo que corresponde al puerto HDMI físico rotulado en el televisor (1, 2, 3, …).

  • Ejemplos válidos: ext://hdmi:1, ext://hdmi:2, ext://hdmi:3

Pasos de configuración en tu UI personalizada

  1. Crea el control “Input Source” en tu diseño.

    • imagen (1).png


  2. Asocia la URI Correspondiente en el campo “Fuente“.

    • HDMI 1 → ext://hdmi:1

    • HDMI 2 → ext://hdmi:2

    • HDMI 3 → ext://hdmi:3

      imagen (2).png
  3. Valida la selección del usuario antes de aplicarla.

    • Comprueba que el número de puerto es válido y existe en el dispositivo.

    • Evita valores vacíos o formatos distintos al especificado.

Buenas prácticas

  • Mostrar claramente el nombre visible (HDMI 1, HDMI 2) y mapearlo 1:1 al URI correspondiente.

  • Validar el formato del URI antes de enviarlo al sistema.

Ejemplos de uso

Selección directa por botones:

  • Botón “HDMI 1” → emite ext://hdmi:1

  • Botón “HDMI 2” → emite ext://hdmi:2

Selector desplegable:

  • Opción “HDMI 3” → valor asociado ext://hdmi:3

Preguntas frecuentes

¿Puedo usar puertos no HDMI (por ejemplo, AV o componentes)?

Esta guía cubre específicamente entradas HDMI con el esquema ext://hdmi:. Para otros tipos de entradas, consulta la documentación de tu plataforma/webOS para identificar el esquema correcto y su disponibilidad.

¿El número del puerto siempre coincide con la serigrafía del TV?

Sí, utiliza el número físico rotulado en el televisor (HDMI 1, HDMI 2, etc.) y mapea ese número en el URI (p. ej., ext://hdmi:1).

¿Qué debo hacer si el cambio de entrada no surte efecto?
  • Verifica el formato del URI (prefijo y número de puerto).

  • Asegura que el dispositivo externo esté encendido y conectado al puerto correcto.

  • Reintenta la acción y revisa los logs de la aplicación para detectar errores de integración.