SmartDeviceLink - HMI Documentation

Show

Type: Function
Sender: SDL
Purpose: Update fields displayed on the HMI for the specified application.

Request

Parameters

Name	Type	Mandatory	Additional
showStrings	Common.TextFieldStruct	true	array: true minsize: 0 maxsize: 8
alignment	Common.TextAlignment	false
graphic	Common.Image	false
secondaryGraphic	Common.Image	false
softButtons	Common.SoftButton	false	array: true minsize: 0 maxsize: 8
customPresets	String	false	array: true minsize: 0 maxsize: 10 maxlength: 500
appID	Integer	true
windowID	Integer	false
templateConfiguration	Common.TemplateConfiguration	false

Response

Parameters

This RPC has no additional parameter requirements

Sequence Diagrams

Sequence Diagram

Active App shows and is deactivated then reactivated

View Diagram

Sequence Diagram

Inactive App Sends Show

View Diagram

Sequence Diagram

Show with Soft Buttons

Show Text Fields

Show Widgets

JSON Message Examples

Example Request

{
  "id" : 120,
  "jsonrpc" : "2.0",
  "method" : "UI.Show",
  "params" :
  {
    "showStrings" :
    [
      {
         "fieldName" : "mainField1",
         "fieldText" : "Favourite Album"
      },
      {
         "fieldName" : "mediaClock",
         "fieldText" : "1:45:12"
      },
      {
         "fieldName" : "mediaTrack",
         "fieldText" : "Ironic – The Collection – Alanis Morissette"
      }
    ],
    "alignment" : "LEFT_ALIGNED",
    "graphic" :
    {
         "value" : "tmp/SDL/app/Best_Media/AM-Collection-cover.png",
         "imageType" : "DYNAMIC"
    },
    "softButtons" :
    [
      {
      "type" :  "BOTH",
      "text" : "Change Album",
      "image" :
       {
         "value" : "tmp/SDL/app/Best_Media/change_alb_icon.jpg",
         "imageType" : "DYNAMIC"
       },
      "softButtonID" : 48,
      "systemAction" : "DEFAULT_ACTION"
      },

      {
      "type" :  "TEXT",
      "text" : "Change Artist",
      "softButtonID" : 57
      }
    ],
    "customPresets" : ["Like Song", "Like Album"],
    "appID" : 8726
  }
}

Example Response

{
  "id" : 120,
  "jsonrpc" : "2.0",
  "result" :
  {
    "code" : 0,
    "method" : "UI.Show"
  }
}

Example Error

{
  "id" : 120,
  "jsonrpc" : "2.0",
  "error" :
  {
    "code" : 22,
    "message" : "An unknown issue occurred ",
    "data" :
    {
      "method" : "UI.Show"
    }
  }
}

View on GitHub.com