Este artículo explica cómo usar la Configuración Local con EloView® WebApps y WebViewController (WVC) para aplicar configuraciones avanzadas del navegador y quiosco directamente en un dispositivo Elo Android.

La Configuración Local permite que WebViewController (WVC) use configuraciones almacenadas localmente en un dispositivo Elo Android cuando se inicia WVC. Estas configuraciones pueden proporcionar opciones de configuración adicionales más allá de las disponibles a través del portal EloView.

Descripción General

WebViewController puede recibir información de configuración de dos maneras:

1. Archivo de configuración local – WVC lee un archivo de configuración soportado almacenado en el directorio raíz /sdcard/ en el dispositivo.
2. Intenciones de Android – Una aplicación personalizada de Android puede iniciar WVC y proporcionar información de configuración programáticamente.

El extra de intención Booleana readLocalConfig determina si WebViewController intenta usar un archivo de configuración local en lugar de las configuraciones de intención de launchContentSetting.

Antes de Comenzar

Habilitar Configuración Local en EloView

Al configurar el contenido de WebApp en EloView, habilita Configuración Local desde las propiedades del contenido:

1. En el portal de EloView, abre el ítem de contenido WebApp correspondiente.
2. Navega a Detalles de Contenido > Propiedades de Contenido.
3. Bajo Configuraciones del Navegador, localiza Configuración Local.
4. Establece Configuración Local en Habilitado (Activo).
5. Guarda o aplica la configuración.

Crear y Colocar el Archivo de Configuración Local

WebViewController soporta archivos de configuración en propiedades de Java y JSON. Coloca el archivo de configuración directamente en el directorio raíz /sdcard/ usando uno de los nombres de archivo soportados a continuación.

Configuraciones de WebViewController

La Configuración Local soporta una variedad de configuraciones de WebViewController. Los valores booleanos usan true o false. Los valores de cadena están entre comillas en JSON y se ingresan como valores de texto en un archivo de propiedades de Java.

Configuraciones del Navegador y Sesión

Configuraciones de la Barra de Navegación

Configuraciones de la Barra de Acción

Configuraciones de PDF

Ejemplo de Configuración JSON

El siguiente ejemplo abreviado demuestra la estructura de un archivo wvc_config.json. Selecciona solo las configuraciones y valores apropiados para tu implementación.

{
  "contentpath": "https://example.com",
  "viewMode": "Full View",
  "layerType": "HW",
  "pinchZoom": true,
  "homePageTimeout": "0",
  "showNavBar": true,
  "pdfSupport": true
}

Guarda el archivo usando uno de los nombres de archivo soportados directamente bajo /sdcard/. Al usar un archivo de configuración local, inicia WebViewController con readLocalConfig establecido en true.

Configurar WebViewController Usando Intenciones de Android

WebViewController también puede ser lanzado y configurado programáticamente a través de Intenciones de Android. Esto proporciona una alternativa al uso de un archivo de configuración almacenado en el dispositivo.

Por ejemplo, después de que WebViewController ha sido instalado, una aplicación personalizada de agente del dispositivo puede enviar las Intenciones apropiadas para controlar WVC como parte del flujo de trabajo del dispositivo.

Solución de Problemas

Lista de Verificación para la Configuración de Configuración Local

1. Identifica solo las configuraciones de WebViewController requeridas para la implementación.
2. Crea un archivo de configuración JSON o en propiedades de Java válido usando los nombres de configuración documentados y tipos de valor.
3. Guarda el archivo usando uno de los nombres de archivo soportados.
4. Copia el archivo directamente en la raíz /sdcard/ en el dispositivo Elo Android físico.
5. Habilita Configuración Local para la WebApp aplicable en EloView.
6. Al lanzar WVC usando un archivo de configuración local, establece readLocalConfig en true.
7. Para control programático, instala primero WebViewController y luego haz que la aplicación del agente del dispositivo envíe las Intenciones de Android apropiadas.
8. Prueba la configuración en el dispositivo de destino y confirma que WebViewController se comporte como se espera.