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

Option

Name

Description

Note

Requires

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+

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+

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

Option

Name

Description

Note

Requires

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+

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+

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 determine whether "Airplane Mode" is accessible from the Android Settings panel, Quick Settings and/or from the Power-off Key menu.

Parm Name: AirplaneMode

Option	Name	Description	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 to determine whether "Airplane Mode" is accessible from the Android Settings panel, Quick Settings, and/or Power-off Key menu.	OSX: 4.3+ MX: 4.3+
2	Disable	Prevents the device user from controlling whether "Airplane Mode" is accessible from the Android Settings panel, Quick Settings, and/or Power-off Key menu.	OSX: 4.3+ MX: 4.3+

Option

Name

Description

Note

Requires

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+

Enable

Allows the device user to determine whether "Airplane Mode" is accessible from the Android Settings panel, Quick Settings, and/or Power-off Key menu.

OSX: 4.3+

MX: 4.3+

Disable

Prevents the device user from controlling whether "Airplane Mode" is accessible from the Android Settings panel, Quick Settings, and/or Power-off Key menu.

OSX: 4.3+

MX: 4.3+

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

Option

Name

Description

Note

Requires

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+

Enable

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

OSX: 4.2+

MX: 4.2+

Disable

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

OSX: 4.2+

MX: 4.2+

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	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 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 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 MX: 8.1+ Android API: 24+

Option

Name

Description

Note

Requires

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

MX: 8.1+

Android API: 24+

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

MX: 8.1+

Android API: 24+

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

MX: 8.1+

Android API: 24+

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

Option

Name

Description

Note

Requires

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+

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+

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+

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

Option

Name

Description

Note

Requires

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+

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+

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

Option

Name

Description

Note

Requires

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+

Enable

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

OSX: 7.4+

MX: 7.2+

Android API: 24+

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>