UI Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

Language Note: Input fields accept ENGLISH ONLY.

EMDK For Android - 8.0

Overview

The UI Manager (UiMgr) provides control of miscellaneous UI configuration settings, such as those for language and locale, the device notification pull-down, Quick Settings controls, default input device and Clipboard behavior.

Android devices contain a variety of System applications that access UI elements spread throughout the OS. In some cases, one or more of these "standard" UI elements were deemed undesirable by Zebra customers and/or partners for devices deployed in an enterprise. The UiMgr provides control over these UI elements and the option of disabling Android behaviors or features with the potential to hinder the productivity of device users engaged in specific business tasks.

Security Warning: The UiMgr permits the "Network may be monitored..." message to be suppressed. This important safeguard is intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.

Main Functionality

  • Enable/Disable:
    • Quick Settings controls for user access to Wi-Fi, Bluetooth and other settings
    • Clipboard
    • Android Clipboard Share
    • AutoCorrect function
    • HOME Key function
    • The Bluetooth Pairing pop-up
    • "The network may be monitored..." message
    • "Recent Apps" button
    • Navigation Bar
    • The Status Bar
    • Display of the virtual keyboard
    • Screen magnification gesture
    • Split-screen mode
    • Multi-user mode
    • Do Not Disturb mode
    • The Large Key Indicator (LKI) pop-up
    • User access to the LKI feature
    • The On-screen Power Button
  • Configure localization settings to:
    • Set the Current Locale for a desired language and region
    • Set the Default Input Method to enhance entry of localized data
    • Manage layouts (languages) for external physical keyboard(s)
    • Select Home screen wallpaper
    • Select the preferred assistant app
  • Clear the Clipboard, which discards any prior data that might have been copied
  • Add, Replace, external keyboards and keyboard mappings
  • Remove individual or all external keyboards and keyboard mappings
  • Select a preferred pre-installed or custom Assistant app for the device

Clipboard Usage

Controls whether the Clipboard function can be used, potentially enabling a device user to move data from one app to another.

Parm Name: ClipBoardUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

OSX: 4.2+

MX: 4.2+

1 Enable Enables app data to be copied to the Clipboard and pasted into other apps on the device.

OSX: 4.2+

MX: 4.2+

2 Disable Disables the Clipboard, preventing the user from copying app data to the clipboard and pasting it into other apps on the device.

OSX: 4.2+

MX: 4.2+

Clear Clipboard

Used to immediately clear the contents of the Clipboard, preventing data that was stored there from being pasted at any time thereafter. If Clipboard functions are allowed by an app that handles sensitive data, Zebra recommends using this parameter to clear sensitive data from Clipboard upon exiting the app to prevent the data from later being pasted elsewhere.

Parm Name: ClipBoardClear

Option Name Description Note Requires
true true Clears the Clipboard, erasing any content that was previously copied and preventing such content from being pasted elsewhere.

OSX: 4.2+

MX: 4.2+

false false Causes no change to the contents of the Clipboard.

OSX: 4.2+

MX: 4.2+

Clipboard Share

Controls whether a device user has access to Android Clipboard Share, features that automate Clipboard data sharing among apps on and off the device. Disabling Clipboard Share does NOT prevent a user from manually pasting Clipboard data from one app to another on the device. To prevent this action, see Clipboard Usage.

Parm Name: ClipboardShare

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.5+

1 Enable Allows use of Android Clipboard Share functions when using the on-device Clipboard, potentially allowing Clipboard contents to be shared among apps on and off the device.

MX: 10.5+

2 Disable Blocks Android Clipboard Share functions when using the on-device Clipboard.

MX: 10.5+

External Keyboard Action

Used to select an Action to perform on the connected external keyboard specified in the External Keyboard Name parameter.

Note: An external keyboard MUST be connected when applying these parameter Actions. This is an experimental feature and is NOT covered by Zebra Technical Support.

Parm Name: ExternalKeyboard

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change device settings; any previously selected setting is retained.

MX: 10.5+

Android API: 30+

1 Add/Replace Keyboard Layout Mapping Adds a Keyboard Layout (language) to the device or replaces one of the same name.

MX: 10.5+

Android API: 30+

2 Remove Keyboard Layout Mapping Removes a Keyboard Layout (language) from the device.

MX: 10.5+

Android API: 30+

3 Remove All Keyboard Layout Mappings Removes all Keyboard Layouts (languages) from the device.

MX: 10.5+

Android API: 30+

External Keyboard Name

Used to enter a Keyboard Name to add or replace a Keyboard Layout (language) on the device. Note: If a layout exists on the device with the same name as one being added, the existing layout is replaced by the layout being added. Keyboard Names are NOT case sensitive.

To view the name of the connected external keyboard, go to the Android Settings panel and select System > Languages & input > Physical keyboard.

Parm value input rules:

  • String of at least one alphanumeric character
  • If no Keyboard Name is entered, selected layouts are applied to all keyboards connected to the device

Shown if: External Keyboard Action is "Add/Replace Keyboard Layout Mapping"

Parm Name: ExternalKeyboardName

Requires:

  • MX: 10.5+
  • Android API: 30+

External Optional Keyboard Name

Used to enter a Keyboard Name from which to remove a Keyboard Layout (language). The Keyboard Name entered must be among those listed in the Input Settings panel on the device. Keyboard Names are NOT case sensitive.

Parm value input rules:

  • String of at least one alphanumeric character

Shown if: External Keyboard Action is "Remove Keyboard Layout Mapping"

Parm Name: ExternalOptionalKeyboardName

Requires:

  • MX: 10.5+
  • Android API: 30+

External Keyboard Layout

Used to enter the name of the Keyboard Layout being configured. This required field and MUST contain the name of a layout listed in the "Keyboard layouts" panel on the device. NOTE: Layout Names ARE case sensitive.

To view a list of Keyboard Layouts:

  1. Go to the Android Settings panel.
  2. Select System > Languages & input > Physical keyboard.
  3. Tap the name of the connected external keyboard. The name of the currently selected layout is displayed.
  4. Tap "SET UP KEYBOARD LAYOUTS" to display a list of alternalive layouts (languages).

Parm value input rules:

  • String of at least one alphanumeric character

Note: External keyboard MUST be connected when applying this parameter. If multiple StageNow Profiles containing different layout names are created, the layout in the last applied Profile becomes the default.

Shown if: External Keyboard Action is "Add/Replace Keyboard Layout Mapping"

Parm Name: ExternalKeyboardLayout

Requires:

  • MX: 10.5+
  • Android API: 30+

AutoCorrect Usage Enable/Disable

Controls whether AutoCorrect functionality is accessible on the device. AutoCorrect can be used to save commonly entered words or industry-specific words or phrases and offer them as corrections to potentially mistyped words. Such functionality could present a security risk by exposing sensitive information to subsequent device users that are not authorized to view or reuse that information.

Note: This parameter does not turn the AutoCorrect function on or off or configure any of its functions. When AutoCorrect is enabled, an administrator or device user must still use the System Settings panel turn the function on or off and configure its functions. When disabled, AutoCorrect functionality cannot be used on the device.

Parm Name: AutoCorrectUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 4.3+

Android API: 1+

1 Enable Enables use of the AutoCorrect function, allowing an administrator or device user to the turn the function on and off and configure its settings using the System Settings panel.

MX: 4.3+

Android API: 1+

2 Disable Disables use of the AutoCorrect function, preventing an administrator or device user from turning the function on or off and configuring its settings using the System Settings panel.

MX: 4.3+

Android API: 1+

HOME Key Enable/Disable

Used to prevent use of the HOME key to exit the current app and run the Home Screen app. This might be desirable when the device is devoted to running a single application, such as that of a kiosk. By blocking use of the HOME key, a common method of navigating away from the application (whether intentional or not) can be eliminated.

Note: Enabling this parameter does not affect the "long press" behavior of the HOME key. To completely prevent all HOME key functionality, use the Key Mapping Manager (on supported devices) to disable the HOME key or map it to a desired behavior.

Parm Name: HomeKeyUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to HOME key functionality; any previously selected setting will be retained.

OSX: 1.0+

MX: 4.3+

1 Enable Allows use of the HOME key to exit the current app and launch the Home Screen app.

OSX: 1.0+

MX: 4.3+

2 Disable Prevents use of the HOME key, which would otherwise exit the current app and run the Home Screen app.

OSX: 1.0+

MX: 4.3+

Long-Press HOME Key Enable/Disable

This is the On/Off switch for device response to a "long-press" of the HOME key, which launches the Google Assistant.

Parm Name: LongPressHomeKeyUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained.

OSX: 7.7+

MX: 8.2+

1 Enable Allows the device to respond to a "long-press" of the HOME key.

OSX: 7.7+

MX: 8.2+

2 Disable Prevents the device from responding to a "long-press" of the HOME key.

OSX: 7.7+

MX: 8.2+

Date Launches Clock App Enable/Disable

This is the On/Off switch for launching the Clock app on the device by tapping the date in the Notifications drop-down panel.

Parm Name: NotificationDate

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained.

OSX: 7.7+

MX: 8.2+

1 Enable Allows the Clock app to launch on the device by tapping the date in the Notifications drop-down panel.

OSX: 7.7+

MX: 8.2+

2 Disable Prevents the Clock app from launching on the device by tapping the date in the Notifications drop-down panel.

OSX: 7.7+

MX: 8.2+

Network 'Monitored' Message Enable/Disable

Controls whether the message "Network may be monitored..." is displayed on the device when the device user connects to certain types of networks. This message is generally associated with networks that implement a public key infrastructure and require a root certificate on the device before a client will be allowed to connect.

Security Warning: The "Network may be monitored..." message is a safeguard intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.

Note: On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.

Parm Name: NetworkMonitorNotification

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting will be retained.

OSX: 6.0+

MX: 6.1+

1 Turn On Allows "Network may be monitored..." notifications to be displayed.

OSX: 6.0+

MX: 6.1+

2 Turn Off Prevents "Network may be monitored..." notifications from being displayed.

OSX: 6.0+

MX: 6.1+

Multi-user Enable/Disable

This is the On/Off switch for Multi-user mode on the device, which can provide separate user accounts, data and apps or app restrictions on a shared device. Zebra devices support a maximum of 4 users.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

  • PS20
  • TC52
  • TC57
  • TC72
  • TC77

Note: Supported on SDM660-platform devices only. Zebra devices support a maximum of 4 users.

Parm Name: MultiUser

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to the Multi-user setting; any previously selected setting is retained.

OSX: 8.5+

MX: 8.1+

1 Enable Enables multiple users on the device.

OSX: 8.5+

MX: 8.1+

2 Disable Disables multi-user mode on the device.

OSX: 8.5+

MX: 8.1+

Set Current Locale

Permits the selection of the device's Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.

Parm value input rules:

  • String containing two lower-case letters corresponding to the language
  • Optionally may contain two upper-case letters designating a region code
  • When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
  • The minimum length is 2 characters; the maximum length is 5 characters

Parm Name: CurrentLocale

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to be made to the Locale; any previously selected setting will be retained.

OSX: 1.3+

MX: 4.3+

98 Extended Permits selection from the Extended List of Locales

MX: 5.1+

99 Custom Permits selection from the Custom List of Locales

MX: 5.1+

en_CA CANADA English spoken in Canada

OSX: 1.3+

MX: 4.3+

fr_CA CANADA_FRENCH French spoken in Canada

OSX: 1.3+

MX: 4.3+

zh_CN CHINA Chinese spoken in China

OSX: 1.3+

MX: 4.3+

zh CHINESE Chinese (non-region specific)

OSX: 1.3+

MX: 4.3+

en ENGLISH English (non-region specific)

OSX: 1.3+

MX: 4.3+

fr_FR FRANCE French spoken in France

OSX: 1.3+

MX: 4.3+

fr FRENCH French (non-region specific)

OSX: 1.3+

MX: 4.3+

de GERMAN German (non-region specific)

OSX: 1.3+

MX: 4.3+

de_DE GERMANY German spoken in Germany

OSX: 1.3+

MX: 4.3+

it ITALIAN Italian (non-region specific)

OSX: 1.3+

MX: 4.3+

it_IT ITALY Italian spoken in Italy

OSX: 1.3+

MX: 4.3+

ja_JP JAPAN Japanese spoken in Japan

OSX: 1.3+

MX: 4.3+

ja JAPANESE Japanese (non-region specific)

OSX: 1.3+

MX: 4.3+

ko_KR KOREA Korean spoken in Korea

OSX: 1.3+

MX: 4.3+

ko KOREAN Korean (non-region specific)

OSX: 1.3+

MX: 4.3+

zh_CN PRC Alternate Chinese spoken in China

OSX: 1.3+

MX: 4.3+

zh_CN SIMPLIFIED_CHINESE Alternate Chinese spoken in China

OSX: 1.3+

MX: 4.3+

zh_TW TAIWAN Chinese spoken in Taiwan

OSX: 1.3+

MX: 4.3+

zh_TW TRADITIONAL_CHINESE Alternate Chinese spoken in Taiwan

OSX: 1.3+

MX: 4.3+

en_GB UK English spoken in Great Britain/United Kingdom

OSX: 1.3+

MX: 4.3+

en_US US English spoken in the United States of America (USA)

OSX: 1.3+

MX: 4.3+

es_ES SPAIN_SPANISH Spanish spoken in Spain

OSX: 1.3+

MX: 5.0+

es_US US_SPANISH Spanish spoken in the United States of America (USA)

OSX: 1.3+

MX: 5.0+

pt_BR BRAZIL_PORTUGUESE Portuguese spoken in Brazil

OSX: 1.3+

MX: 5.0+

pt_PT PORTUGAL_PORTUGUESE Portuguese spoken in Portugal

OSX: 1.3+

MX: 5.0+

Battery Percentage Show/Hide

Controls whether the current battery-charge percentage is displayed. When shown, the percentage appears in the Android Status Bar at the top of the screen.

Parm Name: ShowBatteryPercentage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.1+

1 Turn On Causes battery-charge percentage to be shown in the Status Bar.

MX: 10.1+

2 Turn Off Causes the battery-charge percentage to be hidden.

MX: 10.1+

Split Screen Enable/Disable

This is the On/Off switch for Split Screen functionality on the device, which allows two apps to be usable at the same time, each with its own section of the screen. When enabled, Split Screen mode is accessed on some devices by long-pressing the "Recent Apps" button.

Parm Name: SplitScreenMode

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to the Split-screen setting; any previously selected setting is retained.

OSX: 7.7+

MX: 8.1+

1 Enable Allows two apps to be usable at the same time by sharing screen space.

OSX: 7.7+

MX: 8.1+

2 Disable Prevents more than one app from being visible at a time.

OSX: 7.7+

MX: 8.1+

Do Not Disturb Enable/Disable

Controls whether the device user is permitted to change the state (On/Off) of "Do Not Disturb" mode on the device, which toggles app notification sounds and messages. When Enabled (option 1), the user can turn notifications on or off using the Notification pull-down or Android Settings panel. When Disabled, the user can view the DND state but cannot change it. Note: This parameter does NOT change the state of DND mode, only the device user's ability to do so.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

  • PS20
  • TC52
  • TC57
  • TC72
  • TC77

Note: Supported on SDM660-platform devices only.

Parm Name: DND

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

OSX: 8.5+

MX: 8.1+

1 Enable Allows the device user to control the state of "Do Not Disturb" mode on the device, potentially stopping app notifications and sounds.

OSX: 8.5+

MX: 8.1+

2 Disable Prevents the device user from changing the state of "Do Not Disturb" mode on the device.

OSX: 8.5+

MX: 8.1+

Bluetooth Pairing Pop-up Enable/Disable

Controls whether to present the Bluetooth Pairing Pop-up during a pairing operation, useful mainly when the device user is responsible for pairing. If one or more applications are expected to control pairing operations, suppressing the Pairing Pop-up can reduce the potential for user interference with the pairing process.

Parm Name: BluetoothPairingPopupUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to Bluetooth Pairing Pop-up setting; any previously selected setting is retained.

OSX: 4.3+

MX: 4.3+

1 Enable Allows the Bluetooth Pairing Pop-up to be presented during pairing operations.

OSX: 4.3+

MX: 4.3+

2 Disable Prevents display of the Bluetooth Pairing Pop-up during pairing operations.

OSX: 4.3+

MX: 4.3+

App Info Icon Enable/Disable

This is the On/Off switch for device response to a "long-press" of an app icon in the Recent Apps Header. When enabled, long-pressing an app icon allows the device user to access application information and to potentially perform undesireable actions, such as stopping the app.

Parm Name: AppInfoIconOnRecentAppHeader

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained.

OSX: 7.7+

MX: 8.2+

1 Enable Allows the device to respond to a "long-press" on an app icon in the Recent Apps Header.

OSX: 7.7+

MX: 8.2+

2 Disable Prevents the device from responding to a "long-press" of an app icon in the Recent Apps Header.

OSX: 7.7+

MX: 8.2+

Set a Custom Locale

Permits the selection of the device's Custom Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters associated with the language of the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.

Parm value input rules:

  • String containing two lower-case letters corresponding to the language
  • Optionally may contain two upper-case letters designating a region code
  • When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
  • The minimum length is 2 characters; the maximum length is 5 characters

Shown if: Current Locale value is "Custom" (99)

Parm Name: CustomLocale

Requires:

  • MX: 5.1+

Set an Extended Locale

Permits the selection of the device's locale from the list of Extended Locales. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.

Parm value input rules:

  • String containing two lower-case letters corresponding to the language
  • Optionally may contain two upper-case letters designating a region code
  • When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
  • The minimum length is 2 characters; the maximum length is 5 characters

Shown if: Current Locale value is "Extended" (98)

Parm Name: ExtendedLocale

Option Name Description Note Requires
en_AU AUSTRALIA_ENGLISH Not supported on TC55 KitKat

OSX: 1.3+

MX: 5.1+

en_IN INDIA_ENGLISH Not supported on TC55 KitKat

OSX: 1.3+

MX: 5.1+

sv_SE SWEDEN_SWEDISH

OSX: 1.3+

MX: 5.1+

nb_NO NORWAY_NORWEGIAN-BOKMAL

OSX: 1.3+

MX: 5.1+

fi_FI FINLAND_FINISH

OSX: 1.3+

MX: 5.1+

da_DK DENMARK_DANISH

OSX: 1.3+

MX: 5.1+

Set Default Input Method

Controls whether to change the Default Input Method (i.e. a soft keyboard) when that change is requested programmatically or manually by the device user. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked. When changing the Current Locale, it may desirable to also change the Default Input Method to one that is suitable for entry of characters that are associated with the selected Locale.

Parm Name: InputMethodAction

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to be made to the Current Default Input Method; any previously selected setting will be retained.

MX: 4.3+

Android API: 16+

1 Change Current Input Method This value will change the Current Default Input Method.

MX: 4.3+

Android API: 16+

Input Method Class Name

Used to enter the Android Class Name of a user-defined Input Method to be made the Default Input Method.

Note: The specified Class Name is used in conjunction with the Package Name and must match the name of the class that implements an Input Method within an Android application that is already installed and that has the specified Package Name. If an attempt is made to enter a Class Name that does not match an installed Input Method, an error will be returned.

Parm value input rules:

  • String with a minimum size of 1 character

Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"

Parm Name: InputMethodClassName

Requires:

  • MX: 4.3+
  • Android API: 16+

Set Default Input Method

Allows the selection of the Default Input Method (i.e. the soft keyboard). If the selected Input Method is not already enabled, this parameter will first enable it and then set it as the new default. The desired Input Method must have been previously installed and must be specified using its Android Package Name and Class Name.

Shown if: The "Input Method Action" is "Change Current Input Method"

Parm Name: InputMethodOption

Option Name Description Note Requires
1 English Sets the standard English Input Method as the Default Input Method.

MX: 4.3+

Android API: 16+

2 Japanese Sets the standard Japanese Input Method as the Default Input Method.

MX: 4.3+

Android API: 16+

3 Chinese(China) Sets the standard Chinese Input Method as the Default Input Method.

MX: 4.3+

Android API: 16+

4 User defined Input Method Sets a non-standard user-defined Input Method as the Default Input Method.

MX: 4.3+

Android API: 16+

Gear Icon Show/Hide

Controls whether the "Gear" icon is displayed in the Android Notifications panel. The Gear icon provides immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. The Notifications panel is accessed from most applications by dragging downward from the Notification/Status bar at the top of the Android screen. Hiding the Gear icon can prevent a device user from accessing those Settings and changing device behavior.

Parm Name: NotificationSettings

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to visibility of the Gear icon in the Notifications panel; any previously selected setting will be retained.

OSX: 5.1+

MX: 5.1+

1 Show Shows the Gear icon in the Notifications panel.

OSX: 5.1+

MX: 5.1+

2 Hide Hides the Gear icon in the Notifications panel.

OSX: 5.1+

MX: 5.1+

Input Method Package Name

Used to enter the Android Package Name of a user-defined Input Method to be made the Default Input Method (i.e. a soft keyboard).

Note- The specified Package Name must match the Package Name of an Input Method that is already installed. If an attempt is made to enter a Package Name that does not match an installed Input Method, an error will be returned in the Result XML document.

Parm value input rules:

  • String containing the valid Package Name of an Android application that is currently installed and that implements a valid Input Method. For example: com.mycompany.myinputmethod
  • String with a minimum size of 1 character

Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"

Parm Name: InputMethodPackageName

Requires:

  • MX: 4.3+
  • Android API: 16+

Notification Pulldown Enable/Disable

Controls whether a device user will be allowed to "pull down" the Notifications/Status bar and access the Notifications panel. Depending on the Android version, the Notifications panel displays application alerts, text messages, widgets and other notifications, and provides access to device Settings. Preventing access to the Notification Pulldown can prevent a device user from accessing device Settings and other system objects that might allow a user to change system behavior or navigate away from the current application.

Parm Name: NotificationPullDown

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to ability of the device user to pull down the Notifications panel; any previously selected setting will be retained.

OSX: 5.1+

MX: 5.1+

1 Enable Allows the Notifications panel to be pulled down.

OSX: 5.1+

MX: 5.1+

2 Disable Prevents the Notifications panel from being pulled down.

OSX: 5.1+

MX: 5.1+

Two-Finger Quick Settings Enable/Disable

Controls whether Quick Settings can be accessed using a two-finger downward swipe gesture on some versions of Android. Quick Settings icons provide immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. Disabling Quick Settings access can prevent a device user from changing device behavior.

Note: This parameter is superseded by the "System Settings Access" parameter of Access Manager. If Reduced Access is enabled, later attempts enable Quick Settings result in failure.

Note: Superseded by the System Settings Access parameter of Access Manager. On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.

Parm Name: QuickSettings

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the accessibility of Quick Settings icons using a two-finger downward swipe; any previously selected setting will be retained.

OSX: 5.2+

MX: 5.2+

1 Enable Enables access to Quick Settings using a two-finger downward swipe.

OSX: 5.2+

MX: 5.2+

2 Disable Disables access to Quick Settings using a two-finger downward swipe.

OSX: 5.2+

MX: 5.2+

This is the On/Off switch for the on-screen Navigation Bar, which contains the BACK, HOME and RECENT soft keys. Disabling the Navigation Bar prevents the user from quitting the currently running app by means of those keys. This parameter applies only to the soft keys; it does not control capacitive or hardware keys, which can be disabled separately using the Keymapping Manager.

Also see the Recent App Button Usage parameter elsewhere on this page.

Parm Name: NavigationBarUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no setting change; any previously selected setting will be retained.

OSX: 6.2+

MX: 7.1+

1 Enable Enables the navigation soft keys (BACK, HOME and RECENT) on the screen-bound Navigation Bar to be displayed and usable.

OSX: 6.2+

MX: 7.1+

2 Disable Disables the navigation soft keys (BACK, HOME and RECENT) on the screen-bound Navigation Bar.

OSX: 6.2+

MX: 7.1+

Recent App Button Enable/Disable

Controls access to the Android Recent Apps button, which displays a list of applications recently accessed on the device and from which the user can re-launch. Note: Disabling the recent apps button prevents the user from configuring the device for multi-window operation.

Parm Name: RecentAppButtonUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no setting change; any previously selected setting is retained.

OSX: 7.2+

MX: 7.1+

1 Enable Enables the Recent Apps button, which displays a list of recently used apps that can be viewed and launched.

OSX: 7.2+

MX: 7.1+

2 Disable Disables the Recent Apps button, preventing the display and launch of recently used apps.

OSX: 7.2+

MX: 7.1+

Magnification Gesture

Controls the "Magnification gesture" setting on the device, which is found in the Accessibility section of the Android Settings Panel. By turning this feature on (option 1), triple-tapping the screen magnifies the device display (except navigation bar and keyboard).

Parm Name: MagnificationGesture

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained.

MX: 8.0+

Android API: 24+

1 Turn On Allows screen magnification by use of a touch gesture.

MX: 8.0+

Android API: 24+

2 Turn Off Prevents screen magnification by use of a touch gesture.

MX: 8.0+

Android API: 24+

Password Characters Show/Hide

Controls whether each password character is displayed briefly on the screen as it is entered; otherwise masked at all times. This parameter controls the "Security & Location" function of the Settings panel.

Parm Name: ShowPasswords

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained.

MX: 9.1+

Android API: 26+

1 Turn On Allows each password character to be displayed briefly as it is typed.

MX: 9.1+

Android API: 26+

2 Turn Off Prevents passwords from being displayed.

MX: 9.1+

Android API: 26+

Virtual Keyboard Show/Hide

Controls whether to display the virtual keyboard on the device screen while a physical keyboard is active.

Parm Name: ShowVirtualKeyBoard

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting will be retained.

MX: 8.0+

Android API: 26+

1 Show Shows the Gear icon in the Notifications panel.

MX: 8.0+

Android API: 26+

2 Hide Hides the Gear icon in the Notifications panel.

MX: 8.0+

Android API: 26+

Home Screen Wallpaper

Used to select the wallpaper image to be displayed on the device Home screen. If selecting a custom image, enter the file name and on-device path of the image using the Custom Home Wallpaper parameter.

Parm Name: SetHomeScreenWallpaper

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change device settings; any previously selected setting is retained.

MX: 10.5+

1 Restore to default Returns the home-screen wallpaper to the default for Android devices.

MX: 10.5+

2 Custom Allows selection of a user-defined image (.jpg or .png) file to be displayed on the device device Home screen.

MX: 10.5+

Custom Wallpaper

Used to enter the file name and path on the device of an image file (.jpg or .png, 126 MB max.) for display on the device Home screen.

Parm value input rules:

  • String of at least one alphanumeric character
  • Supports .jpg or .png file formats
  • 126 MB maximum file size

Shown if: Set Home Screen Wallpaper is "Custom"

Parm Name: CustomHomeWallpaper

Requires:

  • MX: 10.5+

LKI Usage Enable/Disable

Controls whether the device user can enable/disable the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. LKI features are supported on MC93 devices only.

Note: Supported on MC93 devices only.

Parm Name: SetLKI

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained.

OSX: 8.1+

MX: 9.0+

1 Turn On Allows device user to change the LKI state.

OSX: 8.1+

MX: 9.0+

2 Turn Off Prevents the device user from changing the LKI state.

OSX: 8.1+

MX: 9.0+

LKI Enable/Disable

This is the On/Off switch for the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. On most devices, the indicator is displayed in the Status Bar at the top of the screen. This parameter is accessible by the user only when SetLKI is set to "Turn On." LKI features are supported on MC93 devices only.

Note: Supported on MC93 devices only.

Parm Name: EnableLKI

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained.

OSX: 8.1+

MX: 9.0+

1 Enable Enables the Large Key Indicator (LKI) pop-up on the device.

OSX: 8.1+

MX: 9.0+

2 Disable Disables the Large Key Indicator (LKI) pop-up on the device.

OSX: 8.1+

MX: 9.0+

Status Bar Enable/Disable

This is the On/Off switch for the Android Status bar on the device, which displays notifications and system icons. When disabled (option 2), the bar is not visible on the device and cannot be accessed by any means.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

  • PS20
  • TC52
  • TC57
  • TC72
  • TC77

Note: Supported on SDM660-platform devices only.

Parm Name: StatusBarUsage

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained.

OSX: 8.1+

MX: 8.4+

Android API: 27+

1 Enable Enables the Android Status bar on the device.

OSX: 8.1+

MX: 8.4+

Android API: 27+

2 Disable Disables the Android Status bar on the device.

OSX: 8.1+

MX: 8.4+

Android API: 27+

On-screen Power Button Enable/Disable

This is the On/Off switch for on-screen power button that appears when long-pressing the physical power button on the device.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

  • PS20
  • TC52
  • TC57
  • TC72
  • TC77

Note: Supported on SDM660-platform devices only.

Parm Name: OnScreenPowerButton

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained.

OSX: 8.1+

MX: 8.4+

Android API: 27+

1 Enable Enables the on-screen power button to turn off the device.

OSX: 8.1+

MX: 8.4+

Android API: 27+

2 Disable Prevents the on-screen power button from turning off the device.

OSX: 8.1+

MX: 8.4+

Android API: 27+

Assistant App

Used to select a digital assistant app as the default when an assistant app is used on the device.

Parm Name: AssistApp

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.5+

1 Google Digital Assistant Selects the Google Digital Assistant app as the default when such an app is used.

MX: 10.5+

2 Custom assistant app Allows a custom digital assistant app to be selected as the default when such an app is used.

MX: 10.5+

3 None Disables digital assistant app functionality.

MX: 10.5+

Custom Assistant App Package Name

Used to enter the Android Package Name of a user-defined digital assistant app as the default when an assistant app is used on the device. Package Name must match that of an app already installed on the device.

Parm value input rules:

  • String containing a valid Package Name of an app installed on the device

Example: com.google.android.apps.assistant

Shown if: The Assistant App is "Custom"

Parm Name: CustomizeAssistApp

Requires:

  • MX: 10.5+

Examples

Configure Device Region and Keyboard


<wap-provisioningdoc>
  <characteristic type="UiMgr" version="4.3" >
    <parm name="CurrentLocale" value="en_GB"/>
    <parm name="InputMethodAction" value="1"/>
    <characteristic type="InputMethodDetails">
      <parm name="InputMethodOption" value="1"/>
    </characteristic>
  </characteristic>
</wap-provisioningdoc>

Set Enterprise Keyboard as the Default Input Method

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="InputMethodAction" value="1"/>
        <characteristic type="InputMethodDetails">
        <parm name="InputMethodOption" value="4"/>
        <parm name="InputMethodPackageName" value="com.symbol.mxmf.csp.enterprisekeyboard"/>
        <parm name="InputMethodClassName" value="com.android.inputmethod.latin.LatinIME"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

Queries

Get Current Locale

Input


 <wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="CurrentLocale"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="CurrentLocale" value="en"/>
    </characteristic>
</wap-provisioningdoc>

Get Home Key Usage

Input


<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
  <parm-query name="HomeKeyUsage"/>
</characteristic>

Output


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="HomeKeyUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Clipboard Usage

Input


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="ClipboardUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="ClipboardUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get AutoCorrect Usage

Input


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="AutoCorrectUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="AutoCorrectUsage" value ="1"/> 
    </characteristic>
</wap-provisioningdoc>

Get Paring Popup

Input


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="BluetoothPairingPopupUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="BluetoothPairingPopupUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Input Methods

Input


<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <characteristic-query type="InputMethodDetails"/>
    </characteristic>
</wap-provisioningdoc>

Output Selected Input


 <wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="InputMethodAction" value="1"/>
        <characteristic-query type="InputMethodDetails">
            <parm name="InputMethodOption" value="1"/>
        </characteristic>
    </characteristic>

Output Custom Input


<characteristic type="UiMgr" version="4.3" >
    <parm name="InputMethodAction" value="1"/>
    <characteristic type="InputMethodDetails">
        <parm name="InputMethodOption" value="4"/>
        <parm name="InputMethodPackageName" value="PackageName1"/>
        <parm name="InputMethodClassName" value="ClassName1"/>
    </characteristic>
</characteristic>

Get All Settings

Input


<wap-provisioningdoc>
    <characteristic-query type="UiMgr"/>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
  <characteristic type="UiMgr" version="4.3" >
        <parm name="CurrentLocale" value="en"/>
        <parm name="HomeKeyUsage" value="1"/>
        <parm name="ClipboardUsage" value ="1"/>
        <parm name="AutoCorrectUsage" value ="1"/> 
        <parm name="InputMethodAction" value="1"/>
        <parm name="BluetoothPairingPopupUsage" value="1"/>
        <characteristic type="InputMethodDetails">
          <parm name="InputMethodOption" value="4"/>
          <parm name="InputMethodPackageName" value="PackageName1"/>
          <parm name="InputMethodClassName" value="ClassName1"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

Get Recent App Button status

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm-query name="RecentAppButtonUsage" />
    </characteristic>
</wap-provisioningdoc>

Output (button enabled)

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Enable Navigation Bar

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Navigation Bar Status

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr">
        <parm-query name="NavigationBarUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output (Navigation Bar enabled)

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Disable Magnification Gesture

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.0" >
        <parm name="MagnificationGesture" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Hide Virtual Keyboard

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.0" >
        <parm name="ShowVirtualKeyBoard" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Enable SplitScreen Mode

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.1" >
        <parm name="SplitScreenMode" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Disable SplitScreen Mode

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.1" >
        <parm name="SplitScreenMode" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Hide passwords

<wap-provisioningdoc>
    <characteristic version="9.1" type="UiMgr">
        <parm name="ShowPasswords" value="2" />
    </characteristic>
</wap-provisioningdoc>

Show passwords

<wap-provisioningdoc>
    <characteristic version="9.1" type="UiMgr">
        <parm name="ShowPasswords" value="1" />
    </characteristic>
</wap-provisioningdoc>