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

Main Screen Templates

Each car manufacturer supports a set of templates for the user interface. These templates determine the position and size of the text, images, and buttons on the screen. A list of supported templates is sent in SDLManager.systemCapabilityManager.displayCapabilities.templatesAvailable.

To change a template at any time, send a SDLSetDisplayLayout RPC to the SDL Core. If you want to ensure that the new template is used, wait for a response from the SDL Core before sending any more user interface RPCs.

Objective-C
SDLSetDisplayLayout* display = [[SDLSetDisplayLayout alloc] initWithPredefinedLayout:SDLPredefinedLayoutGraphicWithText];
[self.sdlManager sendRequest:display withResponseHandler:^(SDLRPCRequest *request, SDLRPCResponse *response, NSError *error) {
    if ([response.resultCode isEqualToEnum:SDLResultSuccess]) {
      // The template has been set successfully
    }
}];
Swift
let display = SDLSetDisplayLayout(predefinedLayout: .graphicWithText)
sdlManager.send(request: display) { (request, response, error) in
    if response?.resultCode == .success {
        // The template has been set successfully
    }
}

Available Templates

There are fifteen standard templates to choose from, however some head units may only support a subset of these templates. Please check SystemCapabilityManager for the supported templates. The following examples show how templates will appear on the Generic HMI and Ford's SYNC 3 HMI.

Media - with and without progress bar
Generic HMI

Media

Ford HMI

Media - with progress bar

Media - without progress bar

Non-Media - with and without soft buttons
Generic HMI

Non-Media

Ford HMI

Non-Media - with soft buttons

Non-Media - without soft buttons

GRAPHIC_WITH_TEXT
Ford HMI

Graphic with Text

TEXT_WITH_GRAPHIC
Ford HMI

Text with Graphic

TILES_ONLY
Ford HMI

Tiles Only

GRAPHIC_WITH_TILES
Ford HMI

Graphic with Tiles

TILES_WITH_GRAPHIC
Ford HMI

Tiles with Graphic

GRAPHIC_WITH_TEXT_AND_SOFTBUTTONS
Ford HMI

Graphic with Text and Softbuttons

TEXT_AND_SOFTBUTTONS_WITH_GRAPHIC
Ford HMI

Text and Softbuttons with Graphic

GRAPHIC_WITH_TEXTBUTTONS
Ford HMI

Graphic with Textbuttons

DOUBLE_GRAPHIC_SOFTBUTTONS
Ford HMI

Double Graphic and Softbuttons

TEXTBUTTONS_WITH_GRAPHIC
Ford HMI

Textbuttons with Graphic

TEXTBUTTONS_ONLY
Ford HMI

Textbuttons Only

LARGE_GRAPHIC_WITH_SOFTBUTTONS
Generic HMI

Large Graphic with Softbuttons

Ford HMI

Large Graphic with Softbuttons

LARGE_GRAPHIC_ONLY
Generic HMI

Large Graphic Only

Ford HMI

Large Graphic Only

View on GitHub.com
Previous Section Next Section