System Notification Manager
Systems Notification Manager allows toggling the system notifications. This API is not threadsafe. More...
Functions
| Name | |
|---|---|
| MLResult | MLSystemNotificationManagerCreate(MLHandle * out_handle) Creates a System Notification Manager handle. |
| MLResult | MLSystemNotificationManagerDestroy(MLHandle handle) Destroys a System Notification Manager handle. |
| MLResult | MLSystemNotificationManagerSetNotifications(MLHandle handle, bool suppress) Request suppression/unsuppression of system notifications. |
Detailed Description
Systems Notification Manager allows toggling the system notifications. This API is not threadsafe.
Shared Object:
- system_notification_manager.magicleap*
Functions Documentation
MLSystemNotificationManagerCreate
MLResult MLSystemNotificationManagerCreate(
MLHandle * out_handle
)
Creates a System Notification Manager handle.
Parameters
| MLHandle * | out_handle | The handle to be created. |
Returns
| MLResult | MLResult_InvalidParam | Failed due to an invalid parameter. |
| MLResult | MLResult_Ok | System Notification Manager handle was successfully created. |
| MLResult | MLResult_PermissionDenied | Necessary permission is missing. |
| MLResult | MLResult_UnspecifiedFailure | System Notification Manager handle failed to be created. |
Required Permissions:
- com.magicleap.permission.SYSTEM_NOTIFICATION (protection level: normal)
Multiple calls to this API method from the same applicaiton will return the same handle. The handle is valid for the lifecycle of the application.
API Level:
- 24
MLSystemNotificationManagerDestroy
MLResult MLSystemNotificationManagerDestroy(
MLHandle handle
)
Destroys a System Notification Manager handle.
Parameters
| MLHandle | handle | The handle to be destroyed. |
Returns
| MLResult | MLResult_InvalidParam | The handle passed in was not valid. |
| MLResult | MLResult_Ok | System Notification Manager handle was successfully destroyed. |
Required Permissions:
- None
API Level:
- 24
MLSystemNotificationManagerSetNotifications
MLResult MLSystemNotificationManagerSetNotifications(
MLHandle handle,
bool suppress
)
Request suppression/unsuppression of system notifications.
Parameters
| MLHandle | handle | Handle to System Notification Manager. |
| bool | suppress | True to suppress all notifications, false to unsuppress all notifications. |
Returns
| MLResult | MLResult_IncompatibleSKU | Failed due to feature not being supported on current device version. |
| MLResult | MLResult_InvalidParam | The handle passed in was not valid. |
| MLResult | MLResult_Ok | All system notifications were successfully suppressed/unsuppressed. |
| MLResult | MLResult_UnspecifiedFailure | Suppression/Unsuppression of system notifications failed. |
Required Permissions:
- None
Requests the system to unsuppress/suppress all notifications. This includes notifications, dialogs and alarms from being displayed. Once suppressed, notifications remain suppressed even if the application requesting suppression loses focus (ie: if the user navigates away from the application).
If the calling app is closed for any reason (ie. closed by user action, voice command, terminal command, or crashed) before notifications were unsuppressed the System Notification Manager will automatically unsuppress all notficiations (unless another application was currently suppressing notifications).
API Level:
- 24