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

OnAppUnregistered

Type
Notification
Sender
SDL
Purpose
Inform the HMI that an application has unregistered.

SDL sends this notification when:

  1. The named application has unregistered from the mobile side via an appropriate RPC.
  2. The connection and corresponding session(s) are closed due to transport connection issues (for example, WiFi/BT connection closing on mobile device, USB unplugging, etc.).
  3. A HeartBeat timeout occurs between the mobile device and SDL Core (if a HeartBeat timeout is set).
Must
  1. HMI must distinguish distinguish between an unexpected disconnect and a regular exit from the unexpectedDisconnect parameter.
  2. HMI must removed the named application from the list of registered applications.
May
  1. In case of an Unexpected Disconnect, the HMI may display a popup of some kind that reports a connection with the named app was unexpectedly lost.
  2. In case of any type of disconnect, the HMI may switch to a Home screen that displays a list of other registered applications.
  3. The HMI may delete all application data after an app disconnects, except for VRGrammars.
Note

Information about the application (name, appID, etc) is provided by SDL via BC.UpdateAppList or BC.OnAppRegistered.

Notification

Parameters

Name Type Mandatory Additional
unexpectedDisconnect Boolean true
appID Integer true

Sequence Diagrams

JSON Example Notification

{
  "jsonrpc" : "2.0",
  "method" : "BasicCommunication.OnAppUnregistered",
  "params" :
  {
    "appID" : 65539,
      "unexpectedDisconnect":"false"
  }
}
View on GitHub.com
Previous Section Next Section