SDLLockScreenConfiguration Class Reference

displayMode

Describes when the lock screen will be displayed. Defaults to SDLLockScreenConfigurationDisplayModeRequiredOnly.

Objective-C

@property (nonatomic) SDLLockScreenConfigurationDisplayMode displayMode;

Swift

var displayMode: SDLLockScreenConfigurationDisplayMode { get set }

enableDismissGesture

If YES, then the lock screen can be dismissed with a downward swipe on compatible head units. Requires a connection of SDL 6.0+ and the head unit to enable the feature. Defaults to YES.

Objective-C

@property (nonatomic) BOOL enableDismissGesture;

Swift

var enableDismissGesture: Bool { get set }

showDeviceLogo

If YES, then the lockscreen will show the vehicle’s logo if the vehicle has made it available. If NO, then the lockscreen will not show the vehicle logo. Defaults to YES.

Objective-C

@property (nonatomic) BOOL showDeviceLogo;

Swift

var showDeviceLogo: Bool { get set }

backgroundColor

The background color of the lock screen. This could be a branding color, or leave at the default for a dark blue-gray.

Objective-C

@property (nonatomic, copy, readonly) UIColor *_Nonnull backgroundColor;

Swift

@NSCopying var backgroundColor: UIColor { get }

appIcon

Your app icon as it will appear on the lock screen.

Objective-C

@property (nonatomic, copy, readonly, nullable) UIImage *appIcon;

Swift

@NSCopying var appIcon: UIImage? { get }

customViewController

A custom view controller that the lock screen will manage the presentation of.

Objective-C

@property (nonatomic, strong, readonly, nullable) UIViewController *customViewController;

Swift

var customViewController: UIViewController? { get }

-init

Initializer unavailable

Objective-C

- (nonnull instancetype)init;

+disabledConfiguration

Use this configuration if you wish to manage a lock screen yourself. This may be useful if the automatic presentation feature of SDLLockScreenManager is failing for some reason.

Objective-C

+ (nonnull instancetype)disabledConfiguration;

Swift

class func disabled() -> Self

+enabledConfiguration

Use this configuration for the basic default lock screen. A custom app icon will not be used.

Objective-C

+ (nonnull instancetype)enabledConfiguration;

Swift

class func enabled() -> Self

+enabledConfigurationWithAppIcon:backgroundColor:

Use this configuration to provide a custom lock screen icon and a custom background color, or nil if you wish to use the default background color. This will use the default lock screen layout.

Objective-C

+ (nonnull instancetype)
    enabledConfigurationWithAppIcon:(nonnull UIImage *)lockScreenAppIcon
                    backgroundColor:
                        (nullable UIColor *)lockScreenBackgroundColor;

Swift

class func enabledConfiguration(withAppIcon lockScreenAppIcon: UIImage, backgroundColor lockScreenBackgroundColor: UIColor?) -> Self

Parameters

lockScreenAppIcon

The app icon to be shown on the lock screen

lockScreenBackgroundColor

The color of the lock screen background

+enabledConfigurationWithViewController:

Use this configuration if you wish to provide your own view controller for the lock screen. This view controller’s presentation and dismissal will still be managed by the lock screen manager. Note that you may subclass SDLLockScreenViewController and pass it here to continue to have the vehicle icon set to your view controller by the manager.

Objective-C

+ (nonnull instancetype)enabledConfigurationWithViewController:
    (nonnull UIViewController *)viewController;

Swift

class func enabledConfiguration(with viewController: UIViewController) -> Self

Parameters

viewController

The view controller to be managed