Introduction
The “Web App” application contains a list of internet bookmarks that can be configured for a device or device group. The bookmarks will appear on the RealWear devices allowing users to easily access pre-defined web pages.
This configuration can be created via a basic interface which will allow you to enter a web address one at a time or an advanced configuration allowing multiple bookmarks.
It is possible to configure bookmarks using RealWear Cloud or manually by copying a file to the RealWear device.
Configuration (Basic)
We've made it easy in the first instance to configure a Web App for your device, you can use the Web GUI to add bookmarks, simply hit the plus button, type in the name and URL of the web site. and click Save, this will send the bookmark to the Web Apps app on your device.
If you'd like more advanced control of how the Web App Bookmarks display, you can find details below
Configuration (Advanced)
File
In order to create and modify the tagset data, it is recommended to use:
- VisualStudioCode
This tool will help with JSON validation and tagset formatting.
File Location
Storage location for JSON File:, ‘/sdcard/realwear/com.realwear.weblauncher/config/config.json’
Format and Options
Below are the parameters that are required in order to correctly read in values for bookmarks.
- webapps: an array of web apps, each of which should specify its name, URL and icon – required
- name: a display name – required
- weblink: a URL to launch – required
- icon: an optional base64 encoded icon – optional
If there is no base64 encoded icon, the favicon will be used in its place, if a favicon cannot be obtained, a default icon will replace it.
Images can be converted to a Base64 using: https://www.base64-image.de/
Example file:
{
"webapps": [
{
"name": "Realwear",
"weblink": "http://www.realwear.com",
"icon": "base64 encoded image"
},
{
"name": "Google",
"weblink": "http://www.google.com",
"icon": "base64 encoded image"
},
{
"name": "Bing",
"weblink": "https://www.bing.com/",
"icon": "base64 encoded image"
},
{
"name": "Android",
"weblink": "https://www.android.com",
"icon": "base64 encoded image"
},
{
"name": "Wikipedia",
"weblink": "https://en.wikipedia.org/wiki/Optical_head-mounted_display",
"icon": "base64 encoded image"
}
]
}
Glossary
- Base64 is a group of binary-to-text encoding schemes that represent binary data in an ASCII string format.
- Favicon an icon associated with a URL that is variously displayed, as in a browser’s address bar or next to the site name in a bookmark list.