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
OnSystemCapabilityUpdated

OnSystemCapabilityUpdated

Type
Notification
Sender
SDL or HMI
Purpose
Inform that a specific system capability has changed

Notification

  1. HMI sends OnSystemCapabilityUpdated notification to SDL after creating a widget (see also CreateWindow).
  2. HMI sends OnSystemCapabilityUpdated notification after receiving UI.Show(templateConfiguration) request manipulating the content presented of main window or widgets.
  3. HMI should not send WEB_VIEW template in WindowCapability for any widgets, and applications with AppHMIType other than WEB_VIEW.
  4. If the application changes template to WEB_VIEW, HMI should send OnSystemCapabilityUpdated with the following textFields restrictions in WindowCapability:
    • menuName and templateTitle should be included, if they are visible on HMI.
    • mainField1-4, statusBar and mediaTrack should not be included if OEM implemented the WEB_VIEW template without these text fields.
    • availabletemplates, buttonCapabilities and imageTypeSupported should reflect the general capabilities of the window/system.
Note

Template WEB_VIEW is only allowed for the WebEngine applications with AppHMIType=WEB_VIEW.

Parameters

Name Type Mandatory Additional
systemCapability Common.SystemCapability true
appID Integer false

Sequence Diagrams

Sequence Diagram

OnSystemCapabilityUpdated(APP_SERVICES, PUBLISHED)

View Diagram
Sequence Diagram

OnSystemCapabilityUpdated(APP_SERVICES, REMOVED)

View Diagram

JSON Message Examples

Example Notification 

{
  "jsonrpc": "2.0",
  "method": "BasicCommunication.OnSystemCapabilityUpdated",
  "params": {
    "systemCapability": {
      "appServicesCapabilities": {
        "appServices": [
          {
            "updatedAppServiceRecord": {
              "serviceActive": true,
              "serviceID": "c9503a4f983e3dd31a7a14564d405cdf84769c9b9a71cae9cc211a0b74e93629",
              "serviceManifest": {
                "allowAppConsumers": true,
                "rpcSpecVersion": {
                  "majorVersion": 5,
                  "minorVersion": 1,
                  "patchVersion": 0
                },
                "serviceName": "Mobile Media Service",
                "serviceType": "MEDIA"
              },
              "servicePublished": true
            }
          },
          {
            "updateReason": "PUBLISHED",
            "updatedAppServiceRecord": {
              "serviceActive": false,
              "serviceID": "d6d8d2fb2bfcc00033804fb19e9fb7d6070d2c166f49881563276f17478c39f8",
              "serviceManifest": {
                "allowAppConsumers": true,
                "rpcSpecVersion": {
                  "majorVersion": 5,
                  "minorVersion": 1,
                  "patchVersion": 0
                },
                "serviceName": "Waze Music",
                "serviceType": "MEDIA"
              },
              "servicePublished": true
            }
          }
        ]
      },
      "systemCapabilityType": "APP_SERVICES"
    }
  }
}
View on GitHub.com
Previous Section Next Section