Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search
Internet Explorer alert
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.
close alert
US
JP
US
JP
To Top Created with Sketch. To Top
To Bottom Created with Sketch. To Bottom
HMI Documentation
OnAppPermissionConsent

OnAppPermissionConsent

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 the Policy Manager about some changes in application permissions that affect application behavior on HMI.

Must

1) Send OnAppPermissionConsent when user answers to prompt about app's permissions 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.

Note
  • 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_disallows 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.

Notification

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

Sequence Diagram

OnAppPermissionConsent

View Diagram
Sequence Diagram

OnAppPermissionConsent (id<->name dependency)

View Diagram

JSON Message Examples

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