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

La Configuración Local permite que el WebViewController (WVC) utilice configuraciones almacenadas localmente en un dispositivo Android de Elo cuando se inicia WVC. Estas configuraciones pueden proporcionar opciones de configuración adicionales más allá de las disponibles a través del portal de 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 compatible almacenado en el directorio raíz /sdcard/ en el dispositivo.
2. Intenciones de Android – Una aplicación de Android personalizada puede iniciar WVC y proporcionar información de configuración de forma programática.

El extra de Intent Boolean readLocalConfig determina si WebViewController intenta usar un archivo de configuración local en lugar de la configuración del Intent launchContentSetting.

Antes de comenzar

Habilitar Configuración Local en EloView

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

1. En el portal de EloView, abra el elemento de contenido de la WebApp aplicable.
2. Navegue a Detalles del contenido > Propiedades del contenido.
3. Bajo Configuraciones del navegador, localice Configuración Local.
4. Establezca Configuración Local en Habilitado (Activo).
5. Guarde o aplique la configuración.

Crear y colocar el archivo de configuración local

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

Configuraciones de configuración de WebViewController

La Configuración Local soporta una gama 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 de navegador y sesión

Configuraciones de la barra de navegación

Configuraciones de la barra de acciones

Configuraciones de PDF

Ejemplo de configuración JSON

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

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

Guarde el archivo utilizando uno de los nombres de archivo compatibles directamente bajo /sdcard/. Al usar un archivo de configuración local, inicie WebViewController con readLocalConfig configurado en true.

Configurar WebViewController utilizando intenciones de Android

WebViewController también puede ser iniciado 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 de agente de dispositivo personalizada puede enviar las intenciones apropiadas para controlar WVC como parte del flujo de trabajo del dispositivo.

Resolución de problemas

Lista de verificación de configuración local

1. Identifique solo las configuraciones de WebViewController necesarias para la implementación.
2. Cree un archivo de configuración JSON o de propiedades de Java válido utilizando los nombres de configuración documentados y los tipos de valores.
3. Guarde el archivo utilizando uno de los nombres de archivo compatibles.
4. Copie el archivo directamente a la raíz /sdcard/ en el dispositivo físico Android de Elo.
5. Habilite la Configuración Local para la WebApp aplicable en EloView.
6. Al iniciar WVC utilizando un archivo de configuración local, establezca readLocalConfig en true.
7. Para el control programático, instale primero WebViewController y luego haga que la aplicación del agente del dispositivo envíe las intenciones de Android apropiadas.
8. Pruebe la configuración en el dispositivo de destino y confirme que WebViewController se comporta como se espera.