OnAppPermissionChanged

Type

Notification

Sender

SDL

Purpose

Inform HMI that permissions have changed for a specified application.

Notification from SDL to HMI occurs when application permissions were changed. If no permission specified means that application was disallowed and has to be unregistered.

Must

1. Request the list of permissions per app for which the consent is required (via GetListOfPermissions) when HMI gets the 'user-consent-required' notification per app from SDL (SDL.OnAppPermissionChanged{appID, appPermissionsConsentNeeded: true}).
2. Request Policies Manager for the appropriate user-friendly message from Local PT (SDL.GetUserFriendlyMessage) to communicate about permissions changed when HMI gets the list of permissions that require User's consent.

It is app’s responsibility to inform the user to change the app’s settings if user consent is needed for proper app operation.
Any permissions that require user consent are not enabled until a user accepts them. If permissions do not require user consent, they can be applied immediately.

SDL Note:

1. SDL sends the list of RequestTypes allowed by Policies via OnAppPermissionChanged API. In case HMI will use any of requestTypes disallowed by PolicyTable, SDL will ignore such notifications.
2. SDL PoliciesManager must send OnAppPermissionChanged (appRevoked: true, appID)and BC.ActivateApp (NONE) to HMI, in case the <appID> application is currently registered and in any HMILevel and in result of PTU <appID> gets "null" policies.
3. If app permissions were reduced after PTU, SDL sends OnAppPermissionChanged (isAppPermissionsRevoked: true) when app is in FULL or LIMITED. SDL doesn't notify HMI about revoked permissions twice.
4. In case the Local PT is successfully updated AND there are new application permissions that require User's consent, Policies Manager must:
   4.1. notify HMI about 'user-consent-required' via SDL.OnAppPermissionChanged{appID, appPermissionsConsentNeeded: true} per each application in FULL/LIMITED that lacks the User's permissions right after Policies Manager detects the user-disallowed permissions in Local PT.
   4.2. notify HMI about 'user-consent-required' SDL.OnAppPermissionChanged{appID, appPermissionsConsentNeeded: true} after the related app is activated on HMI (in case the related app is now in BACKGROUND /NONE HMILevel).
5. In case the Local PT is successfully updated AND there are new permissions that require User's consent, Policies Manager must:
   5.1. notify HMI about 'user-consent-required' via SDL.OnAppPermissionChanged{appID, appPermissionsConsentNeeded: true} per each application that lacks the User's permissions.
   5.2. provide the list of permissions that require User's consent upon request from HMI via GetListOfPermissions(appID).

Notification

Parameters

Sequence Diagrams

Preconditions to the sequence:
a) SDL and HMI are started;
b) Device is connected to the System (SDL/HU) and is consented by the User;
c) Four apps are registered with SDL and HMI ('name_HMILevel'): app_FULL, app_LIMITED, app_BACKGROUND, app_NONE.

JSON Message Examples

Example Notification

{
  "jsonrpc" : "2.0",
  "method" : "SDL.OnAppPermissionChanged",
  "params" :  
  {
    "appID" : 65674
  }
}