Jak korzystać z lokalnej konfiguracji z EloView WebApps i WebViewController?

Ten artykuł wyjaśnia, jak korzystać z lokalnej konfiguracji z aplikacjami internetowymi EloView® i WebViewController (WVC), aby zastosować zaawansowane ustawienia konfiguracji przeglądarki i kiosku bezpośrednio na urządzeniu Elo z systemem Android.

Lokalna konfiguracja pozwala WebViewController (WVC) korzystać z ustawień konfiguracyjnych zapisanych lokalnie na urządzeniu Elo z systemem Android, gdy WVC się uruchamia. Te ustawienia mogą zapewnić dodatkowe opcje konfiguracyjne, które nie są dostępne przez portal EloView.

⚠ Ważne

Włączenie Lokalnej Konfiguracji w EloView informuje WebViewController, aby szukał lokalnego pliku konfiguracyjnego. Nie tworzy ani nie pobiera, ani nie kopiuje pliku konfiguracyjnego na urządzenie. Klient lub administrator musi stworzyć plik konfiguracyjny i umieścić go w obsługiwanym miejscu na fizycznym urządzeniu Elo z systemem Android.

Przegląd

WebViewController może otrzymać informacje konfiguracyjne na dwa sposoby:

Lokalny plik konfiguracyjny – WVC odczytuje obsługiwany plik konfiguracyjny zapisany w katalogu głównym /sdcard/ na urządzeniu.
Intencje Androida – Niestandardowa aplikacja na Androida może uruchomić WVC i programowo dostarczyć informacje konfiguracyjne.

Boolean Intent extra readLocalConfig określa, czy WebViewController próbuje użyć lokalnego pliku konfiguracyjnego zamiast ustawień Intent launchContentSetting.

readLocalConfig	Zachowanie
`true`	Żąda, aby WVC użył obsługiwanego lokalnego pliku konfiguracyjnego i zignorował `launchContentSetting`.
`false`	WVC może otrzymać swoją konfigurację uruchamiania przez `launchContentSetting`.

Zanim rozpoczniesz

ℹ Zanim rozpoczniesz

Określ, które ustawienia WebViewController są wymagane dla Twojego wdrożenia przed stworzeniem pliku konfiguracyjnego.

Firma Elo zaleca uwzględnienie tylko tych ustawień, które zamierzasz zmienić. Pozostaw inne ustawienia jako istniejące lub domyślne.

Włącz lokalną konfigurację w EloView

Podczas konfigurowania zawartości aplikacji internetowej w EloView, włącz lokalną konfigurację w właściwościach zawartości:

W portalu EloView otwórz odpowiedni element zawartości aplikacji internetowej.
Przejdź do Szczegóły zawartości > Właściwości zawartości.
W sekcji Ustawienia przeglądarki znajdź Lokalna konfiguracja.
Ustaw Lokalna konfiguracja na Włączona (Aktywna).
Zapisz lub zastosuj konfigurację.

⚠ Ważne

Włączenie tej opcji nie tworzy ani nie wdraża pliku konfiguracyjnego. Plik konfiguracyjny musi być nadal utworzony i skopiowany do obsługiwanego miejsca na docelowym urządzeniu.

Stwórz i umieść lokalny plik konfiguracyjny

WebViewController obsługuje właściwości Javy oraz pliki konfiguracyjne JSON. Umieść plik konfiguracyjny bezpośrednio w katalogu głównym /sdcard/, korzystając z jednego z obsługiwanych nazw plików poniżej.

Priorytet	Obsługiwany ścieżka do pliku	Format
1 – Najwyższy	`/sdcard/wvc_config.properties`	Właściwości Javy
2	`/sdcard/wvc_config.prop`	Właściwości Javy
3 – Najniższy	`/sdcard/wvc_config.json`	JSON

ℹ Priorytet pliku

Jeśli na urządzeniu znajdują się więcej niż jeden obsługiwany plik konfiguracyjny, WebViewController używa pliku o najwyższym priorytecie. Na przykład, wvc_config.properties ma pierwszeństwo przed wvc_config.prop i wvc_config.json.

⚠ Wymóg dotyczący ścieżki przechowywania

Plik musi być umieszczony bezpośrednio pod /sdcard/. Plik przechowywany w podfolderze, takim jak /sdcard/Download/, ma inną ścieżkę i nie jest jedną z udokumentowanych lokalizacji dla lokalnej konfiguracji.

Ustawienia konfiguracyjne WebViewController

Lokalna konfiguracja obsługuje szereg ustawień WebViewController. Wartości Boolowskie używają true lub false. Wartości tekstowe są cudzysłowem w JSON i wprowadzane jako wartości tekstowe w pliku właściwości Javy.

Ustawienia przeglądarki i sesji

Ustawienie	Typ	Opis
`viewMode`	String	Użyj `Full View` do trybu pełnoekranowego. Inne wartości używają Form View.
`layerType`	String	`HW` włącza akcelerację sprzętową. Inne wartości używają `SW`. Akceleracja sprzętowa jest zalecana w dokumentacji dewelopera do odtwarzania wideo.
`pinchZoom`	Boolean	Włącza powiększanie przez szczypanie.
`homePageTimeout`	String	Liczba minut bezczynności przed powrotem do strony głównej. `0`, `nigdy`, lub pominięta wartość oznacza brak limitu czasu.
`clearUserDataOnTimeout`	Boolean	Czyści dane użytkownika, gdy wystąpi limit czasu strony głównej.
`clearCookiesOnTimeout`	Boolean	Czyści ciasteczka, gdy wystąpi limit czasu strony głównej.
`ssl`	Boolean	Włącza SSL.
`userAgent`	String	Ustala ciąg User-Agent.
`virtualKeyboard`	Boolean	Ustaw na `false`, aby wyłączyć klawiaturę wirtualną.
`disableDownload`	Boolean	Ustaw na `true`, aby wyłączyć pobieranie. To również wyłącza PDF.
`showLoadingBar`	Boolean	Pokazuje pasek ładowania u góry ekranu.

Ustawienia paska nawigacji

Ustawienie	Typ	Opis
`showNavBar`	Boolean	Pokazuje nawigację: Strona główna, Wstecz i Dalej na dole ekranu.
`navBarBackgroundColor`	String	Kolor paska nawigacji wg formatu `#RRGGBB` lub `#AARRGGBB`.
`navBarAccentColor`	String	Kolor akcentu paska nawigacji.

Ustawienia paska akcji

Ustawienie	Typ	Opis
`showActionBar`	Boolean	Pokazuje pasek akcji na górze ekranu.
`actionBarBackgroundColor`	String	Kolor tła paska akcji.
`actionBarBackgroundUrl`	String	URL obrazu używanego jako tło paska akcji.
`actionBarAccentColor`	String	Kolor akcentu paska akcji.
`showActionBarLogo`	Boolean	Pokazuje logo po lewej stronie paska akcji.
`actionBarLogoIconUrl`	String*	URL obrazu używanego jako ikona paska akcji.
`showActionBarTitle`	Boolean	Pokazuje tytuł strony internetowej na pasku akcji.
`showActionBarSubtitle`	Boolean	Pokazuje podtytuł strony internetowej na pasku akcji.
`showActionBarPrintBtn`	Boolean	Pokazuje przycisk Drukuj.
`showActionBarShareBtn`	Boolean	Pokazuje przycisk Udostępnij.
`showActionBarInfoBtn`	Boolean	Pokazuje przycisk Informacje.

ℹ Uwagi dokumentacyjne

Dokumentacja dla deweloperów opisuje actionBarLogoIconUrl jako URL, mimo że w tabeli źródłowej jest oznaczona jako Boolean. Ponieważ ustawienie reprezentuje URL, w tym artykule jest przedstawiane jako String. Należy zweryfikować zachowanie względem pakietu WebViewController używanego na docelowym urządzeniu.

Ustawienia PDF

Ustawienie	Typ	Opis
`pdfSupport`	Boolean	Włącza wyświetlanie PDF.
`pdfHyperlinkSupport`	Boolean	Włącza hiperlinki w obrębie plików PDF.
`pdfSwipeHorizontal`	Boolean	Włącza przewijanie poziome w PDF, gdy ustawione na `true`.
`pdfShowScrollHandle`	Boolean	Pokazuje uchwyt przewijania podczas przeglądania plików PDF.
`pdfFitToHeight`	Boolean	Dopasowuje PDF do wysokości wyświetlacza zamiast szerokości.

Przykładowa konfiguracja JSON

Poniższy skrócony przykład demonstruje strukturę pliku wvc_config.json. Wybierz tylko ustawienia i wartości odpowiednie dla Twojego wdrożenia.

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

Zapisz plik używając jednej z obsługiwanych nazw plików bezpośrednio pod /sdcard/. Podczas korzystania z lokalnego pliku konfiguracyjnego, uruchom WebViewController z readLocalConfig ustawionym na true.

Skonfiguruj WebViewController przy użyciu intencji Androida

WebViewController można również uruchomić i skonfigurować programowo za pomocą intencji Androida. To stanowi alternatywę dla używania pliku konfiguracyjnego zapisanego na urządzeniu.

Na przykład, po zainstalowaniu WebViewController, niestandardowa aplikacja agentowa może wysłać odpowiednie intencje, aby kontrolować WVC jako część pracy urządzenia.

Intent Extra	Typ	Cel
`contentPath`	String	URL strony głównej zaczynającej się od `http://`, `https://` lub `file://`.
`readLocalConfig`	Boolean	Gdy `true`, żąda, aby WVC zignorowało `launchContentSetting` i użyło obsługiwanego lokalnego pliku konfiguracyjnego.
`launchContentSetting`	String	Obiekt JSON zawierający opcje uruchamiania, takie jak tryb widoku, paski nawigacyjne, zachowanie limitu czasu, zachowanie PDF i inne obsługiwane ustawienia.

⚠ Ważne – Nazwy parametrów intencji

Dokumentacja dewelopera identyfikuje przesyłany element Intencję jako contentPath, podczas gdy przykładowe polecenie używa contentpath w małych literach.

Integratory powinni zweryfikować dokładne nazwy dodatkowych Intencji i kodowanie wartości w porównaniu z zainstalowaną wersją WebViewController oraz próbnymi plikami dostarczonymi z odpowiednim pakietem dewelopera.

Rozwiązywanie problemów

Problem	Co sprawdzić
Lokalna konfiguracja nie jest stosowana	Sprawdź, czy lokalna konfiguracja jest włączona i czy plik konfiguracyjny używa obsługiwanej nazwy pliku i lokalizacji.
Konfiguracja JSON wydaje się być ignorowana	Sprawdź, czy istnieje `wvc_config.properties` lub `wvc_config.prop`. Oba mają wyższy priorytet niż `wvc_config.json`.
Plik konfiguracyjny nie został wykryty	Upewnij się, że plik znajduje się bezpośrednio pod `/sdcard/`. Pliki w lokalizacjach takich jak `/sdcard/Download/` nie są jedną z udokumentowanych ścieżek lokalnej konfiguracji.
Ustawienia `launchContentSetting` nie są używane	Sprawdź `readLocalConfig`. Gdy ustawione na `true`, WVC próbuje użyć lokalnego pliku konfiguracyjnego zamiast.
Pobieranie lub PDF są niedostępne	Sprawdź, czy `disableDownload` jest ustawione na `true`. Udokumentowane zachowanie stwierdza, że włączenie tej opcji również wyłącza PDF.

Lista kontrolna konfiguracji lokalnej

Zidentyfikuj tylko te ustawienia WebViewController, które są wymagane do wdrożenia.
Utwórz ważny plik konfiguracyjny JSON lub właściwości Javy, używając udokumentowanych nazw ustawień i typów wartości.
Zapisz plik, używając jednej z obsługiwanych nazw plików.
Skopiuj plik bezpośrednio do katalogu głównego /sdcard/ na fizycznym urządzeniu Elo z systemem Android.
Włącz Lokalną konfigurację dla odpowiedniej aplikacji internetowej w EloView.
Podczas uruchamiania WVC przy użyciu lokalnego pliku konfiguracyjnego, ustaw readLocalConfig na true.
Dla programowej kontroli najpierw zainstaluj WebViewController, a następnie pozwól aplikacji agentowej wysłać odpowiednie intencje Androida.
Przetestuj konfigurację na docelowym urządzeniu i potwierdź, że WebViewController działa zgodnie z oczekiwaniami.

💡 Wskazówka

Zachowanie WebViewController i dostępne ustawienia mogą różnić się w zależności od wersji WVC. Podczas opracowywania automatycznego wdrożenia, zweryfikuj konfigurację względem pakietu WebViewController i przykładowych plików konfiguracyjnych zainstalowanych na docelowym urządzeniu.

Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article

Szukaj

Witamy w Dziale Wsparcia Elo