This browser is not recommended for use with smartdevicelink.com, and may not function properly. Upgrade to a different browser to guarantee support of all features.
To Top
To Bottom
AlertManeuver
- Type
- Function
- Sender
- SDL
- Purpose
- Announce a navigation maneuver.
SDL sends AlertManeuver together with TTS.Speak. The purpose of this RPC is to notify the embedded navigation system about the next navigation maneuver.
May
- Notify the user by TTS.Speak, which is sent along with
AlertManeuver. - Display the
AlertManeuverdialog with an alert icon and one of the following:- Up to three soft buttons defined within the
softButtonsparameter. - HMI-defined
Closesoft button if a request withoutsoftButtonsis received.
- Up to three soft buttons defined within the
- Process
SystemContextbehavior forAlertManeuverin the same way anAlertis handled. - Send
BC.OnResetTimeoutnotification to SDL to reset the timeout in case HMI needs more time to process the request.
Must
UI.OnSystemContext appID rules if AlertManeuver causes SystemContext updates:
appIDshould not be sent forMENUandHMI_OBSCUREDsystem contexts. Only apps inFULLshould receive these updates.- If the HMI sends
appIDwith UI.OnSystemContext(MENUorHMI_OBSCURED),appIDis ignored and the notification is transferred to the application that is inFULL. - UI.OnSystemContext's
appIDparameter should be mandatory forMAINandALERTvalues. If noappIDis sent for this case, the notification will be ignored by SDL.
Note
If the HMI does not respond to SDL's request, after the timeout, SDL will send GENERIC_ERROR to the corresponding mobile application.
Request
Parameters
| Name | Type | Mandatory | Additional |
|---|---|---|---|
| softButtons | Common.SoftButton | false | array: true minsize: 0 maxsize: 3 |
| appID | Integer | true |
Response
Parameters
This RPC has no additional parameter requirements
Sequence Diagrams
JSON Message Examples
Example Request
{ "id": 143, "jsonrpc": "2.0", "method": "Navigation.AlertManeuver", "params": { "softButtons": [ { "type": "TEXT", "text": "Leave Onscreen", "softButtonID": 45, "systemAction": "KEEP_CONTEXT" }, { "type": "TEXT", "text": "Close", "softButtonID": 46, "systemAction": "STEAL_FOCUS" } ], "appID": 96 } }
Example Response
{ "id" : 143, "jsonrpc" : "2.0", "result" : { "code" : 0, "method" : "Navigation.AlertManeuver" } }
Example Error
{ "id" : 143, "jsonrpc" : "2.0", "error" : { "code" : 13, "message" : "The command cannot be executed because there is NO app registered with the specified appID", "data" : { "method" : "Navigation.AlertManeuver" } } }