January 5, 2023
In this article
Usage
To top
Usage
To topConfig intents are a way to change the setting of some handheld apps from your own app. The system works by using broadcasts with the actual data provided as extras.
Permission
A special permission is required for this so make sure to add the permission to your AndroidManifest.xml
<uses-permission android:name="com.handheldgroup.permission.WRITE_APP_CONFIG" />
Make sure to grant this permission to your app before sending the broadcast.
Broadcast action
The broadcast action consists of the apps package name with “.WRITE_CONFIG” appended. For the KioskBrowser, this would be “com.handheldgroup.kioskbrowser.WRITE_CONFIG“.
Broadcast extras
There are two ways to send extras. You can provide all the different options as individual extras or provide the path to an XML file containing the values. Most apps provide a way to export the settings to XML so you can use that file.
Send config file
If you want to send the config as an XML file, you need two string extras. The first one has the key “format” and the value “file” to indicate that you want to import a file. The second extra has the key “file” and the value should be a path to the XML file you want to use.
Make sure that the receiving app actually has permission to read this file.
Send individual values
The available values might differ greatly between apps. Please select one of the apps in the list below to see possible keys for this app.
In most cases, it will be easier to set up an app as you need and export the settings. You can either use the exported file directly or open it to see the keys and values you could use.
Supported apps
To top
Supported apps
To topKiosk Browser
Intent action
com.handheldgroup.kioskbrowser.WRITE_CONFIG
Possible values
The application lets you export the values to an XML file. Please look at that file for the possible keys.
Kiosk Home
Intent action
com.handheldgroup.kioskhome.WRITE_CONFIG
Possible values
| Type | Key | Value | Note |
| String | password | 1234 | Set password to “1234” (or any other numeric value) |
| Boolean | show_notifications | true/false | Show notifications inside the app |
| Boolean | block_statusbar | true/false | Prevent access to the status bar |
| Boolean | block_recent_apps | true/false | Prevent access to the recent apps list |
| Boolean | ignore_default_apps | true/false | Do not enable the default apps (phone and contacts) |
| Boolean | set_allowed_kiosk.internal.wifi | true/false | Show the Wi-Fi icon and allow access to the wifi settings |
| Boolean | set_allowed_<packetname> | true/false | Adds or removed the app with the given package name |
