Settings Manager

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

Input fields accept ENGLISH ONLY.

Queries are not supported on Zebra devices running Android 11 or later.

EMDK For Xamarin - 6.0

Overview

The Settings Manager (SettingsMgr) controls access to specific device capabilities in the Android System Settings panel. This allows administrators to prevent device users from changing settings that are sensitive in nature or could lead to undesired results. See AccessMgr for other Settings panel feature restrictions. Use AppMgr to prevent access to the Settings panel entirely.

Important Note

Settings Manager controls only access to settings in the Android Settings panel; it does not control or change the settings themselves. For example, if the state of Wi-Fi is "off" on a device (as set using the Wi-Fi Manager CSP), using Settings Manager to disable access to Wi-Fi settings prevents a user from changing the Wi-Fi state to "on" and potentially connecting the device to a network.

Main Functionality

  • Enable/Disable access to:
    • Enterprise Reset function
    • Wi-Fi settings
    • Device Tethering and Hotspot settings
    • Installing apps from "unknown sources" (other than the Google Play store)
    • Display of Airplane Mode control in Settings panel, Quick Settings or Power-off menu
    • Android App Manager, which can effect installed and running applications
    • Notification messages and app notification settings
    • Android Settings "slide-out drawer" (Android 7.x Nougat only)
    • User aceees to set/change an app's role

Wi-Fi Access

Controls whether the device user can access Wi-Fi settings through the Android Settings panel or Quick Settings control. Note: This parameter does not change Wi-Fi settings.

Parm Name: WifiSettingsUI

Option Name Description Note Status 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: 4.3+

MX: 4.3+

1 Enable Allows the device user to access and make changes to the Wi-Fi configuration settings from the Android Settings panel or Quick Settings controls.

OSX: 4.3+

MX: 4.3+

2 Disable Prevents the device user from accessing or making changes to the Wi-Fi configuration from the System Settings Menu or Quick Settings controls.

OSX: 4.3+

MX: 4.3+

Unknown Sources Access

Controls whether the device user can access the section of the Android Settings panel that controls the ability to install applications from sources other than the Google Play store.

Note: Support discontinued on devices running MX 9.0 or later.

Status: Deprecated. This feature will be discontinued in devices running Android 13 and later.

Parm Name: UnknownSources

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

OSX: 4.3+

MX: 4.3+

1 Enable Allows the device user access to the "Unknown Sources" option in the Android Settings panel for app installation.

OSX: 4.3+

MX: 4.3+

2 Disable Prevents the device user from accessing the "Unknown Sources" option in the Android Settings panel for app installation.

OSX: 4.3+

MX: 4.3+

Airplane Mode Access

Controls whether the device user can access "Airplane Mode" from the Android Settings and Quick Settings panels, and from the "Power Off" menu on devices running Android 5.x Marshmallow and older. When a device enters Airplane Mode, its Bluetooth, cellular and Wi-Fi radios are turned off; Bluetooth and Wi-Fi radios can be turned back on if desired by the user. See Power Key Manager for controlling Airplane mode access from the Power Off menu.

Note: The Power Off menu is not configurable on Nougat devices using this parameter. See Power Key Manager.

Status: In devices running Android 13 and later, this feature can be accessed through StageNow and compatible EMM systems, or using Android Device Policy Manager (DPM) APIs.

Parm Name: AirplaneMode

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

OSX: 4.3 - 8.0

MX: 4.3+

1 Enable Allows the device user to access "Airplane Mode" feature from the Android Settings and Quick Settings panels and the Power Off menu (on devices that support it).

OSX: 4.3 - 8.0

MX: 4.3+

2 Disable Prevents the device user from accessing "Airplane Mode" feature from the Android Settings and Quick Settings panels and the Power Off menu (on devices that support it).

OSX: 4.3 - 8.0

MX: 4.3+

Tethering and Hotspot Access Enable/Disable

Controls whether the device user can access tethering and Wi-Fi hotspot settings through the Android Settings panel or Quick Settings control. If tethering and/or hotspot features are disabled on the device, setting this parameter to "Disabled" (option 2) prevents the user from enabling them. Note: This parameter does not change tethering or hotspot settings.

Parm Name: TetheringandPortableHotspot

Option Name Description Note Status 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: 7.6+

MX: 8.1+

Android API: 24+

1 Enable Allows the device user to access and make changes to device tethering and Wi-Fi hotspot features through the Android Settings panel.

OSX: 7.6+

MX: 8.1+

Android API: 24+

2 Disable Prevents the device user from accessing device tethering and Wi-Fi hotspot features through the Android Settings panel.

OSX: 7.6+

MX: 8.1+

Android API: 24+

Slide-out Drawer Enable/Disable

This is the On/Off switch for the Android Settings "slide-out drawer," a Nougat-only feature that presents the Settings Panel when swiping right from the left side of the screen from some apps on devices running Android 7.x. Not supported on SDM660-platform devices.

Note: Applies only to devices running Android 7.x Nougat; not supported on the SDM660 platform.

Parm Name: SlideOutDrawer

Option Name Description Note Status 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: 7.8, 7.9 ONLY

NOT IN OSX 8.0 OR LATER

MX: 8.1+

Android API: 24+

1 Enable Allows the device user to access Android settings from the Settings slide-out drawer.

OSX: 7.8, 7.9 ONLY

NOT IN OSX 8.0 OR LATER

MX: 8.1+

Android API: 24+

2 Disable Prevents the device user from accessing Android settings using the Settings slide-out drawer.

OSX: 7.8, 7.9 ONLY

NOT IN OSX 8.0 OR LATER

MX: 8.1+

Android API: 24+

Enterprise Reset Access

Controls whether the device user can access the "Enterprise Reset" function of the Android Settings panel. An Enterprise Reset is intended to return the device to an enterprise-defined default state, generally as determined by the contents of the /enterprise partition on the device.

This parameter does not perform an Enterprise Reset; it controls the device user's ability to do so. An Enterprise Reset can cause data loss. For more information, see Power Manager.

Status: In devices running Android 13 and later, this feature can be accessed through StageNow and compatible EMM systems, or using Android Device Policy Manager (DPM) APIs.

Parm Name: InvokeEnterpriseReset

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

OSX: 4.2+

MX: 4.2+

1 Enable Allows the device user to invoke the "Enterprise Reset" function from the Android Settings panel.

OSX: 4.2+

MX: 4.2+

2 Disable Prevents the device user from invoking the "Enterprise Reset" function on the Android Settings panel.

OSX: 4.2+

MX: 4.2+

App Manager Access

Controls whether the device user is allowed to access the "Apps" section of the Android Settings panel, and potentially effect installed and running applications.

Parm Name: AccessAppsSection

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

OSX: 4.4+

MX: 4.4+

1 Enable Allows the device user to access and make changes in the "Apps" section of the Android Settings panel.

OSX: 4.4+

MX: 4.4+

2 Disable Prevents the device user from accessing the "Apps" section of the Android Settings panel.

OSX: 4.4+

MX: 4.4+

App Notification Control

Controls whether the device user can change the notification setting for an application by long-pressing one of its notification messages. Supported only on devices running Android Nougat and higher.

See AccessMgr to restrict other methods of accessing app notification controls.

Parm Name: AppNotificationControlUsage

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

OSX: 7.4+

MX: 7.2+

Android API: 24+

1 Enable Enables the device user to control app notification settings through a notification message.

OSX: 7.4+

MX: 7.2+

Android API: 24+

2 Disable Prevents the device user from changing app notification settings through a notification message.

OSX: 7.4+

MX: 7.2+

Android API: 24+

App Role Access Enable/Disable

Controls whether the device user can set and/or change the default app used for a given role of an app, such as for making and taking calls or browsing the web.

Parm Name: EnableDisableRole

Option Name Description Note Status 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: 11.4+

Android API: 30+

1 Enable for Dialer Allows the device user to change the app used for initiating and answering calls.

MX: 11.4+

Android API: 30+

2 Disable for Dialer Prevents the device user from changing the app used for initiating and answering calls.

MX: 11.4+

Android API: 30+

3 Enable for Browser Allows the device user to change the app used for viewing web pages.

MX: 11.5+

Android API: 30+

4 Disable for Browser Prevents the device user from changing the app used for viewing web pages.

MX: 11.5+

Android API: 30+

Examples

Query Everything

Queries are not supported on Zebra devices running Android 11 or later.

Input


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

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="InvokeEnterpriseReset" value="1"/>
        <parm name="WifiSettingsUI" value="1"/>
        <parm name="UnknownSources" value="1"/>
        <parm name="AirplaneMode" value="1"/>
        <parm name="AccessAppsSection" value="1"/>
    </characteristic>   
</wap-provisioningdoc>

Query if Invoking Enterprise Reset is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="InvokeEnterpriseReset"/>
    </characteristic>
</wap-provisioningdoc>

Output


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

Query if Changing Wi-Fi Configuration is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="WifiSettingsUI"/>
    </characteristic>
</wap-provisioningdoc>

Output


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

Query if Changing Unknown Sources is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="UnknownSources"/>
    </characteristic>
</wap-provisioningdoc>

Output


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

Query if Changing Airplane Mode is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="AirplaneMode"/>
    </characteristic>
</wap-provisioningdoc>

Output


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

Query if Accessing Apps Section is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="AccessAppsSection"/>
    </characteristic>
</wap-provisioningdoc>

Output


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