Cet article explique comment utiliser Local Config avec EloView® WebApps et WebViewController (WVC) pour appliquer des paramètres de configuration avancés du navigateur et du kiosque directement sur un appareil Elo Android.

Local Config permet à WebViewController (WVC) d'utiliser des paramètres de configuration stockés localement sur un appareil Elo Android lorsque WVC se lance. Ces paramètres peuvent fournir des options de configuration supplémentaires au-delà de celles disponibles via le portail EloView.

Aperçu

WebViewController peut recevoir des informations de configuration de deux manières :

1. Fichier de configuration local – WVC lit un fichier de configuration pris en charge stocké dans le répertoire racine /sdcard/ sur l'appareil.
2. Intents Android – Une application Android personnalisée peut lancer WVC et fournir des informations de configuration de manière programmatique.

Le paramètre boolean Intent readLocalConfig détermine si WebViewController tente d'utiliser un fichier de configuration local au lieu des paramètres de l'Intent launchContentSetting.

Avant de Commencer

Activer Local Config dans EloView

Lors de la configuration du contenu WebApp dans EloView, activez Local Config à partir des propriétés du contenu :

1. Dans le portail EloView, ouvrez l'élément de contenu WebApp applicable.
2. Naviguez vers Détails du contenu > Propriétés du contenu.
3. Sous Paramètres du navigateur, localisez Local Config.
4. Définissez Local Config sur Activé (Actif).
5. Enregistrez ou appliquez la configuration.

Créer et Placer le Fichier de Configuration Local

WebViewController prend en charge les fichiers de configuration au format Java properties et JSON. Placez le fichier de configuration directement dans le répertoire racine /sdcard/ en utilisant l'un des noms de fichiers pris en charge ci-dessous.

Paramètres de Configuration de WebViewController

Local Config prend en charge une gamme de paramètres de WebViewController. Les valeurs boolean utilisent true ou false. Les valeurs string sont citées dans le JSON et saisies en tant que valeurs textuelles dans un fichier properties Java.

Paramètres de Navigateur et de Session

Paramètres de la Barre de Navigation

Paramètres de la Barre d'Actions

Paramètres PDF

Exemple de Configuration JSON

L'exemple abrégé suivant montre la structure d'un fichier wvc_config.json. Sélectionnez uniquement les paramètres et valeurs appropriés pour votre déploiement.

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

Enregistrez le fichier en utilisant l'un des noms de fichiers pris en charge directement sous /sdcard/. Lors de l'utilisation d'un fichier de configuration local, lancez WebViewController avec readLocalConfig défini sur true.

Configurer WebViewController en Utilisant les Intents Android

WebViewController peut également être lancé et configuré de manière programmatique via les Intents Android. Cela fournit une alternative à l'utilisation d'un fichier de configuration stocké sur l'appareil.

Par exemple, après que WebViewController a été installé, une application agent personnalisée peut envoyer les Intents appropriés pour contrôler WVC dans le cadre du flux de travail de l'appareil.

Dépannage

Liste de Vérification de Configuration Locale

1. Identifiez uniquement les paramètres WebViewController nécessaires pour le déploiement.
2. Créez un fichier de configuration JSON ou Java properties valide en utilisant les noms de paramètres et types de valeurs documentés.
3. Enregistrez le fichier en utilisant l'un des noms de fichiers pris en charge.
4. Copiez le fichier directement dans la racine /sdcard/ sur l'appareil Elo Android physique.
5. Activez Local Config pour l'application WebApp applicable dans EloView.
6. Lors du lancement de WVC en utilisant un fichier de configuration local, définissez readLocalConfig sur true.
7. Pour un contrôle programmatique, installez d'abord WebViewController puis faites envoyer par l'application agent les Intents Android appropriés.
8. Testez la configuration sur l'appareil cible et confirmez que WebViewController se comporte comme prévu.