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

SDLChoice Class Reference

Section Contents

Overview

A choice is an option which a user can select either via the menu or via voice recognition (VR) during an application initiated interaction.

Since SmartDeviceLink 1.0

-initWithId:menuName:vrCommands:

Undocumented

Objective-C

- (instancetype)initWithId:(UInt16)choiceId menuName:(NSString *)menuName vrCommands:(nullable NSArray<NSString *> *)vrCommands;

Swift

init(id choiceId: UInt16, menuName: String, vrCommands: [String]?)

-initWithId:menuName:vrCommands:image:secondaryText:secondaryImage:tertiaryText:

Undocumented

Objective-C

- (instancetype)initWithId:(UInt16)choiceId menuName:(NSString *)menuName vrCommands:(nullable NSArray<NSString *> *)vrCommands image:(nullable SDLImage *)image secondaryText:(nullable NSString *)secondaryText secondaryImage:(nullable SDLImage *)secondaryImage tertiaryText:(nullable NSString *)tertiaryText;

Swift

init(id choiceId: UInt16, menuName: String, vrCommands: [String]?, image: SDLImage?, secondaryText: String?, secondaryImage: SDLImage?, tertiaryText: String?)

choiceID

The application-scoped identifier that uniquely identifies this choice

Required, Integer 0 - 65535

Objective-C

@property (readwrite, strong, nonatomic) NSNumber<SDLInt> *_Nonnull choiceID;

Swift

var choiceID: NSNumber & SDLInt { get set }

menuName

Text which appears in menu, representing this choice

Required, Max string length 500 chars

Objective-C

@property (readwrite, strong, nonatomic) NSString *_Nonnull menuName;

Swift

var menuName: String { get set }

vrCommands

VR synonyms for this choice

Optional, Array of Strings, Array length 1 - 100, Max String length 99 chars

@discussion, VR commands are optional beginning with SDL Core v.5.0. They are required for previous versions.

Objective-C

@property (readwrite, strong, nonatomic, nullable)
    NSArray<NSString *> *vrCommands;

Swift

var vrCommands: [String]? { get set }

image

The image of the choice

Optional

Objective-C

@property (readwrite, strong, nonatomic, nullable) SDLImage *image;

Swift

var image: SDLImage? { get set }

secondaryText

Secondary text to display; e.g. address of POI in a search result entry

Optional, Max String length 500 chars

Objective-C

@property (readwrite, strong, nonatomic, nullable) NSString *secondaryText;

Swift

var secondaryText: String? { get set }

tertiaryText

Tertiary text to display; e.g. distance to POI for a search result entry

Optional, Max String length 500 chars

Objective-C

@property (readwrite, strong, nonatomic, nullable) NSString *tertiaryText;

Swift

var tertiaryText: String? { get set }

secondaryImage

Secondary image for choice

Optional

Objective-C

@property (readwrite, strong, nonatomic, nullable) SDLImage *secondaryImage;

Swift

var secondaryImage: SDLImage? { get set }
View on GitHub.com
Previous Section Next Section