Feature Demo

Enterprise Browser 3.5

Overview

The Feature Demo application showcases some of the key capabilities of Enterprise Browser when running an enterprise application on Zebra devices. Enabling the demo app requires changes to the Config.xml file on the device that will run the app. See the Config.xml Reference for more information.

Showcased Capabilities

  • Barcode scanning
  • Image capture
  • Signature capture
  • Battery usage and signal indicators
  • Capturing key-presses
  • Changing and capturing screen orientations
  • Timer API functions
  • Enabling, disabling and orienting the hourglass ("screen loading" icon)

Showcased HTML5 capabilities

  • WebSQL
  • WebStorage

Installation

Set up a Local Web Server on the Device

The Feature Demo Application for Enterprise Browser pulls in demo files using uses AJAX, which requires a web server to be running on the device.

Enable the on-device web server:

1. Locate the Config.xml file on the device that will be running the Feature Demo:

Path to Config.xml file:

  • On Android devices: /sdcard/Android/data/com.zebra.mdna.enterprisebrowser/Config.xml
  • On Windows devices: \Program Files\EnterpriseBrowser\Config\Config.xml

2. Add the following lines to the Config.xml immediately under the <Configuration> tag, as below:


<Configuration>
  <WebServer>
     <Enabled value="1" />
     <Port value="8082" />
   <WebFolder value="file://%PERSISTCONFDIR%/fd/" />
     <Public value="1" />
  </WebServer>

3. In Config.xml specify the start page value as below: 

    

    <StartPage value="http://127.0.0.1:8082/feature-demo.html" name="Menu"/>

4. Push the Config.xml to /enterprise/device/enterprisebrowser/:


adb push Config.xml /enterprise/device/enterprisebrowser/Config.xml

5. Create a folder called fd (case sensitive) in /enterprise/device/enterprisebrowser/.

6. From the computer with Enterprise Browser installed, copy the contents of c:/EnterpriseBrowser/Feature-Demo to the newly created /enterprise/device/enterprisebrowser/fd/ folder.

7. On the device, launch the Enterprise Browser app. A screen similar to the image below appears, showing all Feature-Demo capabilities.

Demo Features

To try a specific feature, click on the "hamburger" menu icon at the top left and select it. To quickly exit the Feature Demo App, use the X at the top right.

Barcode Scanning

Demonstrates use of the most common Barcode APIs:

Enumerate – scans the device for all capable barcode interfaces. These might include 2D imager, laser, and camera. Tap in a scanner type to Enable or Disable that scanner.

Enable – enables the dedicated scanner button on the device. Press the hardware scan trigger and point it at a barcode, the decode information will be presented.

Disable – disable the active barcode scanner.

Start – activates the scanner in "soft trigger" mode. Scanner remains active until a barcode is decoded or a timeout occurs. This button is active only after tapping the Enable button.

Stop – disables the soft trigger mode.

To Test the Scanner:

  1. Go to the Barcode section of the application

  2. Click Enumerate to be presented with a list of available scanners

  3. Select a scanner to use

  4. After selecting a scanner, click Enable. This will start the chosen scanner on the device.

  5. Press start and try scanning the image below

    When done correctly, the Barcode Scanner should return the following

Battery

Demonstrates use of the most common Battery APIs:

Show Icon – displays a battery icon in the upper left-hand corner. Change parameters within the code to control more aspects of icon presentation and location.

Hide Icon – hides the battery icon.

Start – begins to monitor for battery status events. For example, when not being charged, battery level is displayed.

Stop – stops monitoring for battery status events.

Camera

Demonstrates use of most common Imager APIs:

Show Camera – activates the camera and allows a picture to be taken. Displays status information after performing the action.

Hourglass

Demonstrates use of the most common Hourglass APIs:

Show – displays a "loading" indicator in the position denoted in the "Left" and "Top" coordinates field. If nothing is entered, displays the loading indicator in the center of the screen.

Hide – hides the loading indicator.

Left – controls the left coordinates of the screen display used to position the loading indicator.

Stop – controls the top coordinate of the screen display used to position the loading indicator.

Key Capture

Demonstrates use of the most common Key Capture APIs:

Capture Trigger – displays an indicator when the hardware scanner button is pressed as well as the key code currently assigned to the scanner button.
Capture Keys – displays the key code assigned to any hardware or software key that is pressed.

Screen

Demonstrates use of the most common Screen Orientation APIs:

Left – forces the device to rotate to a left-handed orientation.

Right – forces the device to rotate to a right-handed orientation.

Upside Down – forces the device to rotate to an upside-down orientation.

Normal – force the device to rotate to a normal orientation.

Auto Rotate – toggles between auto-rotation enable/disable.

Signal

Demonstrates use of the most common Signals in the Signal Indicators API:

  • signalStrength
  • essid
  • macAddress
  • adapterName
  • dhcpServer
  • dhcpStatic (Windows Mobile only)
  • gateway
  • ipAddress
  • rssi
  • subnetMask
  • wins (Windows Mobile only)

Show Icon – displays a Wi-Fi icon in the upper left-hand corner. Icon appearance and location can be configured by changing parameters within the code.

Hide Icon – hides the Wi-Fi icon.

Start – retrieves the current signal status. On Windows Mobile/CE devices, if a callback is provided to retrieve the signal, the signal will be called according to the specified refreshInterval. On Android, the callback will be invoked whenever there's a change in one of the signal values listed above.

Stop – stops monitoring for Wi-Fi status events.

Status – This section will be populated with the data that comes from the signal event upon a change in status. It will be displayed only after the "Start" button has been tapped.

All callback information will be updated in the respective field(s) on the Signal Indicator page.

Note: Monitoring for Signal events may interfere with other UI elements of the feature demo application when it attempts to display the updated information. To avoid this, press "Stop" to disable Signal-events monitoring before viewing other features.

Signature Capture

Demonstrates use of the most common Signature APIs:

Show – displays a full-screen signature capture widget; uses the Color and Width properties (can be customized). When returning from this widget, the status of the event will be displayed along with the image of the signature (if the user pressed the OK button).

Background Color - enter a hex value string to specify the background color of the signature capture area. For example, changing it to #FF0000 will result in a red background.

Pen Color - enter a hex value string to specify the pen-stroke color for signature capture. For example, changing this value to #FF0000 will result in a red pen color.

Pen Width - enter an integer value to specify the pen-stroke thickness (in pixels).

Timer

Demonstrates use of the most common Timer APIs:

Duration – the length of time (in ms) an event will run. Must be specified before timer is started.

Start – starts a timer to run the length of time specified in the Duration.

Stop – stops the timer.

Status – indicates whether a timer event is started or stopped.

WebSQL

Demonstrates basic functionality of the HTML5 WebSQL standards:

Input – enter a string to be stored.

Output – displays the data retrieved when tapping the "Fetch" button.

Store – stores the value in the "Input" field into WebSQL.

Fetch – retrieves the stored value from WebSQL.

WebStorage

Demonstrates the basic functionality of the HTML5 LocalStorage and SessionStorage APIs. This allows storage of basic Name/Value data pairs.

LocalStorage Input – a string to be stored using LocalStorage; remains resident after the app is closed.

LocalStorage Output – displays the LocalStorage data retrieved when tapping the "Local Fetch" button.

SessionStorage Input – a string to be stored using SessionStorage; does not persist after the app is closed.

SessionStorage Output – displays the SessionStorage data retrieved when tapping the "Local Fetch" button.

Local Store – stores the value in the "LocalStorage Input" field into LocalStorage.

Local Fetch – retrieves the value from LocalStorage.

Session Store – stores the value in the "SessionStorage Input" field into SessionStorage.

Session Fetch – retrieve the value from SessionStorage.

Inspecting the Code

When unzipping the contents of the Feature Demo download, the following folders and files appear:

Contents of the Feature Demo download:

apis – folder that contains individual .html files associated with each feature.

featurename.html – each file has all associated JavaScript that is used to demonstrated the use of the API.

img – folder that contains icons and images used in the demo.

ebapi-modules.js – Enterprise Browser core JavaScript API library.

elements.js – Enterprise Browser JavaScript library used by some of the APIs.

rhoapi-modules.js – Enterprise Browser JavaScript library used by some of the APIs.

feature-demo.html – main application page that controls behavior of the Feature Demo application.

style.css – CSS file used for look and feel of the Feature Demo application.

To learn from the Feature Demo application, it is best to look at the individual HTML files located in the /apis folder. Notice the SCRIPT block that contains the associated JavaScript for performing the particular action.

Troubleshooting

Still having trouble getting the Feature Demo to work? Try the following:

  • Check that the device has the latest available BSP from the Zebra Support Portal.

  • Confirm that DataWedge is configured correctly. See the DataWedge documentation and the device's Integrator Guide for more information.

  • If the device won't display the Feature Demo application screen, double-check that the <StartPage> parameter in the Config.xml contains the correct path to the start page.

  • Check the Settings panel on the device to ensure that Wi-Fi is enabled and connected.