Dit artikel legt uit hoe je Local Config kunt gebruiken met EloView® WebApps en WebViewController (WVC) om geavanceerde browser- en kioskconfiguratiesettings direct op een Elo Android-apparaat toe te passen.

Local Config stelt WebViewController (WVC) in staat om configuratiesettings die lokaal op een Elo Android-apparaat zijn opgeslagen te gebruiken wanneer WVC wordt gestart. Deze instellingen kunnen extra configuratieopties bieden, naast die beschikbaar zijn via het EloView-portaal.

Overzicht

WebViewController kan configuratie-informatie op twee manieren ontvangen:

1. Lokaal configuratiebestand – WVC leest een ondersteund configuratiebestand dat is opgeslagen in de root /sdcard/ directory op het apparaat.
2. Android Intents – Een aangepaste Android-applicatie kan WVC starten en programmatig configuratie-informatie verstrekken.

De readLocalConfig Boolean Intent extra bepaalt of WebViewController probeert een lokaal configuratiebestand te gebruiken in plaats van de launchContentSetting Intent-instellingen.

Voordat je begint

Local Config inschakelen in EloView

Wanneer je de inhoud van WebApp in EloView configureert, schakel je Local Config in vanaf de inhoudseigenschappen:

1. Open in het EloView-portaal het toepasselijke WebApp-inhouditem.
2. Navigeer naar Inhoud Details > Inhoudseigenschappen.
3. Onder Browserinstellingen, zoek Local Config.
4. Stel Local Config in op Ingeschakeld (Actief).
5. Sla de configuratie op of pas deze toe.

Maak en plaats het lokale configuratiebestand

WebViewController ondersteunt Java-eigenschappen en JSON-configuratiebestanden. Plaats het configuratiebestand direct in de root /sdcard/ directory met een van de ondersteunde bestandsnamen hieronder.

WebViewController Configuratie-instellingen

Local Config ondersteunt een reeks WebViewController-instellingen. Booleaanse waarden gebruiken true of false. Stringwaarden worden geciteerd in JSON en als tekstwaarden ingevuld in een Java-eigenschappenbestand.

Browser- en sessie-instellingen

Navigatiebalkinstellingen

Actiebalkinstellingen

PDF-instellingen

Voorbeeld JSON-configuratie

Het volgende afgekorte voorbeeld toont de structuur van een wvc_config.json bestand. Selecteer alleen de instellingen en waarden die geschikt zijn voor jouw implementatie.

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

Bewaar het bestand met een van de ondersteunde bestandsnamen direct onder /sdcard/. Bij gebruik van een lokaal configuratiebestand, start WebViewController met readLocalConfig ingesteld op true.

Configureer WebViewController met Android Intents

WebViewController kan ook programmatig worden gestart en geconfigureerd via Android Intents. Dit biedt een alternatief voor het gebruik van een configuratiebestand dat op het apparaat is opgeslagen.

Bijvoorbeeld, nadat WebViewController is geïnstalleerd, kan een aangepaste device-agentapplicatie de juiste Intents verzenden om WVC te bedienen als onderdeel van de apparaatworkflow.

Probleemoplossing

Checklist voor het instellen van Local Config

1. Identificeer alleen de WebViewController-instellingen die nodig zijn voor de implementatie.
2. Maak een geldig JSON- of Java-eigenschappen configuratiebestand met de gedocumenteerde instellingnamen en waarde typen.
3. Sla het bestand op met een van de ondersteunde bestandsnamen.
4. Kopieer het bestand direct naar de /sdcard/ root op het fysieke Elo Android-apparaat.
5. Schakel Local Config in voor de toepasselijke WebApp in EloView.
6. Wanneer je WVC start met een lokaal configuratiebestand, stel readLocalConfig in op true.
7. Voor programatische controle, installeer eerst WebViewController en laat het device-agent applicatie de juiste Android Intents verzenden.
8. Test de configuratie op het doelsysteem en bevestig dat WebViewController zich gedraagt zoals verwacht.