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
To Top Created with Sketch. To Top
To Bottom Created with Sketch. To Bottom
HMI Documentation
SetAppProperties

SetAppProperties

Type
Function
Sender
HMI
Purpose
Enable/disable an application and set authentication data
Must
  1. Send SetAppProperties (enabled=true) to install a web engine app.
May
  • Send an UpdateSDL RPC after setting app properties to force SDL to perform a PTU.
  • Send SetAppProperties (enabled=false) to add web engine apps to SDL that won't be installed on the HMI
Note
  • The OEM store uses app data in SDL Server (synchronized from SHAID) for SetAppProperties.
  • If SDL does not know the appID it should trigger a PTU.

Request

Parameters

Name Type Mandatory Additional
properties Common.AppProperties true

Response

Parameters

This RPC has no additional parameter requirements

Sequence Diagrams

JSON Message Examples

Example Request

{
  "id":47,
  "jsonrpc": "2.0",
  "method" : "BasicCommunication.SetAppProperties",
  "params" : {
    "properties": 
        {
          "nicknames": [
            "Hello Sdl"
          ],
          "policyAppID": "123456",
          "enabled": true,
          "transportType": "WS",
          "hybridAppPreference": "CLOUD"
        }
  }
}

Example Response

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "result" : {
    "code" : 0,
    "method" : "BasicCommunication.SetAppProperties"
  }
}

Example Error

{
  "id": 47,
  "jsonrpc": "2.0",
  "error": {
    "code": 11,
    "message": "Invalid data",
    "data": {
      "method": "BasicCommunication.SetAppProperties"
    }
  }
}
View on GitHub.com
Previous Section Next Section