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

SetDisplayLayout

Type
Function
Sender
SDL
Purpose
Set the display template for the specified application's persistent display.

Request

Parameters

Name Type Mandatory Additional
displayLayout String true maxlength: 500
appID Integer true
dayColorScheme Common.TemplateColorScheme false
nightColorScheme Common.TemplateColorScheme false

Response

Parameters

Name Type Mandatory Additional
displayCapabilities Common.DisplayCapabilities false
buttonCapabilities Common.ButtonCapabilities false array: true
minsize: 1
maxsize: 100
softButtonCapabilities Common.SoftButtonCapabilities false array: true
minsize: 1
maxsize: 100
presetBankCapabilities Common.PresetBankCapabilities false

Sequence Diagrams

Example Request

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "method" : "UI.SetDisplayLayout",
  "params" :
  {
    "displayLayout" : "NON-MEDIA",
    "appID" : 65638
  }
}

Example Response

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "result" :
  {
    "displayCapabilities" :
    {
        "displayType" : GEN2_8_DMA,
        "textFields" : [mainField1, mainField2, alertText1, alertText2, alertText3, scrollableMessageBody, initialInteractionText, navigationText1, navigationText2, audioPassThruDisplayText1, audioPassThruDisplayText2, notificationText]
        "imageFields" :
        [
          {
           "name" : "softButtonImage",
           "imageTypeSupported" : ["GRAPHIC_BMP",                       "GRAPHIC_JPEG", "GRAPHIC_PNG"],
           "imageResolution" :
            {
             "resolutionWidth" : 32,
             "resolutionHeight" : 32
            }
          },

          {
           "name" : "vrHelpItem",
           "imageTypeSupported" : ["GRAPHIC_BMP",                       "GRAPHIC_JPEG", "GRAPHIC_PNG"],
           "imageResolution" :
            {
             "resolutionWidth" : 32,
             "resolutionHeight" : 32
            }
          },

          {
           "name" : "appIcon",
           "imageTypeSupported" : ["GRAPHIC_BMP",                       "GRAPHIC_JPEG", "GRAPHIC_PNG"],
           "imageResolution" :
            {
             "resolutionWidth" : 64,
             "resolutionHeight" : 64
            }
          },
        ],

        "mediaClockFormats" : [CLOCK1, CLOCKTEXT4],
        "imageCapabilities" : [DYNAMIC],
        "graphicSupported" : true,
        "templatesAvailable" : ["DEFAULT", "MEDIA", "NON-MEDIA"],

        "screenParams" :
        {
          "resolution" :
            {
             "resolutionWidth" : 800,
             "resolutionHeight" : 480
            },

          "touchEventAvailable" :
            {
             "pressAvailable" : true,
             "multiTouchAvailable" : true,
             "doublePressAvailable" : false
            }
        },
        "numCustomPresetsAvailable" : 8
    },

    "buttonCapabilities" :
    [
      {
        "name" : OK,
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true
      },
      {
        "name" : SEEKLEFT,
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true
      },
      {
        "name" : SEEKRIGHT,
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true
      },
      {
        "name" : TUNEUP,
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true
      },
      {
        "name" : TUNEDOWN,
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true
      },
    ],

    "softButtonCapabilities" :
    [
      {
        "shortPressAvailable" : true,
        "longPressAvailable" : true,
        "upDownAvailable" : true,
        "imageSupported" : true
      }
    ],

    "presetBankCapabilities" :
    {
      "onScreenPresetsAvailable" : true
    },

    "code" : 0,
    "method" : "UI.SetDisplayLayout"
  }
}

Example Error

{
  "id" : 47,
  "jsonrpc" : "2.0",
  "error" :
  {
    "code" : 6,
    "message" : "Ignored as the requested template is already associated with the named appID",
    "data" :
    {
      "method" : "UI.SetDisplayLayout"
    }
  }
}
View on GitHub.com
Previous Section Next Section