Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search
Documentation
Sidebar

OnAppPermissionConsent

Notification

Type
Notification
Sender
HMI
Purpose
Inform about the User permission changes for some functionality for the named application.

Initiated by HMI for specifying the allowance for the application to perform some functionality.The notification informs Policy Manager about some changes in application permissions, that effect application behavior on HMI.

Must

1) send OnAppPermissionConsent when User answers to prompt about app's permisstions consent.
2) send OnAppPermissionConsent when User enters settings menu and allows/disallows app's permissions.
3) use the pair of values id<->name in PermissionItem structure which were obtained via GetListOfPermissions response
4) send OnAppPermissionConsent when User changes ExternalConsentStatus.

SDL information:
PoliciesManager applies the changes to all applications in case OnAppPermissionConsent is received without <appID> parameter.
PoliciesManager applies the changes received via OnAppPermissionConsent according to its internal rules (update appropriate application permissions sections in the policies database etc).

Note

a) SDL ignores all invalid notifications which come from HMI (invalid JSON, invalid data types/bounds etc).
b) ExternalConsentStatus either user_dissalows or user_allows applications functional groupings depending on predefined settings in policy table.
c) SDL uses OnAppPermissionConsent value (ON/OFF) received from HMI through ignition cycles until this value is changed by corresponding notification from HMI.

Parameters

Name Type Mandatory Additional
appID Integer false
consentedFunctions Common.PermissionItem false array: true
minsize: 1
maxsize: 100
ExternalConsentStatus Common.ExternalConsentStatus false array: true
minsize: 1
maxsize: 100
source Common.ConsentSource true

Sequence Diagrams

JSON Example Notification

{
    "jsonrpc" : "2.0",
    "method" : "SDL.OnAppPermissionConsent",
    "params" :  
    {
    "appID":13759,
    "consentedFunctions":[
     {"allowed":false,
      "id":4734356,
      "name":"DrivingCharacteristics"
     }],
    "source":"GUI"
    }}
View on GitHub.com
Previous Section Next Section