Contents

CPTemplateApplicationDashboardScene

A CarPlay scene that controls your app’s dashboard navigation window.

Declaration

class CPTemplateApplicationDashboardScene

Overview

A dashboard scene manages the display of your navigation app’s dashboard window on the CarPlay Dashboard, and notifies its delegate—an object that conforms to CPTemplateApplicationDashboardSceneDelegate—about scene life-cycle events. Use the dashboard controller the scene provides to supply shortcut buttons to display when there’s no active navigation session, further customizing you app’s presence on the CarPlay Dashboard.

You don’t create an instance of the dashboard scene directly. Instead, you specify the name of the class as part of the CarPlay Dashboard scene configuration that you add to your Info.plist file—see the example below—or that you return from your app delegate’s application(_:configurationForConnecting:options:) method.

<key>CPTemplateApplicationDashboardSceneSessionRoleApplication</key>
<array> 
    <dict>
        <!-- Specify the name of the CarPlay Dashboard scene class. -->
        <key>UISceneClassName</key>
        <string>CPTemplateApplicationDashboardScene</string>
        <key>UISceneConfigurationName</key>
        <string>MyCarPlayDashboardSceneConfiguration</string> 
        <key>UISceneDelegateClassName</key>
        <string>MyCarPlayDashboardSceneDelegate</string> 
    </dict>
</array>

Topics

Responding to the Dashboard Scene Life Cycle

Accessing the Dashboard Controller

Accessing the Dashboard Window

See Also

Navigation