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
ActivateApp

ActivateApp

Type
Function
Sender
SDL
Purpose
Request HMI to bring a specific app to the front (aka HMI level FULL)
Note

The activated application is assumed to receive access to the head unit's display, audio and control system which are:
* Supported by the head unit and
* Confirmed to be supported via responses to IsReady requests sent by SDL for the corresponding component

In the case of a successful HMILevel resumption, SDL will first assign a 'default_hmi' level from policies with a 3 second timeout, before resuming the application to either FULL or LIMITED.

If the HMI receives ActivateApp it can be assumed that the HMI has also already been provided with detailed information about the application through the OnAppRegistered RPC

May

This request may be sent:
* After SDL restores the application's state saved during a previous ignition off

Behavior

If level is FULL or LIMITED:

Must
  1. Activate the application on the HMI
  2. Display UI.Show related parameters associated with the named appID in the case they were previously requested within ignition cycle
  3. Display the corresponding template in the case one was previously requested by UI.Show for that application
  4. Apply UI.SetGlobalProperties associated with the named appID, if any
  5. Apply UI.AddSubMenu associated with the named appID, if any
  6. Display the web page view in the main window of the application, in case the application AppHMIType is WEB_VIEW and a template has not yet been set.
  7. Make VR commands accessible from previous VR.AddCommand for the named appID during the same ignition cycle
  8. Apply TTS.SetGlobalProperties associated with the appID in case previously requested since application registration
  9. Assign priority based on the priority parameter received. If the parameter is omitted, the HMI must assign a priority of NONE by default
  10. Respond with SUCCESS result code after the previous requirements have been met
  11. Set up the application as the active audio source if it is a media or navigation type application

Request

Parameters

Name Type Mandatory Description
appID Integer true
priority Common.AppPriority false
level Common.HMILevel false Included if the HMI level of this application should be changed to anything other than FULL. Should not be NONE.

Response

Parameters

This RPC has no additional parameter requirements

Sequence Diagrams

Sequence Diagram

Activate App after successful Resumption

View Diagram
Sequence Diagram

Activate App after failed Resumption

View Diagram
Sequence Diagram

Activate App after Unexpected Disconnect

View Diagram
Sequence Diagram

Activate App after Accepted Data Consent Prompt

View Diagram

JSON Message Examples

Example Request 

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "method" : "BasicCommunication.ActivateApp",
  "params" :
  {
    "appID" : 65368
  }
}

Example Response 

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

Example Error 

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "error" :
  {
    "code" : 13,
    "message" : "One of the provided IDs is not valid.",
    "data" :
    {
      "method" : "BasicCommunication.ActivateApp"
    }
  }
}
View on GitHub.com
Previous Section Next Section