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
-
Crea el control “Input Source” en tu diseño.
-
-
Asocia la URI Correspondiente en el campo “Fuente“.
-
HDMI 1 →
ext://hdmi:1 -
HDMI 2 →
ext://hdmi:2 -
HDMI 3 →
ext://hdmi: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