Settings Manager

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

EMDK For Xamarin - 5.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.

Note: Settings Manager controls only access to settings in the Android Settings panel; it does not control the settings themselves. For example, if Wi-Fi is disabled on a device (through the Wi-Fi Manager CSP), using Settings Manager to disable access to Wi-Fi settings prevents a user from turning Wi-Fi on. Conversely, if Wi-Fi is enabled on a device, using Settings Manager to block access to its settings prevents a user from turning it off or changing any of its configuration settings.

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)

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 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.

Parm Name: UnknownSources

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 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+

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 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 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 HIGHER

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 HIGHER

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 HIGHER

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. Note: This parameter does not perform an Enterprise Reset.

An Enterprise Reset can cause data loss. For more information, see Power Manager.

Parm Name: InvokeEnterpriseReset

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

Airplane Mode Access

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

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

Parm Name: AirplaneMode

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 device; any previously selected setting is retained.

OSX: 4.3 - 8.0

MX: 4.3+

1 Enable Allows the device user to determine whether "Airplane Mode" is accessible from the Android Settings and Quick Settings panels and the Power Off menu (on some devices).

OSX: 4.3 - 8.0

MX: 4.3+

2 Disable Prevents the device user from controlling whether "Airplane Mode" is accessible from the Android Settings and Quick Settings panels and the Power Off menu (on some devices).

OSX: 4.3 - 8.0

MX: 4.3+

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 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 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+

Examples

Query Everything

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>