1226
Documentation iOS Document current as of 07/31/2017 03:13 PM. SDLAbstractProtocol Class Reference Section Contents debugConsoleGroupName transport protocolDelegateTable securityManager appId -sendStartSessionWithType: -startServiceWithType: -startSecureServiceWithType:completionHandler: -sendEndSessionWithType: -endServiceWithType: -sendRPC: -sendRPC:encrypted:error: -sendRPCRequest: -sendRawData:withServiceType: -sendEncryptedRawData:onService: -sendRawDataStream:withServiceType: -sendHeartbeat -handleBytesFromTransport:

Documentation iOS SDLAbstractProtocol Class Reference

  • Upload
    others

  • View
    9

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Documentation iOS SDLAbstractProtocol Class Reference

Documentation iOSDocument current as of 07/31/2017 03:13 PM.

SDLAbstractProtocol Class Reference

Section Contents

• debugConsoleGroupName• transport• protocolDelegateTable• securityManager• appId• -sendStartSessionWithType:• -startServiceWithType:• -startSecureServiceWithType:completionHandler:• -sendEndSessionWithType:• -endServiceWithType:• -sendRPC:• -sendRPC:encrypted:error:• -sendRPCRequest:• -sendRawData:withServiceType:• -sendEncryptedRawData:onService:• -sendRawDataStream:withServiceType:• -sendHeartbeat• -handleBytesFromTransport:

Page 2: Documentation iOS SDLAbstractProtocol Class Reference

• -dispose

Overview

Undocumented

debugConsoleGroupName

Undocumented

transport

Undocumented

protocolDelegateTable

Undocumented

securityManager

Undocumented

appId

Undocumented

-sendStartSessionWithType:

Undocumented

-startServiceWithType:

Undocumented

Page 3: Documentation iOS SDLAbstractProtocol Class Reference

-startSecureServiceWithType:completionHandler:

Undocumented

-sendEndSessionWithType:

Undocumented

-endServiceWithType:

Undocumented

-sendRPC:

Undocumented

-sendRPC:encrypted:error:

Undocumented

-sendRPCRequest:

Undocumented

-sendRawData:withServiceType:

Undocumented

-sendEncryptedRawData:onService:

Undocumented

Page 4: Documentation iOS SDLAbstractProtocol Class Reference

-sendRawDataStream:withServiceType:

Undocumented

-sendHeartbeat

Undocumented

-handleBytesFromTransport:

Undocumented

-dispose

Undocumented

SDLAbstractTransport Class Reference

Section Contents

• delegate• debugConsoleGroupName• -connect• -disconnect• -sendData:• -dispose• -retryDelay

Overview

Undocumented

Page 5: Documentation iOS SDLAbstractProtocol Class Reference

delegate

Undocumented

debugConsoleGroupName

Undocumented

-connect

Undocumented

-disconnect

Undocumented

-sendData:

Undocumented

-dispose

Undocumented

-retryDelay

Undocumented

Page 6: Documentation iOS SDLAbstractProtocol Class Reference

SDLAddCommand Class Reference

Section Contents

• -init• -initWithHandler:• -initWithDictionary:• -initWithId:vrCommands:handler:• -initWithId:vrCommands:menuName:handler:• -

initWithId:vrCommands:menuName:parentId:position:iconValue:iconType:handler:• handler• cmdID• menuParams• vrCommands• cmdIcon

Overview

This class will add a command to the application’s Command Menu

SDLMenuParams

A command will be added to the end of the list of elements in the Command

Menu under the following conditions: • When a SDLCommand is added with no SDLMenuParams value provided• When a SDLMenuParams value is provided with a SDLMenuParam.position

value greater than or equal to the number of menu items currently defined inthe menu specified by the SDLMenuParam.parentID value

The set of choices which the application builds using SDLAddCommand can be

a mixture of: • Choices having only VR synonym definitions, but no SDLMenuParams

definitions • Choices having only SDLMenuParams definitions, but no VR synonym

definitions • Choices having both SDLMenuParams and VR synonym definitions

HMILevel needs to be FULL, LIMITED or BACKGROUD

Page 7: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 1.0

SeeSDLDeleteCommand SDLAddSubMenu SDLDeleteSubMenu

-init

Constructs a new SDLAddCommand object

-initWithHandler:

Construct a SDLAddCommand with a handler callback when an event occurs.

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithHandler:(SDLRPCNotificationHandler)handler;

Page 8: Documentation iOS SDLAbstractProtocol Class Reference

handler

A callback that will be called when a button event occurs for the

command

An SDLAddCommand object

-initWithDictionary:

Constructs a new SDLAddCommand object indicated by the dictionary

parameter

SWIFT

init!(handler: SDLRPCNotificationHandler!)

PARAMETERS

RETURN VALUE

Page 9: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithId:vrCommands:handler:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLAddCommand : SDLRPCRequest <SDLRequestHandler>

Page 10: Documentation iOS SDLAbstractProtocol Class Reference

-initWithId:vrCommands:menuName:handler:

Undocumented

-

initWithId:vrCommands:menuName:parentId:position:iconValue:iconType:handl

Undocumented

handler

A handler that will let you know when the button you created is subscribed.

Warning

OBJECTIVE-C

@interface SDLAddCommand : SDLRPCRequest <SDLRequestHandler>

OBJECTIVE-C

@interface SDLAddCommand : SDLRPCRequest <SDLRequestHandler>

Page 11: Documentation iOS SDLAbstractProtocol Class Reference

This will only work if you use SDLManager.

cmdID

@abstract A Unique Command ID that identifies the command

@discussion Is returned in an SDLOnCommand notification to identify the

command selected by the user

Required, Integer, 0 - 2,000,000,000

OBJECTIVE-C

@property (readwrite, copy, nonatomic) SDLRPCNotificationHandler handler;

SWIFT

var handler: SDLRPCNotificationHandler! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *cmdID;

Page 12: Documentation iOS SDLAbstractProtocol Class Reference

menuParams

@abstract a SDLMenuParams pointer which will defined the command and how

it is added to the Command Menu

@discussion If provided, this will define the command and how it is added to

the Command Menu

If null, commands will not be accessible through the HMI application menu

Optional

SWIFT

var cmdID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLMenuParams *menuParams;

SWIFT

var menuParams: SDLMenuParams! { get set }

Page 13: Documentation iOS SDLAbstractProtocol Class Reference

vrCommands

@abstract An array of strings to be used as VR synonyms for this command.

@discussion If provided, defines one or more VR phrases the recognition of any

of which triggers the SDLOnCommand notification with this cmdID

If null, commands will not be accessible by voice commands (when the user

hits push-to-talk)

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

cmdIcon

@abstract Image struct containing a static or dynamic icon

@discussion If provided, defines the image to be be shown along with a

command

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrCommands;

SWIFT

var vrCommands: NSMutableArray! { get set }

Page 14: Documentation iOS SDLAbstractProtocol Class Reference

If omitted on supported displays, no (or the default if applicable) icon will be

displayed

Optional

SDLAddCommandResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SDLAddCommandResponse is sent, when SDLAddCommand has been called

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLImage *cmdIcon;

SWIFT

var cmdIcon: SDLImage! { get set }

Page 15: Documentation iOS SDLAbstractProtocol Class Reference

Since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

SDLAddSubMenu Class Reference

Section Contents

• -init

OBJECTIVE-C

@interface SDLAddCommandResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLAddCommandResponse : SDLRPCResponse

Page 16: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -initWithId:menuName:• -initWithId:menuName:position:• menuID• position• menuName

Overview

Add a SDLSubMenu to the Command Menu

A SDLSubMenu can only be added to the Top Level Menu (i.e.a SDLSubMenu

cannot be added to a SDLSubMenu), and may only contain commands as

children

HMILevel needs to be FULL, LIMITED or BACKGROUD

Since SmartDeviceLink 1.0

see SDLDeleteSubMenu SDLAddCommand SDLDeleteCommand

-init

Constructs a new SDLAddSubMenu object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 17: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLAddSubMenu object indicated by the dictionary

parameter

dict

The dictionary to use

-initWithId:menuName:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 18: Documentation iOS SDLAbstractProtocol Class Reference

-initWithId:menuName:position:

Undocumented

menuID

@abstract a Menu ID that identifies a sub menu @discussion This value is used

in SDLAddCommand to which SDLSubMenu is the parent of the command being

added

OBJECTIVE-C

@interface SDLAddSubMenu : SDLRPCRequest

OBJECTIVE-C

@interface SDLAddSubMenu : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *menuID;

Page 19: Documentation iOS SDLAbstractProtocol Class Reference

position

@abstract a position of menu @discussion An NSNumber pointer representing

the position within the items of the top level Command Menu. 0 will insert at

the front, 1 will insert after the first existing element, etc. Position of any

submenu will always be located before the return and exit options

Notes:

• Min Value: 0; Max Value: 1000• If position is greater or equal than the number of items on top level, the

sub menu will be appended by the end• If this parameter is omitted, the entry will be added at the end of the list

SWIFT

var menuID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *position;

SWIFT

var position: NSNumber! { get set }

Page 20: Documentation iOS SDLAbstractProtocol Class Reference

menuName

@abstract a menuName which is displayed representing this submenu item

@discussion NSString which will be displayed representing this submenu item

SDLAddSubMenuResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *menuName;

SWIFT

var menuName: String! { get set }

Page 21: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

SDLAddSubMenuResponse is sent, when SDLAddSubMenu has been called

Since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLAddSubMenuResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLAddSubMenuResponse : SDLRPCResponse

Page 22: Documentation iOS SDLAbstractProtocol Class Reference

SDLAirbagStatus Class Reference

Section Contents

• -init• -initWithDictionary:• driverAirbagDeployed• driverSideAirbagDeployed• driverCurtainAirbagDeployed• passengerAirbagDeployed• passengerCurtainAirbagDeployed• driverKneeAirbagDeployed• passengerSideAirbagDeployed• passengerKneeAirbagDeployed

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

driverAirbagDeployed

Undocumented

Page 23: Documentation iOS SDLAbstractProtocol Class Reference

driverSideAirbagDeployed

Undocumented

driverCurtainAirbagDeployed

Undocumented

passengerAirbagDeployed

Undocumented

passengerCurtainAirbagDeployed

Undocumented

driverKneeAirbagDeployed

Undocumented

passengerSideAirbagDeployed

Undocumented

passengerKneeAirbagDeployed

Undocumented

Page 24: Documentation iOS SDLAbstractProtocol Class Reference

SDLAlert Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithAlertText1:alertText2:duration:• -initWithAlertText1:alertText2:alertText3:• -initWithAlertText1:alertText2:alertText3:duration:• -initWithAlertText1:alertText2:alertText3:duration:softButtons:• -initWithTTS:playTone:• -initWithTTS:alertText1:alertText2:playTone:duration:• -initWithTTS:alertText1:alertText2:alertText3:playTone:duration:• -initWithTTSChunks:playTone:• -initWithTTSChunks:alertText1:alertText2:alertText3:playTone:softButtons:• -

initWithTTSChunks:alertText1:alertText2:alertText3:playTone:duration:softButtons:• alertText1• alertText2• alertText3• ttsChunks• duration• playTone• progressIndicator• softButtons

Overview

Shows an alert which typically consists of text-to-speech message and text on

the display. At least either alertText1, alertText2 or TTSChunks need to be

provided.

• The displayed portion of the SDLAlert, if any, will persist until the specified

timeout has elapsed, or the SDLAlert is preempted

Page 25: Documentation iOS SDLAbstractProtocol Class Reference

• An SDLAlert will preempt (abort) any SmartDeviceLink Operation that is

in-progress, except an already-in-progress SDLAlert• An SDLAlert cannot be preempted by any SmartDeviceLink Operation• An SDLAlert can be preempted by a user action (button push)• An SDLAlert will fail if it is issued while another SDLAlert is in progress• Although each Alert parameter is optional, in fact each SDLAlert request

must supply at least one of the following parameters:

◦ alertText1◦ alertText2◦ alertText3◦ ttsChunks

HMILevel needs to be FULL or LIMITED.If the app has been granted function group Notification theSDLHMILevel can also be BACKGROUND

@since SDL 1.0

-init

Constructs a new SDLAlert object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 26: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLAlert object indicated by the dictionary parameter

dict

The dictionary to use

-initWithAlertText1:alertText2:duration:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 27: Documentation iOS SDLAbstractProtocol Class Reference

-initWithAlertText1:alertText2:alertText3:

Undocumented

-initWithAlertText1:alertText2:alertText3:duration:

Undocumented

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

Page 28: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithAlertText1:alertText2:alertText3:duration:softButtons:

Undocumented

-initWithTTS:playTone:

Undocumented

-

initWithTTS:alertText1:alertText2:playTone:duration:

Undocumented

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

Page 29: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithTTS:alertText1:alertText2:alertText3:playTone:duration:

Undocumented

-initWithTTSChunks:playTone:

Undocumented

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

Page 30: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithTTSChunks:alertText1:alertText2:alertText3:playTone:softButtons:

Undocumented

-

initWithTTSChunks:alertText1:alertText2:alertText3:playTone:duration:softButto

Undocumented

alertText1

@abstract The String to be displayed in the first field of the display during the

Alert

@discussion Length is limited to what is indicated in SDLRegisterAppInterface

response

If omitted, top display line will be cleared

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlert : SDLRPCRequest

Page 31: Documentation iOS SDLAbstractProtocol Class Reference

Text is always centered

Optional, Max length 500 chars

alertText2

@abstract The String to be displayed in the second field of the display during

the Alert

@discussion Only permitted if HMI supports a second display line

Length is limited to what is indicated in SDLRegisterAppInterface response

If omitted, second display line will be cleared

Text is always centered

Optional, Max length 500 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *alertText1;

SWIFT

var alertText1: String! { get set }

Page 32: Documentation iOS SDLAbstractProtocol Class Reference

alertText3

@abstract the String to be displayed in the third field of the display during the

Alert @discussion Only permitted if HMI supports a third display line

Length is limited to what is indicated in SDLRegisterAppInterface response

If omitted, third display line will be cleared

Text is always centered

Optional, Max length 500 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *alertText2;

SWIFT

var alertText2: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *alertText3;

Page 33: Documentation iOS SDLAbstractProtocol Class Reference

ttsChunks

@abstract An array which, taken together, specify what is to be spoken to the

user

Optional, Array of SDLTTSChunk, Array length 1 - 100

SeeSDLTTSChunk

SWIFT

var alertText3: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *ttsChunks;

SWIFT

var ttsChunks: NSMutableArray! { get set }

Page 34: Documentation iOS SDLAbstractProtocol Class Reference

duration

@abstract The duration of the displayed portion of the alert, in milliseconds.

@discussion After this amount of time has passed, the display fields alertText1

and alertText2 will revert to what was displayed in those fields before the alert

began.

Typical timeouts are 3 - 5 seconds

If omitted, the timeout is set to 5 seconds

Optional, Integer, 3000 - 10000

playTone

@abstract Whether the alert tone should be played before the TTS (if any) is

spoken.

@discussion If ommitted, no tone is played

Optional, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *duration;

SWIFT

var duration: NSNumber! { get set }

Page 35: Documentation iOS SDLAbstractProtocol Class Reference

progressIndicator

@abstract If supported on the given platform, the alert GUI will include some

sort of animation indicating that loading of a feature is progressing. e.g. a

spinning wheel or hourglass, etc.

Optional, Boolean

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *playTone;

SWIFT

var playTone: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *progressIndicator;

Page 36: Documentation iOS SDLAbstractProtocol Class Reference

softButtons

@abstract App defined SoftButtons.

@discussion If omitted on supported displays, the displayed alert shall not have

any SoftButtons

Optional, Array of SDLSoftButton, Array size 0 - 4

SeeSDLSoftButton

SWIFT

var progressIndicator: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *softButtons;

SWIFT

var softButtons: NSMutableArray! { get set }

Page 37: Documentation iOS SDLAbstractProtocol Class Reference

SDLAlertManeuver Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithTTS:softButtons:• -initWithTTSChunks:softButtons:• ttsChunks• softButtons

Overview

@since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

Page 38: Documentation iOS SDLAbstractProtocol Class Reference

-initWithTTS:softButtons:

Undocumented

-initWithTTSChunks:softButtons:

Undocumented

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

Page 39: Documentation iOS SDLAbstractProtocol Class Reference

ttsChunks

Undocumented

softButtons

Undocumented

SDLAlertManeuverResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

OBJECTIVE-C

@interface SDLAlertManeuver : SDLRPCRequest

Page 40: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

SDLAlertManeuverResponse is sent, when SDLAlertManeuver has been called. *

@since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLAlertManeuverResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLAlertManeuverResponse : SDLRPCResponse

Page 41: Documentation iOS SDLAbstractProtocol Class Reference

SDLAlertResponse Class Reference

Section Contents

• -init• -initWithDictionary:• tryAgainTime

Overview

Sent after SDLAlert has been sent @since SDL 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLAlertResponse : SDLRPCResponse

Page 42: Documentation iOS SDLAbstractProtocol Class Reference

tryAgainTime

Undocumented

SDLAmbientLightStatus ClassReference

Section Contents

• +valueOf:• +values• +NIGHT• +TWILIGHT_1• +TWILIGHT_2• +TWILIGHT_3

OBJECTIVE-C

@interface SDLAlertResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLAlertResponse : SDLRPCResponse

Page 43: Documentation iOS SDLAbstractProtocol Class Reference

• +TWILIGHT_4• +DAY• +UNKNOWN• +INVALID

Overview

Reflects the status of the ambient light sensor @since SDL 3.0

+valueOf:

Undocumented

+values

Undocumented

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

Page 44: Documentation iOS SDLAbstractProtocol Class Reference

+NIGHT

Undocumented

+TWILIGHT_1

Undocumented

+TWILIGHT_2

Undocumented

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

Page 45: Documentation iOS SDLAbstractProtocol Class Reference

+TWILIGHT_3

Undocumented

+TWILIGHT_4

Undocumented

+DAY

Undocumented

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

Page 46: Documentation iOS SDLAbstractProtocol Class Reference

+UNKNOWN

Undocumented

+INVALID

Undocumented

SDLAppHMIType Class Reference

Section Contents

• +valueOf:• +values• +DEFAULT

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

OBJECTIVE-C

@interface SDLAmbientLightStatus : SDLEnum

Page 47: Documentation iOS SDLAbstractProtocol Class Reference

• +COMMUNICATION• +MEDIA• +MESSAGING• +NAVIGATION• +INFORMATION• +SOCIAL• +BACKGROUND_PROCESS• +TESTING• +SYSTEM

Overview

Enumeration listing possible app hmi types.

@since SDL 2.0

+valueOf:

@abstract Convert String to AppHMIType

OBJECTIVE-C

+ (SDLAppHMIType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLAppHMIType!

Page 48: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLAppHMIType

+values

@abstract Store the enumeration of all possible SDLAppHMIType

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 49: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLAppHMIType

+DEFAULT

@abstract The App will have default rights.

SDLAppHMIType with value DEFAULT

RETURN VALUE

OBJECTIVE-C

+ (SDLAppHMIType *)DEFAULT;

SWIFT

class func `default`() -> SDLAppHMIType!

RETURN VALUE

Page 50: Documentation iOS SDLAbstractProtocol Class Reference

+COMMUNICATION

@abstract Communication type of App

SDLAppHMIType with value COMMUNICATION

+MEDIA

@abstract App dealing with Media

OBJECTIVE-C

+ (SDLAppHMIType *)COMMUNICATION;

SWIFT

class func communication() -> SDLAppHMIType!

RETURN VALUE

Page 51: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppHMIType with value MEDIA

+MESSAGING

@abstract Messaging App

OBJECTIVE-C

+ (SDLAppHMIType *)MEDIA;

SWIFT

class func media() -> SDLAppHMIType!

RETURN VALUE

OBJECTIVE-C

+ (SDLAppHMIType *)MESSAGING;

Page 52: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppHMIType with value MESSAGING

+NAVIGATION

@abstract Navigation App

SWIFT

class func messaging() -> SDLAppHMIType!

RETURN VALUE

OBJECTIVE-C

+ (SDLAppHMIType *)NAVIGATION;

SWIFT

class func navigation() -> SDLAppHMIType!

Page 53: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppHMIType with value NAVIGATION

+INFORMATION

@abstract Information App

SDLAppHMIType with value INFORMATION

RETURN VALUE

OBJECTIVE-C

+ (SDLAppHMIType *)INFORMATION;

SWIFT

class func information() -> SDLAppHMIType!

RETURN VALUE

Page 54: Documentation iOS SDLAbstractProtocol Class Reference

+SOCIAL

@abstract App dealing with social media

SDLAppHMIType with value SOCIAL

+BACKGROUND_PROCESS

Undocumented

OBJECTIVE-C

+ (SDLAppHMIType *)SOCIAL;

SWIFT

class func social() -> SDLAppHMIType!

RETURN VALUE

Page 55: Documentation iOS SDLAbstractProtocol Class Reference

+TESTING

@abstract App only for Testing purposes

SDLAppHMIType with value TESTING

OBJECTIVE-C

@interface SDLAppHMIType : SDLEnum

OBJECTIVE-C

+ (SDLAppHMIType *)TESTING;

SWIFT

class func testing() -> SDLAppHMIType!

RETURN VALUE

Page 56: Documentation iOS SDLAbstractProtocol Class Reference

+SYSTEM

@abstract System App

SDLAppHMIType with value SYSTEM

SDLAppInfo Class Reference

Section Contents

• +currentAppInfo

OBJECTIVE-C

+ (SDLAppHMIType *)SYSTEM;

SWIFT

class func system() -> SDLAppHMIType!

RETURN VALUE

Page 57: Documentation iOS SDLAbstractProtocol Class Reference

• appDisplayName• appBundleID• appVersion

Overview

Undocumented

+currentAppInfo

Undocumented

appDisplayName

Undocumented

appBundleID

Undocumented

appVersion

Undocumented

SDLAppInterfaceUnregisteredReasonClass Reference

Section Contents

• +valueOf:• +values• +IGNITION_OFF

Page 58: Documentation iOS SDLAbstractProtocol Class Reference

• +BLUETOOTH_OFF• +USB_DISCONNECTED• +REQUEST_WHILE_IN_NONE_HMI_LEVEL• +TOO_MANY_REQUESTS• +DRIVER_DISTRACTION_VIOLATION• +LANGUAGE_CHANGE• +MASTER_RESET• +FACTORY_DEFAULTS• +APP_UNAUTHORIZED

Overview

Indicates reason why app interface was unregistered. The application is being

disconnected by SDL.

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLAppInterfaceUnregisteredReason

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLAppInterfaceUnregisteredReason!

Page 59: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object for

SDLAppInterfaceUnregisteredReason

+values

@abstract Store the enumeration of all possible

SDLAppInterfaceUnregisteredReason

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 60: Documentation iOS SDLAbstractProtocol Class Reference

an array that stores all possible SDLAppInterfaceUnregisteredReason

+IGNITION_OFF

@abstract Vehicle ignition turned off.

SDLAppInterfaceUnregisteredReason with value IGNITION_OFF

RETURN VALUE

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)IGNITION_OFF;

SWIFT

class func ignition_OFF() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 61: Documentation iOS SDLAbstractProtocol Class Reference

+BLUETOOTH_OFF

@abstract Bluetooth was turned off, causing termination of a necessary

Bluetooth connection.

SDLAppInterfaceUnregisteredReason with value BLUETOOTH_OFF

+USB_DISCONNECTED

@abstract USB was disconnected, causing termination of a necessary iAP

connection.

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)BLUETOOTH_OFF;

SWIFT

class func bluetooth_OFF() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 62: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value USB_DISCONNECTED

+REQUEST_WHILE_IN_NONE_HMI_LEVEL

@abstract Application attempted SmartDeviceLink RPC request while HMILevel

= NONE. App must have HMILevel other than NONE to issue RPC requests or

get notifications or RPC responses.

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)USB_DISCONNECTED;

SWIFT

class func usb_DISCONNECTED() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 63: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value

REQUEST_WHILE_IN_NONE_HMI_LEVEL

+TOO_MANY_REQUESTS

@abstract Either too many – or too many per unit of time – requests were made

by the application.

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)REQUEST_WHILE_IN_NONE_HMI_LEVEL;

SWIFT

class func request_WHILE_IN_NONE_HMI_LEVEL() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 64: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value TOO_MANY_REQUESTS

+DRIVER_DISTRACTION_VIOLATION

@abstract The application has issued requests which cause driver distraction

rules to be violated.

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)TOO_MANY_REQUESTS;

SWIFT

class func too_MANY_REQUESTS() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)DRIVER_DISTRACTION_VIOLATION;

Page 65: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value

DRIVER_DISTRACTION_VIOLATION

+LANGUAGE_CHANGE

@abstract The user performed a language change on the SDL platform, causing

the application to need to be reregistered for the new language.

SWIFT

class func driver_DISTRACTION_VIOLATION() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)LANGUAGE_CHANGE;

Page 66: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value LANGUAGE_CHANGE

+MASTER_RESET

@abstract The user performed a MASTER RESET on the SDL platform, causing

removal of a necessary Bluetooth pairing.

SWIFT

class func language_CHANGE() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)MASTER_RESET;

SWIFT

class func master_RESET() -> SDLAppInterfaceUnregisteredReason!

Page 67: Documentation iOS SDLAbstractProtocol Class Reference

SDLAppInterfaceUnregisteredReason with value MASTER_RESET

+FACTORY_DEFAULTS

@abstract The user restored settings to FACTORY DEFAULTS on the SDL

platform.

SDLAppInterfaceUnregisteredReason with value FACTORY_DEFAULTS

RETURN VALUE

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)FACTORY_DEFAULTS;

SWIFT

class func factory_DEFAULTS() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 68: Documentation iOS SDLAbstractProtocol Class Reference

+APP_UNAUTHORIZED

@abstract The app is not being authorized to be connected to SDL.

@since SDL 2.0

SDLAppInterfaceUnregisteredReason with value APP_UNAUTHORIZED

OBJECTIVE-C

+ (SDLAppInterfaceUnregisteredReason *)APP_UNAUTHORIZED;

SWIFT

class func app_UNAUTHORIZED() -> SDLAppInterfaceUnregisteredReason!

RETURN VALUE

Page 69: Documentation iOS SDLAbstractProtocol Class Reference

SDLArtwork Class Reference

Section Contents

• +artworkWithImage:name:asImageFormat:• +persistentArtworkWithImage:name:asImageFormat:• -initWithImage:name:persistent:asImageFormat:

Overview

Undocumented

+artworkWithImage:name:asImageFormat:

Convenience Helper to create an ephemeral artwork from an image.

This is an ephemeral file, it will not be persisted through sessions / ignition

cycles. Any files that you do not know you will use in future sessions should be

created through this method. For example, album / artist artwork should be

ephemeral.

Persistent files should be created using

persistentArtworkWithImage:name:asImageFormat:

Warning

It is strongly recommended to pass the file url using an SDLFile initializer

instead of the image. If you pass the UIImage, it is loaded into memory, and will

Page 70: Documentation iOS SDLAbstractProtocol Class Reference

be dumped to a temporary file. This will create a duplicate file. Only pass a

UIImage if the image is not stored on disk.

image

The UIImage to be sent to the remote head unit

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

OBJECTIVE-C

+ (nonnull instancetype)artworkWithImage:(nonnull UIImage *)image name:(nonnull NSString *)name asImageFormat:(SDLArtworkImageFormat)imageFormat;

SWIFT

convenience init(image: Any!, name: String, as imageFormat: SDLArtworkImageFormat)

PARAMETERS

Page 71: Documentation iOS SDLAbstractProtocol Class Reference

imageFormat

Whether the image should be converted to a PNG or JPG before

transmission. Images with transparency or few colors should be PNGs.

Images with many colors should be JPGs.

An instance of this class to be passed to the file manager.

+persistentArtworkWithImage:name:asImageFormat:

Convenience Helper to create a persistent artwork from an image.

This is a persistent file, it will be persisted through sessions / ignition cycles.

You will only have a limited space for all files, so be sure to only persist files

that are required for all or most sessions. For example, menu artwork should be

persistent.

Ephemeral files should be created using

ephemeralArtworkWithImage:name:asImageFormat:

Warning

It is strongly recommended to pass the file url using an SDLFile initializer

instead of the image. If you pass the UIImage, it is loaded into memory, and will

RETURN VALUE

Page 72: Documentation iOS SDLAbstractProtocol Class Reference

be dumped to a temporary file. This will create a duplicate file. Only pass a

UIImage if the image is not stored on disk.

image

The UIImage to be sent to the remote head unit

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

OBJECTIVE-C

+ (nonnull instancetype)persistentArtworkWithImage:(nonnull UIImage *)image name:(nonnull NSString *)name asImageFormat: (SDLArtworkImageFormat)imageFormat;

SWIFT

class func persistentArtwork(withImage image: Any!, name: String, as imageFormat: SDLArtworkImageFormat) -> Self

PARAMETERS

Page 73: Documentation iOS SDLAbstractProtocol Class Reference

imageFormat

Whether the image should be converted to a PNG or JPG before

transmission. Images with transparency or few colors should be PNGs.

Images with many colors should be JPGs.

An instance of this class to be passed to the file manager.

-initWithImage:name:persistent:asImageFormat:

Create a file for transmission to the remote system from a UIImage.

RETURN VALUE

OBJECTIVE-C

- (nonnull instancetype)initWithImage:(nonnull UIImage *)image name:(nonnull NSString *)name persistent:(BOOL)persistent asImageFormat:(SDLArtworkImageFormat)imageFormat;

Page 74: Documentation iOS SDLAbstractProtocol Class Reference

image

The UIImage to be sent to the remote head unit

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

persistent

Whether or not the artwork should be persistent.

imageFormat

Whether the image should be converted to a PNG or JPG before

transmission. Images with transparency or few colors should be PNGs.

Images with many colors should be JPGs.

SWIFT

init(image: Any!, name: String, persistent: Bool, as imageFormat: SDLArtworkImageFormat)

PARAMETERS

Page 75: Documentation iOS SDLAbstractProtocol Class Reference

An instance of this class to be passed to the file manager.

SDLAudioPassThruCapabilities ClassReference

Section Contents

• -init• -initWithDictionary:• samplingRate• bitsPerSample• audioType

Overview

Describes different audio type configurations for SDLPerformAudioPassThru,

e.g. {8kHz,8-bit,PCM}

Parameter List

Name Type DescriptionSmartDeviceLink Ver.Available

RETURN VALUE

samplingRate SDLSamplingRate*

Describes thesampling rate forAudioPassThru

SmartDeviceLink 2.0

bitsPerSample SDLBitsPerSample*

Describes thesample depth inbit forAudioPassThru

SmartDeviceLink 2.0

audioType SDLAudioType * Describes theaudiotype forAudioPassThru

SmartDeviceLink 2.0

Page 76: Documentation iOS SDLAbstractProtocol Class Reference

Since SmartDeviceLink 2.0

-init

Constructs a newly allocated SDLAudioPassThruCapabilities object

-initWithDictionary:

Constructs a newly allocated SDLAudioPassThruCapabilities object indicated by

the Hashtable parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 77: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

samplingRate

@abstract The sampling rate for AudioPassThru

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSamplingRate *samplingRate;

SWIFT

var samplingRate: SDLSamplingRate! { get set }

Page 78: Documentation iOS SDLAbstractProtocol Class Reference

bitsPerSample

@abstract The sample depth in bit for AudioPassThru

audioType

@abstract The audiotype for AudioPassThru

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBitsPerSample *bitsPerSample;

SWIFT

var bitsPerSample: SDLBitsPerSample! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLAudioType *audioType;

Page 79: Documentation iOS SDLAbstractProtocol Class Reference

SDLAudioStreamingState ClassReference

Section Contents

• +valueOf:• +values• +AUDIBLE• +ATTENUATED• +NOT_AUDIBLE

Overview

Describes whether or not streaming audio is currently audible to the user.

Though provided in every OnHMIStatus notification, this information is only

relevant for applications that declare themselves as media apps in

RegisterAppInterface

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLAudioStreamingState

SWIFT

var audioType: SDLAudioType! { get set }

Page 80: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLAudioStreamingState

+values

@abstract Store the enumeration of all possible SDLAudioStreamingState

OBJECTIVE-C

+ (SDLAudioStreamingState *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLAudioStreamingState!

PARAMETERS

RETURN VALUE

Page 81: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLAudioStreamingState

+AUDIBLE

@abstract Currently streaming audio, if any, is audible to user.

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLAudioStreamingState *)AUDIBLE;

Page 82: Documentation iOS SDLAbstractProtocol Class Reference

SDLAudioStreamingState with value of AUDIBLE

+ATTENUATED

@abstract Some kind of audio mixing is taking place. Currently streaming

audio, if any, is audible to the user at a lowered volume.

@since SDL 2.0

SWIFT

class func audible() -> SDLAudioStreamingState!

RETURN VALUE

OBJECTIVE-C

+ (SDLAudioStreamingState *)ATTENUATED;

SWIFT

class func attenuated() -> SDLAudioStreamingState!

Page 83: Documentation iOS SDLAbstractProtocol Class Reference

SDLAudioStreamingState with value of ATTENUATED

+NOT_AUDIBLE

@abstract Currently streaming audio, if any, is not audible to user. made via VR

session.

SDLAudioStreamingState with value of NOT_AUDIBLE

RETURN VALUE

OBJECTIVE-C

+ (SDLAudioStreamingState *)NOT_AUDIBLE;

SWIFT

class func not_AUDIBLE() -> SDLAudioStreamingState!

RETURN VALUE

Page 84: Documentation iOS SDLAbstractProtocol Class Reference

SDLAudioType Class Reference

Section Contents

• +valueOf:• +values• +PCM

Overview

Describes different audio type options for PerformAudioPassThru

+valueOf:

@abstract Convert String to SDLAudioType

OBJECTIVE-C

+ (SDLAudioType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLAudioType!

Page 85: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLAudioType

+values

@abstract Store the enumeration of all possible SDLAudioType

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 86: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLAudioType

+PCM

@abstract PCM raw audio

@since SDL 2.0

SDLAudioType with value of PCM

RETURN VALUE

OBJECTIVE-C

+ (SDLAudioType *)PCM;

SWIFT

class func pcm() -> SDLAudioType!

RETURN VALUE

Page 87: Documentation iOS SDLAbstractProtocol Class Reference

SDLBeltStatus Class Reference

Section Contents

• -init• -initWithDictionary:• driverBeltDeployed• passengerBeltDeployed• passengerBuckleBelted• driverBuckleBelted• leftRow2BuckleBelted• passengerChildDetected• rightRow2BuckleBelted• middleRow2BuckleBelted• middleRow3BuckleBelted• leftRow3BuckleBelted• rightRow3BuckleBelted• leftRearInflatableBelted• rightRearInflatableBelted• middleRow1BeltDeployed• middleRow1BuckleBelted

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

Page 88: Documentation iOS SDLAbstractProtocol Class Reference

driverBeltDeployed

Undocumented

passengerBeltDeployed

Undocumented

passengerBuckleBelted

Undocumented

driverBuckleBelted

Undocumented

leftRow2BuckleBelted

Undocumented

passengerChildDetected

Undocumented

rightRow2BuckleBelted

Undocumented

middleRow2BuckleBelted

Undocumented

Page 89: Documentation iOS SDLAbstractProtocol Class Reference

middleRow3BuckleBelted

Undocumented

leftRow3BuckleBelted

Undocumented

rightRow3BuckleBelted

Undocumented

leftRearInflatableBelted

Undocumented

rightRearInflatableBelted

Undocumented

middleRow1BeltDeployed

Undocumented

middleRow1BuckleBelted

Undocumented

Page 90: Documentation iOS SDLAbstractProtocol Class Reference

SDLBitsPerSample Class Reference

Section Contents

• +valueOf:• +values• +_8_BIT• +_16_BIT

Overview

Describes different bit depth options for PerformAudioPassThru

@since SDL 2.0

+valueOf:

@abstract Convert String to SDLBitsPerSample

OBJECTIVE-C

+ (SDLBitsPerSample *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLBitsPerSample!

Page 91: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLBitsPerSample

+values

@abstract Store the enumeration of all possible SDLBitsPerSample

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 92: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLBitsPerSample

+_8_BIT

@abstract 8 bits per sample

a SDLBitsPerSample with value of 8_BIT

RETURN VALUE

OBJECTIVE-C

+ (SDLBitsPerSample *)_8_BIT;

SWIFT

class func _8_BIT() -> SDLBitsPerSample!

RETURN VALUE

Page 93: Documentation iOS SDLAbstractProtocol Class Reference

+_16_BIT

@abstract 16 bits per sample

a SDLBitsPerSample with value of 16_BIT

SDLBodyInformation Class Reference

Section Contents

• -init

OBJECTIVE-C

+ (SDLBitsPerSample *)_16_BIT;

SWIFT

class func _16_BIT() -> SDLBitsPerSample!

RETURN VALUE

Page 94: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• parkBrakeActive• ignitionStableStatus• ignitionStatus• driverDoorAjar• passengerDoorAjar• rearLeftDoorAjar• rearRightDoorAjar

Overview

The body information including power modes.

-init

@abstract Constructs a new SDLBodyInformation object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 95: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLBodyInformation object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

The dictionary to use

parkBrakeActive

@abstract References signal “PrkBrkActv_B_Actl”.

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 96: Documentation iOS SDLAbstractProtocol Class Reference

ignitionStableStatus

@abstract References signal “Ignition_Switch_Stable”. See IgnitionStableStatus.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *parkBrakeActive;

SWIFT

var parkBrakeActive: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLIgnitionStableStatus *ignitionStableStatus;

Page 97: Documentation iOS SDLAbstractProtocol Class Reference

ignitionStatus

@abstract References signal “Ignition_status”. See IgnitionStatus.

driverDoorAjar

@abstract References signal “DrStatDrv_B_Actl”.

SWIFT

var ignitionStableStatus: SDLIgnitionStableStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLIgnitionStatus *ignitionStatus;

SWIFT

var ignitionStatus: SDLIgnitionStatus! { get set }

Page 98: Documentation iOS SDLAbstractProtocol Class Reference

passengerDoorAjar

@abstract References signal “DrStatPsngr_B_Actl”.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *driverDoorAjar;

SWIFT

var driverDoorAjar: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *passengerDoorAjar;

SWIFT

var passengerDoorAjar: NSNumber! { get set }

Page 99: Documentation iOS SDLAbstractProtocol Class Reference

rearLeftDoorAjar

@abstract References signal “DrStatRl_B_Actl”.

rearRightDoorAjar

@abstract References signal “DrStatRr_B_Actl”.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rearLeftDoorAjar;

SWIFT

var rearLeftDoorAjar: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rearRightDoorAjar;

Page 100: Documentation iOS SDLAbstractProtocol Class Reference

SDLButtonCapabilities Class Reference

Section Contents

• -init• -initWithDictionary:• name• shortPressAvailable• longPressAvailable• upDownAvailable

Overview

Provides information about the capabilities of a SDL HMI button.

@since SDL 1.0

-init

Constructs a newly allocated SDLButtonCapabilities object

SWIFT

var rearRightDoorAjar: NSNumber! { get set }

Page 101: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLButtonCapabilities object indicated by the

Hashtable parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 102: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

name

@abstract The name of the SDL HMI button.

shortPressAvailable

@abstract A NSNumber value indicates whether the button supports a SHORT

press

Required, Boolean

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonName *name;

SWIFT

var name: SDLButtonName! { get set }

Page 103: Documentation iOS SDLAbstractProtocol Class Reference

longPressAvailable

@abstract A NSNumber value indicates whether the button supports a LONG

press

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *shortPressAvailable;

SWIFT

var shortPressAvailable: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *longPressAvailable;

Page 104: Documentation iOS SDLAbstractProtocol Class Reference

upDownAvailable

@abstract A NSNumber value indicates whether the button supports “button

down” and “button up”

Required, Boolean

SWIFT

var longPressAvailable: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *upDownAvailable;

SWIFT

var upDownAvailable: NSNumber! { get set }

Page 105: Documentation iOS SDLAbstractProtocol Class Reference

SDLButtonEventMode Class Reference

Section Contents

• +valueOf:• +values• +BUTTONUP• +BUTTONDOWN

Overview

Indicates whether the button was depressed or released. A BUTTONUP event

will always be preceded by a BUTTONDOWN event.

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLButtonEventMode - parameter: value The value

of the string to get an object for - returns: SDLButtonEventMode (BUTTONUP /

BUTTONDOWN)

OBJECTIVE-C

+ (SDLButtonEventMode *)valueOf:(NSString *)value;

Page 106: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLButtonEventMode (BUTTONUP / BUTTONDOWN)

+values

@abstract Store the enumeration of all possible SDLButtonEventMode - returns:

an array that store all possible SDLButtonEventMode

SWIFT

class func value(of value: String!) -> SDLButtonEventMode!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 107: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLButtonEventMode

+BUTTONUP

@abstract The button was released - returns: a SDLButtonEventMode with

value of BUTTONUP

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonEventMode *)BUTTONUP;

SWIFT

class func buttonup() -> SDLButtonEventMode!

Page 108: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonEventMode with value of BUTTONUP

+BUTTONDOWN

@abstract The button was depressed - returns: a SDLButtonEventMode with

value of BUTTONDOWN

a SDLButtonEventMode with value of BUTTONDOWN

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonEventMode *)BUTTONDOWN;

SWIFT

class func buttondown() -> SDLButtonEventMode!

RETURN VALUE

Page 109: Documentation iOS SDLAbstractProtocol Class Reference

SDLButtonName Class Reference

Section Contents

• +valueOf:• +values• +OK• +SEEKLEFT• +SEEKRIGHT• +TUNEUP• +TUNEDOWN• +PRESET_0• +PRESET_1• +PRESET_2• +PRESET_3• +PRESET_4• +PRESET_5• +PRESET_6• +PRESET_7• +PRESET_8• +PRESET_9• +CUSTOM_BUTTON• +SEARCH

Overview

Defines logical buttons which, on a given SDL unit, would correspond to either

physical or soft (touchscreen) buttons. These logical buttons present a standard

functional abstraction which the developer can rely upon, independent of the

SDL unit. For example, the developer can rely upon the OK button having the

same meaning to the user across SDL platforms.

The preset buttons (0-9) can typically be interpreted by the application as

corresponding to some user-configured choices, though the application is free

to interpret these button presses as it sees fit.

Page 110: Documentation iOS SDLAbstractProtocol Class Reference

The application can discover which buttons a given SDL unit implements by

interrogating the ButtonCapabilities parameter of the RegisterAppInterface

response.

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLButtonName

value

String value to retrieve the object for

OBJECTIVE-C

+ (SDLButtonName *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLButtonName!

PARAMETERS

Page 111: Documentation iOS SDLAbstractProtocol Class Reference

SDLButtonName

+values

@abstract Store the enumeration of all possible SDLButtonName

an array that store all possible SDLButtonName

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 112: Documentation iOS SDLAbstractProtocol Class Reference

+OK

@abstract Represents the button usually labeled “OK”. A typical use of this

button is for the user to press it to make a selection.

a SDLButtonName with the value of OK

+SEEKLEFT

@abstract Represents the seek-left button. A typical use of this button is for the

user to scroll to the left through menu choices one menu item per press.

OBJECTIVE-C

+ (SDLButtonName *)OK;

SWIFT

class func ok() -> SDLButtonName!

RETURN VALUE

Page 113: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of SEEKLEFT

+SEEKRIGHT

@abstract Represents the seek-right button. A typical use of this button is for

the user to scroll to the right through menu choices one menu item per press.

OBJECTIVE-C

+ (SDLButtonName *)SEEKLEFT;

SWIFT

class func seekleft() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)SEEKRIGHT;

Page 114: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of SEEKRIGHT

+TUNEUP

@abstract Represents a turn of the tuner knob in the clockwise direction one

tick.

SWIFT

class func seekright() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)TUNEUP;

SWIFT

class func tuneup() -> SDLButtonName!

Page 115: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of TUNEUP

+TUNEDOWN

@abstract Represents a turn of the tuner knob in the counter-clockwise

direction one tick.

a SDLButtonName with the value of TUNEDOWN

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)TUNEDOWN;

SWIFT

class func tunedown() -> SDLButtonName!

RETURN VALUE

Page 116: Documentation iOS SDLAbstractProtocol Class Reference

+PRESET_0

@abstract Represents the preset 0 button.

a SDLButtonName with the value of PRESET_0

+PRESET_1

@abstract Represents the preset 1 button.

OBJECTIVE-C

+ (SDLButtonName *)PRESET_0;

SWIFT

class func preset_0() -> SDLButtonName!

RETURN VALUE

Page 117: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_1

+PRESET_2

@abstract Represents the preset 2 button.

OBJECTIVE-C

+ (SDLButtonName *)PRESET_1;

SWIFT

class func preset_1() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_2;

Page 118: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_2

+PRESET_3

@abstract Represents the preset 3 button.

SWIFT

class func preset_2() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_3;

SWIFT

class func preset_3() -> SDLButtonName!

Page 119: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_3

+PRESET_4

@abstract Represents the preset 4 button.

a SDLButtonName with the value of PRESET_4

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_4;

SWIFT

class func preset_4() -> SDLButtonName!

RETURN VALUE

Page 120: Documentation iOS SDLAbstractProtocol Class Reference

+PRESET_5

@abstract Represents the preset 5 button.

a SDLButtonName with the value of PRESET_5

+PRESET_6

@abstract Represents the preset 6 button.

OBJECTIVE-C

+ (SDLButtonName *)PRESET_5;

SWIFT

class func preset_5() -> SDLButtonName!

RETURN VALUE

Page 121: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_6

+PRESET_7

@abstract Represents the preset 7 button.

OBJECTIVE-C

+ (SDLButtonName *)PRESET_6;

SWIFT

class func preset_6() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_7;

Page 122: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_7

+PRESET_8

@abstract Represents the preset 8 button.

SWIFT

class func preset_7() -> SDLButtonName!

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_8;

SWIFT

class func preset_8() -> SDLButtonName!

Page 123: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonName with the value of PRESET_8

+PRESET_9

@abstract Represents the preset 9 button.

a SDLButtonName with the value of PRESET_9

RETURN VALUE

OBJECTIVE-C

+ (SDLButtonName *)PRESET_9;

SWIFT

class func preset_9() -> SDLButtonName!

RETURN VALUE

Page 124: Documentation iOS SDLAbstractProtocol Class Reference

+CUSTOM_BUTTON

Undocumented

+SEARCH

Undocumented

SDLButtonPressMode Class Reference

Section Contents

• +valueOf:• +values• +LONG

OBJECTIVE-C

@interface SDLButtonName : SDLEnum

OBJECTIVE-C

@interface SDLButtonName : SDLEnum

Page 125: Documentation iOS SDLAbstractProtocol Class Reference

• +SHORT

Overview

Indicates whether this is a LONG or SHORT button press

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLButtonPressMode

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLButtonPressMode *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLButtonPressMode!

PARAMETERS

Page 126: Documentation iOS SDLAbstractProtocol Class Reference

SDLButtonPressMode

+values

@abstract Store the enumeration of all possible SDLButtonPressMode

an array that store all possible SDLButtonPressMode

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 127: Documentation iOS SDLAbstractProtocol Class Reference

+LONG

@abstract A button was released, after it was pressed for a long time. Actual

timing is defined by the head unit and may vary.

a SDLButtonPressMode with the value of LONG

+SHORT

@abstract A button was released, after it was pressed for a short time. Actual

timing is defined by the head unit and may vary.

OBJECTIVE-C

+ (SDLButtonPressMode *)LONG;

SWIFT

class func long() -> SDLButtonPressMode!

RETURN VALUE

Page 128: Documentation iOS SDLAbstractProtocol Class Reference

a SDLButtonPressMode with the value of SHORT

SDLCarModeStatus Class Reference

Section Contents

• +valueOf:• +values• +NORMAL• +FACTORY• +TRANSPORT• +CRASH

OBJECTIVE-C

+ (SDLButtonPressMode *)SHORT;

SWIFT

class func short() -> SDLButtonPressMode!

RETURN VALUE

Page 129: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Describes the carmode the vehicle is in. * Since SmartDeviceLink 2.0

+valueOf:

Undocumented

+values

Undocumented

+NORMAL

Provides carmode NORMAL to each module.

OBJECTIVE-C

@interface SDLCarModeStatus : SDLEnum

OBJECTIVE-C

@interface SDLCarModeStatus : SDLEnum

Page 130: Documentation iOS SDLAbstractProtocol Class Reference

+FACTORY

Provides carmode FACTORY to each module.

OBJECTIVE-C

+ (SDLCarModeStatus *)NORMAL;

SWIFT

class func normal() -> SDLCarModeStatus!

OBJECTIVE-C

+ (SDLCarModeStatus *)FACTORY;

SWIFT

class func factory() -> SDLCarModeStatus!

Page 131: Documentation iOS SDLAbstractProtocol Class Reference

+TRANSPORT

Provides carmode TRANSPORT to each module.

+CRASH

Provides carmode CRASH to each module.

OBJECTIVE-C

+ (SDLCarModeStatus *)TRANSPORT;

SWIFT

class func transport() -> SDLCarModeStatus!

OBJECTIVE-C

+ (SDLCarModeStatus *)CRASH;

Page 132: Documentation iOS SDLAbstractProtocol Class Reference

SDLChangeRegistration Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithLanguage:hmiDisplayLanguage:• -

initWithLanguage:hmiDisplayLanguage:appName:ttsName:ngnMediaScreenAppName:vrSynonyms:• language• hmiDisplayLanguage• appName• ttsName• ngnMediaScreenAppName• vrSynonyms

Overview

If the app recognizes during the app registration that the SDL HMI language

(voice/TTS and/or display) does not match the app language, the app will be

able (but does not need) to change this registration with changeRegistration

prior to app being brought into focus.

Any HMILevel allowed

SWIFT

class func crash() -> SDLCarModeStatus!

Page 133: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 2.0

-init

Constructs a new SDLChangeRegistration object

-initWithDictionary:

Constructs a new SDLChangeRegistration object indicated by the dictionary

parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 134: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithLanguage:hmiDisplayLanguage:

Undocumented

-

initWithLanguage:hmiDisplayLanguage:appName:ttsName:ngnMediaScreenApp

Undocumented

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLChangeRegistration : SDLRPCRequest

Page 135: Documentation iOS SDLAbstractProtocol Class Reference

language

@abstract The language the app wants to change to

hmiDisplayLanguage

@abstract HMI display language

OBJECTIVE-C

@interface SDLChangeRegistration : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLLanguage *language;

SWIFT

var language: SDLLanguage! { get set }

Page 136: Documentation iOS SDLAbstractProtocol Class Reference

appName

Request a new app name registration

Optional, Max string length 100 chars

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLLanguage *hmiDisplayLanguage;

SWIFT

var hmiDisplayLanguage: SDLLanguage! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *appName;

Page 137: Documentation iOS SDLAbstractProtocol Class Reference

ttsName

Request a new TTSName registration.

Optional, Array of SDLTTSChunk, 1 - 100 elements

ngnMediaScreenAppName

Request a new app short name registration

Optional, Max string length 100 chars

SWIFT

var appName: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSArray *ttsName;

SWIFT

var ttsName: [Any]! { get set }

Page 138: Documentation iOS SDLAbstractProtocol Class Reference

vrSynonyms

Request a new VR synonyms registration

Optional, Array of NSString, 1 - 100 elements, max string length 40 chars

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *ngnMediaScreenAppName;

SWIFT

var ngnMediaScreenAppName: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSArray *vrSynonyms;

Page 139: Documentation iOS SDLAbstractProtocol Class Reference

SDLChangeRegistrationResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SDLChangeRegistrationResponse is sent, when SDLChangeRegistration has

been called

@since SDL 2.0

-init

Undocumented

SWIFT

var vrSynonyms: [Any]! { get set }

Page 140: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

SDLCharacterSet Class Reference

Section Contents

• +valueOf:• +values• +TYPE2SET• +TYPE5SET• +CID1SET• +CID2SET

OBJECTIVE-C

@interface SDLChangeRegistrationResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLChangeRegistrationResponse : SDLRPCResponse

Page 141: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Character sets supported by SDL.

@since SDL 1.0

+valueOf:

@abstract Convert String to SDLCharacterSet

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLCharacterSet *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLCharacterSet!

PARAMETERS

Page 142: Documentation iOS SDLAbstractProtocol Class Reference

SDLCharacterSet

+values

@abstract Store the enumeration of all possible SDLCharacterSet

an array that store all possible SDLCharacterSet

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 143: Documentation iOS SDLAbstractProtocol Class Reference

+TYPE2SET

Undocumented

+TYPE5SET

Undocumented

+CID1SET

Undocumented

OBJECTIVE-C

@interface SDLCharacterSet : SDLEnum

OBJECTIVE-C

@interface SDLCharacterSet : SDLEnum

OBJECTIVE-C

@interface SDLCharacterSet : SDLEnum

Page 144: Documentation iOS SDLAbstractProtocol Class Reference

+CID2SET

Undocumented

SDLChoice Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithId:menuName:vrCommands:• -

initWithId:menuName:vrCommands:image:secondaryText:secondaryImage:tertiaryText:• choiceID• menuName• vrCommands• image• secondaryText• tertiaryText

OBJECTIVE-C

@interface SDLCharacterSet : SDLEnum

Page 145: Documentation iOS SDLAbstractProtocol Class Reference

• secondaryImage

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.

Parameter List

Name Type DescriptionSmartDeviceLink Ver.Available

Since SmartDeviceLink 1.0

-init

Constructs a newly allocated SDLChoice object

choiceID NSNumber *

Application-scoped identifierthat uniquelyidentifies thischoice. Min: 0 Max: 65535

SmartDeviceLink 1.0

menuName NSString *

Text whichappears in menu,representing thischoice. Min: 1 Max: 100

SmartDeviceLink 1.0

vrCommands NSMutableArray *

An array ofstrings to be usedas VR synonymsfor this choice. Ifthis array isprovided, it musthave at least onenon-emptyelement

SmartDeviceLink 1.0

image SDLImage *

Either a static hexicon value or abinary image filename identifier(sent by PutFile).

SmartDeviceLink 2.0

Page 146: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLChoice object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 147: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithId:menuName:vrCommands:

Undocumented

-

initWithId:menuName:vrCommands:image:secondaryText:secondaryImage:terti

Undocumented

PARAMETERS

OBJECTIVE-C

@interface SDLChoice : SDLRPCStruct

OBJECTIVE-C

@interface SDLChoice : SDLRPCStruct

Page 148: Documentation iOS SDLAbstractProtocol Class Reference

choiceID

@abstract the application-scoped identifier that uniquely identifies this choice

Required, Integer 0 - 65535

menuName

@abstract Text which appears in menu, representing this choice

Required, Max string length 500 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *choiceID;

SWIFT

var choiceID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *menuName;

Page 149: Documentation iOS SDLAbstractProtocol Class Reference

vrCommands

@abstract VR synonyms for this choice

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

image

@abstract The image of the choice

Optional

SWIFT

var menuName: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrCommands;

SWIFT

var vrCommands: NSMutableArray! { get set }

Page 150: Documentation iOS SDLAbstractProtocol Class Reference

secondaryText

@abstract Optional 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, atomic) SDLImage *image;

SWIFT

var image: SDLImage! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *secondaryText;

Page 151: Documentation iOS SDLAbstractProtocol Class Reference

tertiaryText

@abstract Optional tertiary text to display; e.g. distance to POI for a search

result entry

Optional, Max String length 500 chars

secondaryImage

@abstract Optional secondary image for choice

SWIFT

var secondaryText: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *tertiaryText;

SWIFT

var tertiaryText: String! { get set }

Page 152: Documentation iOS SDLAbstractProtocol Class Reference

Optional

SDLClusterModeStatus Class Reference

Section Contents

• -init• -initWithDictionary:• powerModeActive• powerModeQualificationStatus• carModeStatus

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLImage *secondaryImage;

SWIFT

var secondaryImage: SDLImage! { get set }

Page 153: Documentation iOS SDLAbstractProtocol Class Reference

• powerModeStatus

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

powerModeActive

Undocumented

powerModeQualificationStatus

Undocumented

carModeStatus

Undocumented

powerModeStatus

Undocumented

Page 154: Documentation iOS SDLAbstractProtocol Class Reference

SDLCompassDirection Class Reference

Section Contents

• +valueOf:• +values• +NORTH• +NORTHWEST• +WEST• +SOUTHWEST• +SOUTH• +SOUTHEAST• +EAST• +NORTHEAST

Overview

The list of potential compass directions.

@since SDL 2.0

+valueOf:

@abstract Convert String to SDLCompassDirection - parameter: value The

value of the string to get an object for - returns: SDLCompassDirection

OBJECTIVE-C

+ (SDLCompassDirection *)valueOf:(NSString *)value;

Page 155: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLCompassDirection

+values

@abstract Store the enumeration of all possible SDLCompassDirection - returns:

An array that store all possible SDLCompassDirection

SWIFT

class func value(of value: String!) -> SDLCompassDirection!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 156: Documentation iOS SDLAbstractProtocol Class Reference

An array that store all possible SDLCompassDirection

+NORTH

@abstract Direction North - returns: A SDLCompassDirection with the value of

NORTH

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLCompassDirection *)NORTH;

SWIFT

class func north() -> SDLCompassDirection!

Page 157: Documentation iOS SDLAbstractProtocol Class Reference

A SDLCompassDirection with the value of NORTH

+NORTHWEST

@abstract Direction Northwest - returns: A SDLCompassDirection with the value

of NORTHWEST

A SDLCompassDirection with the value of NORTHWEST

RETURN VALUE

OBJECTIVE-C

+ (SDLCompassDirection *)NORTHWEST;

SWIFT

class func northwest() -> SDLCompassDirection!

RETURN VALUE

Page 158: Documentation iOS SDLAbstractProtocol Class Reference

+WEST

@abstract Direction West - returns: A SDLCompassDirection with the value of

WEST

A SDLCompassDirection with the value of WEST

+SOUTHWEST

@abstract Direction Southwest - returns: A SDLCompassDirection with the

value of SOUTHWEST

OBJECTIVE-C

+ (SDLCompassDirection *)WEST;

SWIFT

class func west() -> SDLCompassDirection!

RETURN VALUE

Page 159: Documentation iOS SDLAbstractProtocol Class Reference

A SDLCompassDirection with the value of SOUTHWEST

+SOUTH

@abstract Direction South - returns: A SDLCompassDirection with the value of

SOUTH

OBJECTIVE-C

+ (SDLCompassDirection *)SOUTHWEST;

SWIFT

class func southwest() -> SDLCompassDirection!

RETURN VALUE

OBJECTIVE-C

+ (SDLCompassDirection *)SOUTH;

Page 160: Documentation iOS SDLAbstractProtocol Class Reference

A SDLCompassDirection with the value of SOUTH

+SOUTHEAST

@abstract Direction Southeast - returns: A SDLCompassDirection with the value

of SOUTHEAST

SWIFT

class func south() -> SDLCompassDirection!

RETURN VALUE

OBJECTIVE-C

+ (SDLCompassDirection *)SOUTHEAST;

SWIFT

class func southeast() -> SDLCompassDirection!

Page 161: Documentation iOS SDLAbstractProtocol Class Reference

A SDLCompassDirection with the value of SOUTHEAST

+EAST

@abstract Direction East - returns: A SDLCompassDirection with the value of

EAST

A SDLCompassDirection with the value of EAST

RETURN VALUE

OBJECTIVE-C

+ (SDLCompassDirection *)EAST;

SWIFT

class func east() -> SDLCompassDirection!

RETURN VALUE

Page 162: Documentation iOS SDLAbstractProtocol Class Reference

+NORTHEAST

@abstract Direction Northeast - returns: A SDLCompassDirection with the value

of NORTHEAST

A SDLCompassDirection with the value of NORTHEAST

OBJECTIVE-C

+ (SDLCompassDirection *)NORTHEAST;

SWIFT

class func northeast() -> SDLCompassDirection!

RETURN VALUE

Page 163: Documentation iOS SDLAbstractProtocol Class Reference

SDLComponentVolumeStatus ClassReference

Section Contents

• +valueOf:• +values• +UNKNOWN• +NORMAL• +LOW• +FAULT• +ALERT• +NOT_SUPPORTED

Overview

The volume status of a vehicle component.

@since SDL 2.0

+valueOf:

@abstract Convert String to SDLComponentVolumeStatus - parameter: value

The value of the string to get an object for - returns:

SDLComponentVolumeStatus

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)valueOf:(NSString *)value;

Page 164: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLComponentVolumeStatus

+values

@abstract Store the enumeration of all possible SDLComponentVolumeStatus -

returns: An array that store all possible SDLComponentVolumeStatus

SWIFT

class func value(of value: String!) -> SDLComponentVolumeStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 165: Documentation iOS SDLAbstractProtocol Class Reference

An array that store all possible SDLComponentVolumeStatus

+UNKNOWN

@abstract Unknown SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of UNKNOWN

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)UNKNOWN;

SWIFT

class func unknown() -> SDLComponentVolumeStatus!

Page 166: Documentation iOS SDLAbstractProtocol Class Reference

a SDLComponentVolumeStatus with the value of UNKNOWN

+NORMAL

@abstract Normal SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of NORMAL

a SDLComponentVolumeStatus with the value of NORMAL

RETURN VALUE

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)NORMAL;

SWIFT

class func normal() -> SDLComponentVolumeStatus!

RETURN VALUE

Page 167: Documentation iOS SDLAbstractProtocol Class Reference

+LOW

@abstract Low SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of LOW

a SDLComponentVolumeStatus with the value of LOW

+FAULT

@abstract Fault SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of FAULT

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)LOW;

SWIFT

class func low() -> SDLComponentVolumeStatus!

RETURN VALUE

Page 168: Documentation iOS SDLAbstractProtocol Class Reference

a SDLComponentVolumeStatus with the value of FAULT

+ALERT

@abstract Alert SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of ALERT

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)FAULT;

SWIFT

class func fault() -> SDLComponentVolumeStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)ALERT;

Page 169: Documentation iOS SDLAbstractProtocol Class Reference

a SDLComponentVolumeStatus with the value of ALERT

+NOT_SUPPORTED

@abstract Not supported SDLComponentVolumeStatus - returns: a

SDLComponentVolumeStatus with the value of NOT_SUPPORTED

SWIFT

class func alert() -> SDLComponentVolumeStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLComponentVolumeStatus *)NOT_SUPPORTED;

SWIFT

class func not_SUPPORTED() -> SDLComponentVolumeStatus!

Page 170: Documentation iOS SDLAbstractProtocol Class Reference

a SDLComponentVolumeStatus with the value of NOT_SUPPORTED

SDLConfiguration Class Reference

Section Contents

• lifecycleConfig• lockScreenConfig• -initWithLifecycle:lockScreen:• +configurationWithLifecycle:lockScreen:

Overview

Undocumented

lifecycleConfig

The lifecycle configuration.

RETURN VALUE

OBJECTIVE-C

@property (readonly, copy, nonatomic) SDLLifecycleConfiguration *_Nonnull lifecycleConfig;

Page 171: Documentation iOS SDLAbstractProtocol Class Reference

lockScreenConfig

The lock screen configuration.

-initWithLifecycle:lockScreen:

Create a new configuration to be passed into SDLManager.

SWIFT

@NSCopying var lifecycleConfig: SDLLifecycleConfiguration { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic) SDLLockScreenConfiguration *_Nonnull lockScreenConfig;

SWIFT

@NSCopying var lockScreenConfig: SDLLockScreenConfiguration { get }

Page 172: Documentation iOS SDLAbstractProtocol Class Reference

lifecycleConfig

The lifecycle configuration to be used.

lockScreenConfig

The lockscreen configuration to be used. If nil, this will be

enabledConfiguration .

OBJECTIVE-C

- (nonnull instancetype)initWithLifecycle:(nonnull SDLLifecycleConfiguration *)lifecycleConfig lockScreen:(nonnull SDLLockScreenConfiguration *)lockScreenConfig;

SWIFT

init(lifecycle lifecycleConfig: SDLLifecycleConfiguration, lockScreen lockScreenConfig: SDLLockScreenConfiguration)

PARAMETERS

Page 173: Documentation iOS SDLAbstractProtocol Class Reference

The configuration

+configurationWithLifecycle:lockScreen:

Create a new configuration to be passed into SDLManager.

lifecycleConfig

The lifecycle configuration to be used.

lockScreenConfig

The lockscreen configuration to be used. If nil, this will be

enabledConfiguration .

RETURN VALUE

OBJECTIVE-C

+ (nonnull instancetype)configurationWithLifecycle:(nonnull SDLLifecycleConfiguration *)lifecycleConfig lockScreen: (nonnull SDLLockScreenConfiguration *)lockScreenConfig;

PARAMETERS

Page 174: Documentation iOS SDLAbstractProtocol Class Reference

The configuration

SDLConsoleController Class Reference

Section Contents

• messageList• atBottom• dateFormatter• messageList• -initWithTableView:

Overview

Undocumented

messageList

Undocumented

atBottom

Undocumented

RETURN VALUE

Page 175: Documentation iOS SDLAbstractProtocol Class Reference

dateFormatter

Undocumented

messageList

Undocumented

-initWithTableView:

Undocumented

SDLCreateInteractionChoiceSet ClassReference

Section Contents

• -init• -initWithDictionary:• -initWithId:choiceSet:• interactionChoiceSetID• choiceSet

Overview

Creates a Choice Set which can be used in subsequent SDLPerformInteraction

Operations.

HMILevel needs to be FULL, LIMITED or BACKGROUND

Before a perform interaction is sent you MUST wait for the success from the

CreateInteractionChoiceSet RPC.

Page 176: Documentation iOS SDLAbstractProtocol Class Reference

If you do not wait the system may not recognize the first utterance from the

user.

@since SDL 1.0

SeeSDLDeleteInteractionChoiceSet SDLPerformInteraction

-init

Constructs a new SDLCreateInteractionChoiceSet object

-initWithDictionary:

Constructs a new SDLCreateInteractionChoiceSet object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 177: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithId:choiceSet:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLCreateInteractionChoiceSet : SDLRPCRequest

Page 178: Documentation iOS SDLAbstractProtocol Class Reference

interactionChoiceSetID

@abstract A unique ID that identifies the Choice Set

Required, Integer, 0 - 2,000,000,000

choiceSet

@abstract Array of choices, which the user can select by menu or voice

recognition

Required, SDLChoice, Array size 1 - 100

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *interactionChoiceSetID;

SWIFT

var interactionChoiceSetID: NSNumber! { get set }

Page 179: Documentation iOS SDLAbstractProtocol Class Reference

SDLCreateInteractionChoiceSetResponseClass Reference

Section Contents

• -init• -initWithDictionary:

Overview

SDLCreateInteractionChoiceSetResponse is sent, when

SDLCreateInteractionChoiceSet has been called

Since SmartDeviceLink 1.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *choiceSet;

SWIFT

var choiceSet: NSMutableArray! { get set }

Page 180: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

SDLDIDResult Class Reference

Section Contents

• -init

OBJECTIVE-C

@interface SDLCreateInteractionChoiceSetResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLCreateInteractionChoiceSetResponse : SDLRPCResponse

Page 181: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• resultCode• didLocation• data

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

resultCode

Undocumented

didLocation

Undocumented

data

Undocumented

Page 182: Documentation iOS SDLAbstractProtocol Class Reference

SDLDateTime Class Reference

Section Contents

• -initWithHour:minute:• -initWithHour:minute:second:millisecond:• -initWithHour:minute:second:millisecond:day:month:year:• -

initWithHour:minute:second:millisecond:day:month:year:timezoneMinuteOffset:timezoneHourOffset:• millisecond• second• minute• hour• day• month• year• timezoneMinuteOffset• timezoneHourOffset

Overview

Undocumented

-initWithHour:minute:

Undocumented

-initWithHour:minute:second:millisecond:

Undocumented

Page 183: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithHour:minute:second:millisecond:day:month:year:

Undocumented

-

initWithHour:minute:second:millisecond:day:month:year:timezoneMinuteOffset

Undocumented

millisecond

@abstract Milliseconds part of time

Optional, Integer 0 - 999

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *millisecond;

SWIFT

@NSCopying var millisecond: NSNumber! { get set }

Page 184: Documentation iOS SDLAbstractProtocol Class Reference

second

@abstract Seconds part of time

Optional, Integer 0 - 59

minute

@abstract Minutes part of time

Optional, Integer 0 - 59

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *second;

SWIFT

@NSCopying var second: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *minute;

Page 185: Documentation iOS SDLAbstractProtocol Class Reference

hour

@abstract Hour part of time

Optional, Integer 0 - 23

day

@abstract Day of the month

Optional, Integer 1 - 31

SWIFT

@NSCopying var minute: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *hour;

SWIFT

@NSCopying var hour: NSNumber! { get set }

Page 186: Documentation iOS SDLAbstractProtocol Class Reference

month

@abstract Month of the year

Optional, Integer 1 - 12

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *day;

SWIFT

@NSCopying var day: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *month;

Page 187: Documentation iOS SDLAbstractProtocol Class Reference

year

@abstract The year in YYYY format

Optional, Max Value 4095

timezoneMinuteOffset

@abstract Time zone offset in Min with regard to UTC

Optional, Integer 0 - 59

SWIFT

@NSCopying var month: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *year;

SWIFT

@NSCopying var year: NSNumber! { get set }

Page 188: Documentation iOS SDLAbstractProtocol Class Reference

timezoneHourOffset

@abstract Time zone offset in Hours with regard to UTC

Optional, Integer -12 - 14

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *timezoneMinuteOffset;

SWIFT

@NSCopying var timezoneMinuteOffset: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLInt> *timezoneHourOffset;

Page 189: Documentation iOS SDLAbstractProtocol Class Reference

SDLDebugTool Class Reference

Section Contents

• +enable• +disable• +addConsole:• +addConsole:toGroup:• +removeConsole:• +removeConsole:fromGroup:• +logInfo:• +logFormat:• +logInfo:withType:• +logInfo:withType:toOutput:• +logInfo:andBinaryData:withType:toOutput:• +logInfo:withType:toOutput:toGroup:• +enableDebugToLogFile• +disableDebugToLogFile• +writeToLogFile:• +stringForDebugType:

Overview

Undocumented

SWIFT

@NSCopying var timezoneHourOffset: NSNumber! { get set }

Page 190: Documentation iOS SDLAbstractProtocol Class Reference

+enable

Undocumented

+disable

Undocumented

+addConsole:

Undocumented

+addConsole:toGroup:

Undocumented

+removeConsole:

Undocumented

+removeConsole:fromGroup:

Undocumented

+logInfo:

Undocumented

+logFormat:

Undocumented

Page 191: Documentation iOS SDLAbstractProtocol Class Reference

+logInfo:withType:

Undocumented

+logInfo:withType:toOutput:

Undocumented

+logInfo:andBinaryData:withType:toOutput:

Undocumented

+logInfo:withType:toOutput:toGroup:

Undocumented

+enableDebugToLogFile

Undocumented

+disableDebugToLogFile

Undocumented

+writeToLogFile:

Undocumented

+stringForDebugType:

Undocumented

Page 192: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteCommand Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithId:• cmdID

Overview

Removes a command from the Command Menu

HMI Status Requirements:

HMILevel: FULL, LIMITED or BACKGROUND

AudioStreamingState: N/A

SystemContext: Should not be attempted when VRSESSION or MENU

Since SmartDeviceLink 1.0

see SDLAddCommand SDLAddSubMenu SDLDeleteSubMenu

-init

Constructs a new SDLDeleteCommand object

OBJECTIVE-C

- (instancetype)init;

Page 193: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLDeleteCommand object indicated by the

NSMutableDictionary parameter

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 194: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-initWithId:

Undocumented

cmdID

@abstract the Command ID that identifies the Command to be deleted from

Command Menu @discussion an NSNumber value representing Command ID

Notes: Min Value: 0; Max Value: 2000000000

OBJECTIVE-C

@interface SDLDeleteCommand : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *cmdID;

SWIFT

var cmdID: NSNumber! { get set }

Page 195: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteCommandResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SDLDeleteCommandResponse is sent, when SDLDeleteCommand has been

called

Since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLDeleteCommandResponse : SDLRPCResponse

Page 196: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteFile Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithFileName:• syncFileName

Overview

Used to delete a file resident on the SDL module in the app’s local cache. Not

supported on first generation SDL vehicles

Since SmartDeviceLink 2.0

see SDLPutFile SDLListFiles

-init

Constructs a new SDLDeleteFile object

OBJECTIVE-C

@interface SDLDeleteCommandResponse : SDLRPCResponse

Page 197: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLDeleteFile object indicated by the dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 198: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithFileName:

Undocumented

syncFileName

@abstract a file reference name @discussion a String value representing a file

reference name

PARAMETERS

OBJECTIVE-C

@interface SDLDeleteFile : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *syncFileName;

Page 199: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteFileResponse Class Reference

Section Contents

• -init• -initWithDictionary:• spaceAvailable

Overview

Delete File Response is sent, when DeleteFile has been called

Since SmartDeviceLink 2.0

-init

Undocumented

SWIFT

var syncFileName: String! { get set }

OBJECTIVE-C

@interface SDLDeleteFileResponse : SDLRPCResponse

Page 200: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

spaceAvailable

Undocumented

SDLDeleteInteractionChoiceSet ClassReference

Section Contents

• -init

OBJECTIVE-C

@interface SDLDeleteFileResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLDeleteFileResponse : SDLRPCResponse

Page 201: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -initWithId:• interactionChoiceSetID

Overview

Deletes an existing Choice Set identified by the parameter

interactionChoiceSetID. If the specified interactionChoiceSetID is currently in

use by an active SDLPerformInteraction this call to delete the Choice Set will

fail returning an IN_USE resultCode

Function Group: Base

HMILevel needs to be FULL, LIMITED or BACKGROUD

Since SmartDeviceLink 1.0

see SDLCreateInteractionChoiceSet SDLPerformInteraction

-init

Constructs a new SDLDeleteInteractionChoiceSet object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 202: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLDeleteInteractionChoiceSet object indicated by the

NSMutableDictionary parameter

dict

The dictionary to use

-initWithId:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 203: Documentation iOS SDLAbstractProtocol Class Reference

interactionChoiceSetID

@abstract a unique ID that identifies the Choice Set @discussion a unique ID

that identifies the Choice Set

Notes: Min Value: 0; Max Value: 2000000000

OBJECTIVE-C

@interface SDLDeleteInteractionChoiceSet : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *interactionChoiceSetID;

SWIFT

var interactionChoiceSetID: NSNumber! { get set }

Page 204: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteInteractionChoiceSetResponseClass Reference

Section Contents

• -init• -initWithDictionary:

Overview

SDLDeleteInteractionChoiceSetResponse is sent, when

SDLDeleteInteractionChoiceSet has been called

Since SmartDeviceLink 1.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLDeleteInteractionChoiceSetResponse : SDLRPCResponse

Page 205: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteSubMenu Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithId:• menuID

Overview

Deletes a submenu from the Command Menu

Notes: When an app deletes a submenu that has child commands, those child

commands are also deleted

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 1.0

see SDLAddCommand SDLAddSubMenu SDLDeleteCommand

-init

Constructs a new SDLDeleteSubMenu object

OBJECTIVE-C

@interface SDLDeleteInteractionChoiceSetResponse : SDLRPCResponse

Page 206: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLDeleteSubMenu object indicated by the dictionary

parameter

- parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 207: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithId:

Undocumented

menuID

@abstract the MenuID that identifies the SDLSubMenu to be delete @discussion

Notes: Min Value: 0; Max Value: 2000000000

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLDeleteSubMenu : SDLRPCRequest

Page 208: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeleteSubMenuResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SDLDeleteSubMenuResponse is sent, when SDLDeleteSubMenu has been called

Since SmartDeviceLink 1.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *menuID;

SWIFT

var menuID: NSNumber! { get set }

Page 209: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

SDLDeliveryMode Class Reference

Section Contents

• +valueOf:• +values• +PROMPT

OBJECTIVE-C

@interface SDLDeleteSubMenuResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLDeleteSubMenuResponse : SDLRPCResponse

Page 210: Documentation iOS SDLAbstractProtocol Class Reference

• +DESTINATION• +QUEUE

Overview

Specifies the mode in which the sendLocation request is sent.

+valueOf:

@abstract Convert String to SDLDeliveryMode

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLDeliveryMode *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLDeliveryMode!

PARAMETERS

Page 211: Documentation iOS SDLAbstractProtocol Class Reference

SDLDeliveryMode

+values

@abstract Store the enumeration of all possible SDLDeliveryMode

an array that store all possible SDLDeliveryMode

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 212: Documentation iOS SDLAbstractProtocol Class Reference

+PROMPT

@abstract User is prompted on HMI

a SDLDeliveryMode with value of PROMPT

+DESTINATION

@abstract Set the location as destination without prompting the user

OBJECTIVE-C

+ (SDLDeliveryMode *)PROMPT;

SWIFT

class func prompt() -> SDLDeliveryMode!

RETURN VALUE

Page 213: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeliveryMode with value of DESTINATION

+QUEUE

@abstract Adds the current location to navigation queue

OBJECTIVE-C

+ (SDLDeliveryMode *)DESTINATION;

SWIFT

class func destination() -> SDLDeliveryMode!

RETURN VALUE

OBJECTIVE-C

+ (SDLDeliveryMode *)QUEUE;

Page 214: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeliveryMode with value of QUEUE

SDLDeviceInfo Class Reference

Section Contents

• -init• -initWithDictionary:• +currentDevice• hardware• firmwareRev• os• osVersion• carrier• maxNumberRFCOMMPorts

Overview

Undocumented

SWIFT

class func queue() -> SDLDeliveryMode!

RETURN VALUE

Page 215: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

+currentDevice

Undocumented

hardware

Undocumented

firmwareRev

Undocumented

os

Undocumented

osVersion

Undocumented

carrier

Undocumented

Page 216: Documentation iOS SDLAbstractProtocol Class Reference

maxNumberRFCOMMPorts

Undocumented

SDLDeviceLevelStatus Class Reference

Section Contents

• +valueOf:• +values• +ZERO_LEVEL_BARS• +ONE_LEVEL_BARS• +TWO_LEVEL_BARS• +THREE_LEVEL_BARS• +FOUR_LEVEL_BARS• +NOT_PROVIDED

Overview

Reflects the reported battery status of the connected device, if reported.

@since SDL 2.0

+valueOf:

Convert String to DeviceLevelStatus - parameter: value String - returns:

DeviceLevelStatus

Page 217: Documentation iOS SDLAbstractProtocol Class Reference

value

String

DeviceLevelStatus

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLDeviceLevelStatus!

PARAMETERS

RETURN VALUE

Page 218: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract Store the enumeration of all possible SDLDeviceLevelStatus -

returns: an array that store all possible SDLDeviceLevelStatus

an array that store all possible SDLDeviceLevelStatus

+ZERO_LEVEL_BARS

@abstract Device battery level is zero bars - returns: a SDLDeviceLevelStatus

with value of ZERO_LEVEL_BARS

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 219: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeviceLevelStatus with value of ZERO_LEVEL_BARS

+ONE_LEVEL_BARS

@abstract Device battery level is one bar - returns: a SDLDeviceLevelStatus

with value of ONE_LEVEL_BARS

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)ZERO_LEVEL_BARS;

SWIFT

class func zero_LEVEL_BARS() -> SDLDeviceLevelStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)ONE_LEVEL_BARS;

Page 220: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeviceLevelStatus with value of ONE_LEVEL_BARS

+TWO_LEVEL_BARS

@abstract Device battery level is two bars - returns: a SDLDeviceLevelStatus

with value of TWO_LEVEL_BARS

SWIFT

class func one_LEVEL_BARS() -> SDLDeviceLevelStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)TWO_LEVEL_BARS;

SWIFT

class func two_LEVEL_BARS() -> SDLDeviceLevelStatus!

Page 221: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeviceLevelStatus with value of TWO_LEVEL_BARS

+THREE_LEVEL_BARS

@abstract Device battery level is three bars - returns: a SDLDeviceLevelStatus

with value of THREE_LEVEL_BARS

a SDLDeviceLevelStatus with value of THREE_LEVEL_BARS

RETURN VALUE

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)THREE_LEVEL_BARS;

SWIFT

class func three_LEVEL_BARS() -> SDLDeviceLevelStatus!

RETURN VALUE

Page 222: Documentation iOS SDLAbstractProtocol Class Reference

+FOUR_LEVEL_BARS

@abstract Device battery level is four bars - returns: a SDLDeviceLevelStatus

with value of FOUR_LEVEL_BARS

a SDLDeviceLevelStatus with value of FOUR_LEVEL_BARS

+NOT_PROVIDED

@abstract Device battery level is unknown - returns: a SDLDeviceLevelStatus

with value of NOT_PROVIDED

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)FOUR_LEVEL_BARS;

SWIFT

class func four_LEVEL_BARS() -> SDLDeviceLevelStatus!

RETURN VALUE

Page 223: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDeviceLevelStatus with value of NOT_PROVIDED

SDLDeviceStatus Class Reference

Section Contents

• -init• -initWithDictionary:• voiceRecOn• btIconOn• callActive• phoneRoaming

OBJECTIVE-C

+ (SDLDeviceLevelStatus *)NOT_PROVIDED;

SWIFT

class func not_PROVIDED() -> SDLDeviceLevelStatus!

RETURN VALUE

Page 224: Documentation iOS SDLAbstractProtocol Class Reference

• textMsgAvailable• battLevelStatus• stereoAudioOutputMuted• monoAudioOutputMuted• signalLevelStatus• primaryAudioSource• eCallEventActive

Overview

Describes the status related to a connected mobile device or SDL and if or how

it is represented in the vehicle.

Parameter List

Page 225: Documentation iOS SDLAbstractProtocol Class Reference

Name Type DescriptionSmartDeviceLink Ver.Available

@since SDL 2.0

-init

Constructs a newly allocated SDLDeviceStatus object

voiceRecOn NSNumber * Voice recognitionis on

SmartDeviceLink 2.0

btIconOn NSNumber * Bluetoothconnectionestablished

SmartDeviceLink 2.0

callActive NSNumber * A call is beingactive

SmartDeviceLink 2.0

phoneRoaming NSNumber * The phone is inroaming mode

SmartDeviceLink 2.0

textMsgAvailable NSNumber * A textmessage is

available SmartDeviceLink 2.0

battLevelStatus SDLDeviceLevelStatus *

Battery levelstatus

SmartDeviceLink 2.0

stereoAudioOutputMuted NSNumber *

Status of thestereo audiooutput channel

SmartDeviceLink 2.0

monoAudioOutputMuted NSNumber *

Status of themono audiooutput channel

SmartDeviceLink 2.0

signalLevelStatus

SDLDeviceLevelStatus * Signal level status SmartDeviceLin

k 2.0

primaryAudioSource

PrimaryAudioSource *

Reflects thecurrent primaryaudio source ofSDL (if selected).

SmartDeviceLink 2.0

eCallEventActive NSNumber *

Reflects, if aneCall event isactive

SmartDeviceLink 2.0

Page 226: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLDeviceStatus object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 227: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use to construct the object

voiceRecOn

@abstract Indicates whether the voice recognition is on or off

Required, Boolean

btIconOn

@abstract Indicates whether the bluetooth connection established

Required, Boolean

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *voiceRecOn;

SWIFT

var voiceRecOn: NSNumber! { get set }

Page 228: Documentation iOS SDLAbstractProtocol Class Reference

callActive

@abstract Indicates whether a call is being active

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *btIconOn;

SWIFT

var btIconOn: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *callActive;

SWIFT

var callActive: NSNumber! { get set }

Page 229: Documentation iOS SDLAbstractProtocol Class Reference

phoneRoaming

@abstract Indicates whether the phone is in roaming mode

Required, Boolean

textMsgAvailable

@abstract Indicates whether a textmessage is available

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *phoneRoaming;

SWIFT

var phoneRoaming: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *textMsgAvailable;

Page 230: Documentation iOS SDLAbstractProtocol Class Reference

battLevelStatus

@abstract Battery level status

SeeSDLDeviceLevelStatus Required

stereoAudioOutputMuted

@abstract The status of the stereo audio output channel

SWIFT

var textMsgAvailable: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDeviceLevelStatus *battLevelStatus;

SWIFT

var battLevelStatus: SDLDeviceLevelStatus! { get set }

Page 231: Documentation iOS SDLAbstractProtocol Class Reference

Required, Boolean

monoAudioOutputMuted

@abstract The status of the mono audio output channel

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *stereoAudioOutputMuted;

SWIFT

var stereoAudioOutputMuted: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *monoAudioOutputMuted;

Page 232: Documentation iOS SDLAbstractProtocol Class Reference

signalLevelStatus

@abstract Signal level status

SeeSDLDeviceLevelStatus Required

primaryAudioSource

@abstract The current primary audio source of SDL (if selected).

See

SWIFT

var monoAudioOutputMuted: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDeviceLevelStatus *signalLevelStatus;

SWIFT

var signalLevelStatus: SDLDeviceLevelStatus! { get set }

Page 233: Documentation iOS SDLAbstractProtocol Class Reference

SDLPrimaryAudioSource Required

eCallEventActive

@abstract Indicates if an emergency call is active

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLPrimaryAudioSource *primaryAudioSource;

SWIFT

var primaryAudioSource: SDLPrimaryAudioSource! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *eCallEventActive;

Page 234: Documentation iOS SDLAbstractProtocol Class Reference

SDLDiagnosticMessage Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithTargetId:length:data:• targetID• messageLength• messageData

Overview

Non periodic vehicle diagnostic request

@since SDL 3.0

-init

Undocumented

SWIFT

var eCallEventActive: NSNumber! { get set }

Page 235: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

-initWithTargetId:length:data:

Undocumented

OBJECTIVE-C

@interface SDLDiagnosticMessage : SDLRPCRequest

OBJECTIVE-C

@interface SDLDiagnosticMessage : SDLRPCRequest

OBJECTIVE-C

@interface SDLDiagnosticMessage : SDLRPCRequest

Page 236: Documentation iOS SDLAbstractProtocol Class Reference

targetID

Name of target ECU

Required, Integer, 0 - 65535

messageLength

Length of message (in bytes)

Required, Integer, 65535

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *targetID;

SWIFT

var targetID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *messageLength;

Page 237: Documentation iOS SDLAbstractProtocol Class Reference

messageData

Array of bytes comprising CAN message.

Required, Array of NSNumber (Integers), Array size 1 - 65535, Integer Size 0 -

255

SWIFT

var messageLength: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *messageData;

SWIFT

var messageData: NSMutableArray! { get set }

Page 238: Documentation iOS SDLAbstractProtocol Class Reference

SDLDiagnosticMessageResponse ClassReference

Section Contents

• -init• -initWithDictionary:• messageDataResult

Overview

SDLDiagnosticMessageResponse is sent, when SDLDiagnosticMessage has been

called. * SinceSmartDeviceLink 3.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLDiagnosticMessageResponse : SDLRPCResponse

Page 239: Documentation iOS SDLAbstractProtocol Class Reference

messageDataResult

Undocumented

SDLDialNumber Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithNumber:

OBJECTIVE-C

@interface SDLDiagnosticMessageResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLDiagnosticMessageResponse : SDLRPCResponse

Page 240: Documentation iOS SDLAbstractProtocol Class Reference

• number

Overview

This RPC is used to tell the head unit to use bluetooth to dial a phone number

using the phone.

@since SDL 4.0

-init

Undocumented

-initWithDictionary:

Undocumented

-initWithNumber:

Undocumented

OBJECTIVE-C

@interface SDLDialNumber : SDLRPCRequest

OBJECTIVE-C

@interface SDLDialNumber : SDLRPCRequest

Page 241: Documentation iOS SDLAbstractProtocol Class Reference

number

Up to 40 character string representing the phone number. All characters

stripped except for ‘0’-‘9’, ’*’, ’#’, ’,’, ’;’, and ’+’

OBJECTIVE-C

@interface SDLDialNumber : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, nonatomic) NSString *number;

SWIFT

var number: String! { get set }

Page 242: Documentation iOS SDLAbstractProtocol Class Reference

SDLDialNumberResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Indicates the result, success, or failure of the SDLDialNumber request.

@since SDL 4.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLDialNumberResponse : SDLRPCResponse

Page 243: Documentation iOS SDLAbstractProtocol Class Reference

SDLDimension Class Reference

Section Contents

• +valueOf:• +values• +NO_FIX• +_2D• +_3D

Overview

The supported dimensions of the GPS.

@since SDL 2.0

+valueOf:

Convert String to SDLDimension

OBJECTIVE-C

@interface SDLDialNumberResponse : SDLRPCResponse

Page 244: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLDimension

+values

@abstract Store the enumeration of all possible SDLDimension

OBJECTIVE-C

+ (SDLDimension *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLDimension!

PARAMETERS

RETURN VALUE

Page 245: Documentation iOS SDLAbstractProtocol Class Reference

An array that store all possible SDLDimension

+NO_FIX

@abstract No GPS at all - returns: the dimension with value of NO_FIX

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLDimension *)NO_FIX;

Page 246: Documentation iOS SDLAbstractProtocol Class Reference

the dimension with value of NO_FIX

+_2D

@abstract Longitude and latitude of the GPS - returns: the dimension with value

of 2D

SWIFT

class func no_FIX() -> SDLDimension!

RETURN VALUE

OBJECTIVE-C

+ (SDLDimension *)_2D;

SWIFT

class func _2D() -> SDLDimension!

Page 247: Documentation iOS SDLAbstractProtocol Class Reference

the dimension with value of 2D

+_3D

@abstract Longitude and latitude and altitude of the GPS - returns: the

dimension with value of 3D

the dimension with value of 3D

RETURN VALUE

OBJECTIVE-C

+ (SDLDimension *)_3D;

SWIFT

class func _3D() -> SDLDimension!

RETURN VALUE

Page 248: Documentation iOS SDLAbstractProtocol Class Reference

SDLDisplayCapabilities Class Reference

Section Contents

• -init• -initWithDictionary:• displayType• textFields• imageFields• mediaClockFormats• graphicSupported• templatesAvailable• screenParams• numCustomPresetsAvailable

Overview

Contains information about the display for the SDL system to which the

application is currently connected.

@since SDL 1.0

-init

Constructs a newly allocated SDLDisplayCapabilities object

OBJECTIVE-C

- (instancetype)init;

Page 249: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLDisplayCapabilities object indicated by the

dictionary parameter

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 250: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

displayType

@abstract The type of display

Required

textFields

@abstract An array of SDLTextField structures, each of which describes a field in

the HMI which the application can write to using operations such as SDLShow,

SDLSetMediaClockTimer, etc.

@discussion This array of SDLTextField structures identify all the text fields to

which the application can write on the current display (identified by

SDLDisplayType).

SeeSDLTextField

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDisplayType *displayType;

SWIFT

var displayType: SDLDisplayType! { get set }

Page 251: Documentation iOS SDLAbstractProtocol Class Reference

Required, Array of SDLTextField, 1 - 100 objects

imageFields

@abstract An array of SDLImageField elements

@discussion A set of all fields that support images.

SeeSDLImageField Optional, Array of SDLImageField, 1 - 100 objects

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *textFields;

SWIFT

var textFields: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *imageFields;

Page 252: Documentation iOS SDLAbstractProtocol Class Reference

mediaClockFormats

@abstract An array of SDLMediaClockFormat elements, defining the valid string

formats used in specifying the contents of the media clock field

SeeSDLMediaClockFormat Required, Array of SDLMediaClockFormats, 0 - 100 objects

graphicSupported

@abstract The display’s persistent screen supports.

SWIFT

var imageFields: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *mediaClockFormats;

SWIFT

var mediaClockFormats: NSMutableArray! { get set }

Page 253: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 2.0

Required, Boolean

templatesAvailable

@abstract Number of presets the screen supports

@discussion The number of on-screen custom presets available (if any)

Optional, Array of String, max string size 100, 0 - 100 objects

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *graphicSupported;

SWIFT

var graphicSupported: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *templatesAvailable;

Page 254: Documentation iOS SDLAbstractProtocol Class Reference

screenParams

@abstract A set of all parameters related to a prescribed screen area (e.g. for

video / touch input)

Optional

numCustomPresetsAvailable

@abstract The number of on-screen custom presets available (if any);

otherwise omitted

SWIFT

var templatesAvailable: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLScreenParams *screenParams;

SWIFT

var screenParams: SDLScreenParams! { get set }

Page 255: Documentation iOS SDLAbstractProtocol Class Reference

Optional, Integer 1 - 100

SDLDisplayType Class Reference

Section Contents

• +valueOf:• +values• +CID• +TYPE2• +TYPE5• +NGN• +GEN2_8_DMA• +GEN2_6_DMA• +MFD3• +MFD4

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *numCustomPresetsAvailable;

SWIFT

var numCustomPresetsAvailable: NSNumber! { get set }

Page 256: Documentation iOS SDLAbstractProtocol Class Reference

• +MFD5• +GEN3_8_INCH• +GENERIC

Overview

Identifies the various display types used by SDL.

@since SDL 1.0

+valueOf:

Convert String to SDLDisplayType

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLDisplayType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLDisplayType!

PARAMETERS

Page 257: Documentation iOS SDLAbstractProtocol Class Reference

SDLDisplayType

+values

@abstract Store the enumeration of all possible SDLDisplayType

an array that store all possible SDLDisplayType

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 258: Documentation iOS SDLAbstractProtocol Class Reference

+CID

@abstract This display type provides a 2-line x 20 character “dot matrix”

display.

SDLDisplayType with value of CID

+TYPE2

Undocumented

OBJECTIVE-C

+ (SDLDisplayType *)CID;

SWIFT

class func cid() -> SDLDisplayType!

RETURN VALUE

Page 259: Documentation iOS SDLAbstractProtocol Class Reference

+TYPE5

Undocumented

+NGN

@abstract This display type provides an 8 inch touchscreen display.

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

+ (SDLDisplayType *)NGN;

Page 260: Documentation iOS SDLAbstractProtocol Class Reference

SDLDisplayType with value of NGN

+GEN2_8_DMA

Undocumented

+GEN2_6_DMA

Undocumented

SWIFT

class func ngn() -> SDLDisplayType!

RETURN VALUE

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

Page 261: Documentation iOS SDLAbstractProtocol Class Reference

+MFD3

Undocumented

+MFD4

Undocumented

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

Page 262: Documentation iOS SDLAbstractProtocol Class Reference

+MFD5

Undocumented

+GEN3_8_INCH

Undocumented

+GENERIC

Undocumented

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

OBJECTIVE-C

@interface SDLDisplayType : SDLEnum

Page 263: Documentation iOS SDLAbstractProtocol Class Reference

SDLDriverDistractionState ClassReference

Section Contents

• +valueOf:• +values• +DD_ON• +DD_OFF

Overview

Enumeration that describes possible states of driver distraction.

@since SDL 1.0

+valueOf:

Convert String to SDLDisplayType

OBJECTIVE-C

+ (SDLDriverDistractionState *)valueOf:(NSString *)value;

Page 264: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLDisplayType

+values

@abstract Store the enumeration of all possible SDLDriverDistractionState

SWIFT

class func value(of value: String!) -> SDLDriverDistractionState!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 265: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLDriverDistractionState

+DD_ON

@abstract Driver distraction rules are in effect.

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLDriverDistractionState *)DD_ON;

SWIFT

class func dd_ON() -> SDLDriverDistractionState!

Page 266: Documentation iOS SDLAbstractProtocol Class Reference

a SDLDriverDistractionState with value of DD_ON

+DD_OFF

@abstract Driver distraction rules are NOT in effect.

a SDLDriverDistractionState with value of DD_OFF

RETURN VALUE

OBJECTIVE-C

+ (SDLDriverDistractionState *)DD_OFF;

SWIFT

class func dd_OFF() -> SDLDriverDistractionState!

RETURN VALUE

Page 267: Documentation iOS SDLAbstractProtocol Class Reference

SDLECallConfirmationStatus ClassReference

Section Contents

• +valueOf:• +values• +NORMAL• +CALL_IN_PROGRESS• +CALL_CANCELLED• +CALL_COMPLETED• +CALL_UNSUCCESSFUL• +ECALL_CONFIGURED_OFF• +CALL_COMPLETE_DTMF_TIMEOUT

Overview

Reflects the status of the eCall Notification. *Since SmartDeviceLink 2.0

+valueOf:

Undocumented

OBJECTIVE-C

@interface SDLECallConfirmationStatus : SDLEnum

Page 268: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+NORMAL

No E-Call signal triggered.

OBJECTIVE-C

@interface SDLECallConfirmationStatus : SDLEnum

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)NORMAL;

SWIFT

class func normal() -> SDLECallConfirmationStatus!

Page 269: Documentation iOS SDLAbstractProtocol Class Reference

+CALL_IN_PROGRESS

An E-Call is being in progress.

+CALL_CANCELLED

CALL_CANCELLED An E-Call was cancelled by the user.

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)CALL_IN_PROGRESS;

SWIFT

class func call_IN_PROGRESS() -> SDLECallConfirmationStatus!

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)CALL_CANCELLED;

Page 270: Documentation iOS SDLAbstractProtocol Class Reference

+CALL_COMPLETED

The E-Call sequence is completed.

+CALL_UNSUCCESSFUL

An E-Call could not be connected.

SWIFT

class func call_CANCELLED() -> SDLECallConfirmationStatus!

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)CALL_COMPLETED;

SWIFT

class func call_COMPLETED() -> SDLECallConfirmationStatus!

Page 271: Documentation iOS SDLAbstractProtocol Class Reference

+ECALL_CONFIGURED_OFF

E-Call is not configured on this vehicle.

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)CALL_UNSUCCESSFUL;

SWIFT

class func call_UNSUCCESSFUL() -> SDLECallConfirmationStatus!

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)ECALL_CONFIGURED_OFF;

SWIFT

class func ecall_CONFIGURED_OFF() -> SDLECallConfirmationStatus!

Page 272: Documentation iOS SDLAbstractProtocol Class Reference

+CALL_COMPLETE_DTMF_TIMEOUT

E-Call is considered to be complete without Emergency Operator contact.

SDLECallInfo Class Reference

Section Contents

• -init• -initWithDictionary:• eCallNotificationStatus• auxECallNotificationStatus• eCallConfirmationStatus

OBJECTIVE-C

+ (SDLECallConfirmationStatus *)CALL_COMPLETE_DTMF_TIMEOUT;

SWIFT

class func call_COMPLETE_DTMF_TIMEOUT() -> SDLECallConfirmationStatus!

Page 273: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

eCallNotificationStatus

Undocumented

auxECallNotificationStatus

Undocumented

eCallConfirmationStatus

Undocumented

SDLEmergencyEvent Class Reference

Section Contents

• -init• -initWithDictionary:• emergencyEventType

Page 274: Documentation iOS SDLAbstractProtocol Class Reference

• fuelCutoffStatus• rolloverEvent• maximumChangeVelocity• multipleEvents

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

emergencyEventType

Undocumented

fuelCutoffStatus

Undocumented

rolloverEvent

Undocumented

maximumChangeVelocity

Undocumented

Page 275: Documentation iOS SDLAbstractProtocol Class Reference

multipleEvents

Undocumented

SDLEmergencyEventType ClassReference

Section Contents

• +valueOf:• +values• +NO_EVENT• +FRONTAL• +SIDE• +REAR• +ROLLOVER• +NOT_SUPPORTED• +FAULT

Overview

Reflects the emergency event status of the vehicle. * Since: SmartDeviceLink

2.0 *

+valueOf:

Undocumented

Page 276: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+NO_EVENT

No emergency event has happened.

OBJECTIVE-C

@interface SDLEmergencyEventType : SDLEnum

OBJECTIVE-C

@interface SDLEmergencyEventType : SDLEnum

OBJECTIVE-C

+ (SDLEmergencyEventType *)NO_EVENT;

Page 277: Documentation iOS SDLAbstractProtocol Class Reference

+FRONTAL

Frontal collision has happened.

+SIDE

Side collision has happened.

SWIFT

class func no_() -> SDLEmergencyEventType!

OBJECTIVE-C

+ (SDLEmergencyEventType *)FRONTAL;

SWIFT

class func frontal() -> SDLEmergencyEventType!

Page 278: Documentation iOS SDLAbstractProtocol Class Reference

+REAR

Rear collision has happened.

OBJECTIVE-C

+ (SDLEmergencyEventType *)SIDE;

SWIFT

class func side() -> SDLEmergencyEventType!

OBJECTIVE-C

+ (SDLEmergencyEventType *)REAR;

SWIFT

class func rear() -> SDLEmergencyEventType!

Page 279: Documentation iOS SDLAbstractProtocol Class Reference

+ROLLOVER

A rollover event has happened.

+NOT_SUPPORTED

The signal is not supported

OBJECTIVE-C

+ (SDLEmergencyEventType *)ROLLOVER;

SWIFT

class func rollover() -> SDLEmergencyEventType!

OBJECTIVE-C

+ (SDLEmergencyEventType *)NOT_SUPPORTED;

Page 280: Documentation iOS SDLAbstractProtocol Class Reference

+FAULT

Emergency status cannot be determined

SWIFT

class func not_SUPPORTED() -> SDLEmergencyEventType!

OBJECTIVE-C

+ (SDLEmergencyEventType *)FAULT;

SWIFT

class func fault() -> SDLEmergencyEventType!

Page 281: Documentation iOS SDLAbstractProtocol Class Reference

SDLEncodedSyncPData Class Reference

Section Contents

• -init• -initWithDictionary:• data

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

data

Undocumented

Page 282: Documentation iOS SDLAbstractProtocol Class Reference

SDLEncodedSyncPDataResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

SDLEndAudioPassThru Class Reference

Section Contents

• -init

Page 283: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

When this request is invoked, the audio capture stops

Function Group: AudioPassThru

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 2.0

see SDLPerformAudioPassThru

-init

Constructs a new SDLEndAudioPassThru object

-initWithDictionary:

Constructs a new SDLEndAudioPassThru object indicated by the

NSMutableDictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 284: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLEndAudioPassThruResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 285: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

SDLEndAudioPassThruResponse is sent, when SDLEndAudioPassThru has been

called

Since SmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLEndAudioPassThruResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLEndAudioPassThruResponse : SDLRPCResponse

Page 286: Documentation iOS SDLAbstractProtocol Class Reference

SDLEnum Class Reference

Section Contents

• value• -initWithValue:• -isEqualToEnum:• value

Overview

Undocumented

value

Undocumented

-initWithValue:

Undocumented

-isEqualToEnum:

Undocumented

value

Undocumented

Page 287: Documentation iOS SDLAbstractProtocol Class Reference

SDLFile Class Reference

Section Contents

• persistent• overwrite• name• fileURL• data• fileType• -init• -initWithFileURL:name:persistent:• +persistentFileAtFileURL:name:• +fileAtFileURL:name:• -initWithData:name:fileExtension:persistent:• +persistentFileWithData:name:fileExtension:• +fileWithData:name:fileExtension:

Overview

Undocumented

persistent

Whether or not the file should persist on disk between car ignition cycles.

OBJECTIVE-C

@property (readonly, getter=isPersistent, assign, nonatomic) BOOL persistent;

Page 288: Documentation iOS SDLAbstractProtocol Class Reference

overwrite

Whether or not the file should overwrite an existing file on the remote disk with

the same name.

name

The name the file should be stored under on the remote disk. This is how the

file will be referenced in all later calls.

SWIFT

var isPersistent: Bool { get }

OBJECTIVE-C

@property (assign, readwrite, nonatomic) BOOL overwrite;

SWIFT

var overwrite: Bool { get set }

Page 289: Documentation iOS SDLAbstractProtocol Class Reference

fileURL

The url the local file is stored at while waiting to push it to the remote system. If

the data has not been passed to the file URL, this will be nil.

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSString *_Nonnull name;

SWIFT

var name: String { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic, nullable) NSURL *fileURL;

Page 290: Documentation iOS SDLAbstractProtocol Class Reference

data

The binary data of the SDLFile. If initialized with data, this will be a relatively

quick call, but if initialized with a file URL, this is a rather expensive call the first

time. The data will be cached in RAM after the first call.

fileType

The system will attempt to determine the type of file that you have passed in. It

will default to BINARY if it does not recognize the file type or the file type is not

supported by SDL.

SWIFT

var fileURL: URL? { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSData *_Nonnull data;

SWIFT

var data: Data { get }

Page 291: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithFileURL:name:persistent:

The designated initializer for an SDL File. The only major property that is not set

using this is “overwrite”, which defaults to NO.

OBJECTIVE-C

@property (readonly, strong, nonatomic) SDLFileType *_Nonnull fileType;

SWIFT

var fileType: SDLFileType { get }

OBJECTIVE-C

- (nonnull instancetype)initWithFileURL:(nonnull NSURL *)url name:(nonnull NSString *)name persistent:(BOOL)persistent;

Page 292: Documentation iOS SDLAbstractProtocol Class Reference

url

The file URL pointing to the local data that will be pushed to the remote

system.

name

The name that the file will be stored under on the remote system and

how it will be referenced from the local system.

persistent

Whether or not the file will persist between ignition cycles.

An SDLFile object.

SWIFT

init(fileURL url: URL, name: String, persistent: Bool)

PARAMETERS

RETURN VALUE

Page 293: Documentation iOS SDLAbstractProtocol Class Reference

+persistentFileAtFileURL:name:

Create an SDL file using a local file URL.

This is a persistent file, it will be persisted through sessions / ignition cycles.

You will only have a limited space for all files, so be sure to only persist files

that are required for all or most sessions. For example, menu artwork should be

persistent.

Ephemeral files should be created using ephemeralFileAtURL:name:

Warning

If this is not a readable file, this will return nil

OBJECTIVE-C

+ (nonnull instancetype)persistentFileAtFileURL:(nonnull NSURL *)url name:(nonnull NSString *)name;

SWIFT

class func persistentFile(atFileURL url: URL, name: String) -> Self

Page 294: Documentation iOS SDLAbstractProtocol Class Reference

url

The url to the file that should be uploaded.

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

An instance of this class, or nil if a readable file at the path could not be found.

+fileAtFileURL:name:

Create an SDL file using a local file URL.

This is an ephemeral file, it will not be persisted through sessions / ignition

cycles. Any files that you do not know you will use in future sessions should be

created through this method. For example, album / artist artwork should be

ephemeral.

Persistent files should be created using persistentFileAtURL:name:

Warning

If this is not a readable file, this will return nil

PARAMETERS

RETURN VALUE

Page 295: Documentation iOS SDLAbstractProtocol Class Reference

url

The url to the file on disk that will be uploaded

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

OBJECTIVE-C

+ (nonnull instancetype)fileAtFileURL:(nonnull NSURL *)url name:(nonnull NSString *)name;

SWIFT

convenience init(atFileURL url: URL, name: String)

PARAMETERS

Page 296: Documentation iOS SDLAbstractProtocol Class Reference

An instance of this class, or nil if a readable file at the url could not be found.

-initWithData:name:fileExtension:persistent:

Create an SDL file using raw data. It is strongly preferred to pass a file URL

instead of data, as it is currently held in memory until the file is sent.

RETURN VALUE

OBJECTIVE-C

- (nonnull instancetype)initWithData:(nonnull NSData *)data name:(nonnull NSString *)name fileExtension:(nonnull NSString *)extension persistent:(BOOL)persistent;

SWIFT

init(data: Data, name: String, fileExtension extension: String, persistent: Bool)

Page 297: Documentation iOS SDLAbstractProtocol Class Reference

data

The raw data to be used for the file

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

extension

The file extension. For example “png”. Currently supported file

extensions are: “bmp”, “jpg”, “jpeg”, “png”, “wav”, “mp3”, “aac”, “

json”. All others will be sent as binary files.

persistent

Whether or not the remote file with this data should be persistent

An instance of this class

PARAMETERS

RETURN VALUE

Page 298: Documentation iOS SDLAbstractProtocol Class Reference

+persistentFileWithData:name:fileExtension:

Create an SDL file using raw data. It is strongly preferred to pass a file URL

instead of data, as it is currently held in memory until the file is sent.

This is a persistent file, it will be persisted through sessions / ignition cycles.

You will only have a limited space for all files, so be sure to only persist files

that are required for all or most sessions. For example, menu artwork should be

persistent.

data

OBJECTIVE-C

+ (nonnull instancetype)persistentFileWithData:(nonnull NSData *)data name:(nonnull NSString *)name fileExtension:(nonnull NSString *)extension;

SWIFT

class func persistentFile(with data: Data, name: String, fileExtension extension: String) -> Self

PARAMETERS

Page 299: Documentation iOS SDLAbstractProtocol Class Reference

The raw data to be used for the file

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

extension

The file extension. For example “png”. Currently supported file

extensions are: “bmp”, “jpg”, “jpeg”, “png”, “wav”, “mp3”, “aac”, “

json”. All others will be sent as binary files.

An instance of this class

+fileWithData:name:fileExtension:

Create an SDL file using raw data. It is strongly preferred to pass a file URL

instead of data, as it is currently held in memory until the file is sent.

This is an ephemeral file, it will not be persisted through sessions / ignition

cycles. Any files that you do not know you will use in future sessions should be

RETURN VALUE

Page 300: Documentation iOS SDLAbstractProtocol Class Reference

created through this method. For example, album / artist artwork should be

ephemeral.

data

The raw data to be used for the file

name

The name of the file that will be used to reference the file in the future

(for example on the remote file system).

OBJECTIVE-C

+ (nonnull instancetype)fileWithData:(nonnull NSData *)data name:(nonnull NSString *)name fileExtension:(nonnull NSString *)extension;

SWIFT

convenience init(data: Data, name: String, fileExtension extension: String)

PARAMETERS

Page 301: Documentation iOS SDLAbstractProtocol Class Reference

extension

The file extension. For example “png”. Currently supported file

extensions are: “bmp”, “jpg”, “jpeg”, “png”, “wav”, “mp3”, “aac”, “

json”. All others will be sent as binary files.

An instance of this class

SDLFileManager Class Reference

Section Contents

• remoteFileNames• bytesAvailable• currentState• pendingTransactions• suspended• -init• -initWithConnectionManager:• -startWithCompletionHandler:• -stop• -deleteRemoteFileWithName:completionHandler:• -uploadFile:completionHandler:

RETURN VALUE

Page 302: Documentation iOS SDLAbstractProtocol Class Reference

• +temporaryFileDirectory

Overview

The SDLFileManager is an RPC manager for the remote file system. After it

starts, it will attempt to communicate with the remote file system to get the

names of all files. Deleting and Uploading will them queue these changes as

transactions. If a delete succeeds, the local list of remote files will remove that

file name, and likewise, if an upload succeeds, the local list of remote files will

now include that file name.

remoteFileNames

A set of all names of files known on the remote head unit. Known files can be

used or deleted on the remote system.

bytesAvailable

The number of bytes still available for files for this app.

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSSet<SDLFileName *> *_Nonnull remoteFileNames;

SWIFT

var remoteFileNames: Set

Page 303: Documentation iOS SDLAbstractProtocol Class Reference

currentState

The state of the file manager.

OBJECTIVE-C

@property (readonly, assign, nonatomic) NSUInteger bytesAvailable;

SWIFT

var bytesAvailable: UInt { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSString *_Nonnull currentState;

SWIFT

var currentState: String { get }

Page 304: Documentation iOS SDLAbstractProtocol Class Reference

pendingTransactions

The currently pending transactions (Upload, Delete, and List Files) in the file

manager

suspended

Whether or not the file manager is suspended. If suspended, the file manager

can continue to queue uploads and deletes, but will not actually perform any of

those until it is no longer suspended. This can be used for throttling down the

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSArray<__kindof NSOperation *> *_Nonnull pendingTransactions;

SWIFT

var pendingTransactions: [Operation] { get }

Page 305: Documentation iOS SDLAbstractProtocol Class Reference

file manager if other, important operations are taking place over the accessory

connection.

-init

Initialize the class…or not, since this method is unavailable. Dependencies

must be injected using initWithConnectionManager:

OBJECTIVE-C

@property (assign, readwrite, nonatomic) BOOL suspended;

SWIFT

var suspended: Bool { get set }

OBJECTIVE-C

- (nonnull instancetype)init;

Page 306: Documentation iOS SDLAbstractProtocol Class Reference

nil

-initWithConnectionManager:

Creates a new file manager with a specified connection manager

manager

A connection manager to use to forward on RPCs

An instance of SDLFileManager

RETURN VALUE

OBJECTIVE-C

- (nonnull instancetype)initWithConnectionManager: (nonnull id<SDLConnectionManagerType>)manager;

PARAMETERS

RETURN VALUE

Page 307: Documentation iOS SDLAbstractProtocol Class Reference

-startWithCompletionHandler:

The manager stars up and attempts to fetch its initial list and transfer initial

files.

completionHandler

OBJECTIVE-C

- (void)startWithCompletionHandler: (nullable SDLFileManagerStartupCompletionHandler)completionHandler;

SWIFT

func start(completionHandler: SDLFileManagerStartupCompletionHandler? = nil)

PARAMETERS

Page 308: Documentation iOS SDLAbstractProtocol Class Reference

The handler called when the manager is set up or failed to set up with

an error. Use weak self when accessing self from the completion

handler.

-stop

Cancels all file manager operations and deletes all associated data.

-deleteRemoteFileWithName:completionHandler:

Delete a file stored on the remote system

OBJECTIVE-C

- (void)stop;

SWIFT

func stop()

Page 309: Documentation iOS SDLAbstractProtocol Class Reference

name

The name of the remote file. It should be a name currently stored in

remoteFileNames

completion

OBJECTIVE-C

- (void)deleteRemoteFileWithName:(nonnull SDLFileName *)name completionHandler: (nullable SDLFileManagerDeleteCompletionHandler)completion;

SWIFT

func deleteRemoteFile(withName name: String, completionHandler completion: SDLFileManagerDeleteCompletionHandler? = nil)

PARAMETERS

Page 310: Documentation iOS SDLAbstractProtocol Class Reference

An optional completion handler that sends an error should one occur.

-uploadFile:completionHandler:

Upload a file to the remote file system. If a file with the [SDLFile name] already

exists, this will overwrite that file. If you do not want that to happen, check

remoteFileNames before uploading, or change allowOverwrite to NO.

file

An SDLFile that contains metadata about the file to be sent

OBJECTIVE-C

- (void)uploadFile:(nonnull SDLFile *)file completionHandler: (nullable SDLFileManagerUploadCompletionHandler)completion;

SWIFT

func uploadFile(_ file: SDLFile, completionHandler completion: SDLFileManagerUploadCompletionHandler? = nil)

PARAMETERS

Page 311: Documentation iOS SDLAbstractProtocol Class Reference

completion

An optional completion handler that sends an error should one occur.

+temporaryFileDirectory

A URL to the directory where temporary files are stored. When an SDLFile is

created with NSData, it writes to a temporary file until the file manager finishes

uploading it.

The SDL library manages the creation and deletion of these files and you

should not have to touch this directory at all.

OBJECTIVE-C

+ (nonnull NSURL *)temporaryFileDirectory;

SWIFT

class func temporaryFileDirectory() -> URL

Page 312: Documentation iOS SDLAbstractProtocol Class Reference

An NSURL pointing to the location on disk where SDL’s temporary files are

stored.

SDLFileType Class Reference

Section Contents

• +valueOf:• +values• +GRAPHIC_BMP• +GRAPHIC_JPEG• +GRAPHIC_PNG• +AUDIO_WAVE• +AUDIO_MP3• +AUDIO_AAC• +BINARY• +JSON

Overview

Enumeration listing possible file types.

@since SDL 2.0

+valueOf:

@abstract Convert String to SDLFileType

RETURN VALUE

Page 313: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object for

SDLFileType

+values

@abstract Store the enumeration of all possible SDLFileType

OBJECTIVE-C

+ (SDLFileType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLFileType!

PARAMETERS

RETURN VALUE

Page 314: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLFileType

+GRAPHIC_BMP

@abstract file type: Bitmap (BMP)

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)GRAPHIC_BMP;

Page 315: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileType with value of GRAPHIC_BMP

+GRAPHIC_JPEG

@abstract file type: JPEG

SWIFT

class func graphic_BMP() -> SDLFileType!

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)GRAPHIC_JPEG;

SWIFT

class func graphic_JPEG() -> SDLFileType!

Page 316: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileType with value of GRAPHIC_JPEG

+GRAPHIC_PNG

@abstract file type: PNG

SDLFileType with value of GRAPHIC_PNG

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)GRAPHIC_PNG;

SWIFT

class func graphic_PNG() -> SDLFileType!

RETURN VALUE

Page 317: Documentation iOS SDLAbstractProtocol Class Reference

+AUDIO_WAVE

@abstract file type: WAVE (WAV)

SDLFileType with value of AUDIO_WAVE

+AUDIO_MP3

@abstract file type: MP3

OBJECTIVE-C

+ (SDLFileType *)AUDIO_WAVE;

SWIFT

class func audio_WAVE() -> SDLFileType!

RETURN VALUE

Page 318: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileType with value of AUDIO_MP3

+AUDIO_AAC

@abstract file type: AAC

OBJECTIVE-C

+ (SDLFileType *)AUDIO_MP3;

SWIFT

class func audio_MP3() -> SDLFileType!

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)AUDIO_AAC;

Page 319: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileType with value of AUDIO_AAC

+BINARY

@abstract file type: BINARY

SWIFT

class func audio_AAC() -> SDLFileType!

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)BINARY;

SWIFT

class func binary() -> SDLFileType!

Page 320: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileType with value of BINARY

+JSON

@abstract file type: JSON

SDLFileType with value of JSON

RETURN VALUE

OBJECTIVE-C

+ (SDLFileType *)JSON;

SWIFT

class func json() -> SDLFileType!

RETURN VALUE

Page 321: Documentation iOS SDLAbstractProtocol Class Reference

SDLFuelCutoffStatus Class Reference

Section Contents

• +valueOf:• +values• +TERMINATE_FUEL• +NORMAL_OPERATION• +FAULT

Overview

Reflects the status of the Restraints Control Module fuel pump cutoff. The fuel

pump is cut off typically after the vehicle has had a collision.

@since SDL 2.0

+valueOf:

@abstract Convert String to SDLFuelCutoffStatus

OBJECTIVE-C

+ (SDLFuelCutoffStatus *)valueOf:(NSString *)value;

Page 322: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object for

SDLFuelCutoffStatus

+values

@abstract Store the enumeration of all possible SDLFuelCutoffStatus

SWIFT

class func value(of value: String!) -> SDLFuelCutoffStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 323: Documentation iOS SDLAbstractProtocol Class Reference

an array that stores all possible SDLFuelCutoffStatus

+TERMINATE_FUEL

@abstract Fuel is cut off - returns: the fuel cutoff status: TERMINATE_FUEL

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLFuelCutoffStatus *)TERMINATE_FUEL;

SWIFT

class func terminate_FUEL() -> SDLFuelCutoffStatus!

Page 324: Documentation iOS SDLAbstractProtocol Class Reference

the fuel cutoff status: TERMINATE_FUEL

+NORMAL_OPERATION

@abstract Fuel is not cut off - returns: the fuel cutoff status:

NORMAL_OPERATION

the fuel cutoff status: NORMAL_OPERATION

RETURN VALUE

OBJECTIVE-C

+ (SDLFuelCutoffStatus *)NORMAL_OPERATION;

SWIFT

class func normal_OPERATION() -> SDLFuelCutoffStatus!

RETURN VALUE

Page 325: Documentation iOS SDLAbstractProtocol Class Reference

+FAULT

@abstract Status of the fuel pump cannot be determined - returns: the fuel

cutoff status: FAULT

the fuel cutoff status: FAULT

OBJECTIVE-C

+ (SDLFuelCutoffStatus *)FAULT;

SWIFT

class func fault() -> SDLFuelCutoffStatus!

RETURN VALUE

Page 326: Documentation iOS SDLAbstractProtocol Class Reference

SDLGPSData Class Reference

Section Contents

• -init• -initWithDictionary:• longitudeDegrees• latitudeDegrees• utcYear• utcMonth• utcDay• utcHours• utcMinutes• utcSeconds• compassDirection• pdop• hdop• vdop• actual• satellites• dimension• altitude• heading• speed

Overview

Describes the GPS data. Not all data will be available on all carlines.

@since SDL 2.0

-init

Constructs a newly allocated SDLGPSData object

Page 327: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLGPSData object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 328: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

longitudeDegrees

@abstract longitude degrees

Required, Float, -180 - 180

latitudeDegrees

@abstract latitude degrees

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *longitudeDegrees;

SWIFT

var longitudeDegrees: NSNumber! { get set }

Page 329: Documentation iOS SDLAbstractProtocol Class Reference

Required, Float, -90 - 90

utcYear

@abstract utc year

Required, Integer, 2010 - 2100

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *latitudeDegrees;

SWIFT

var latitudeDegrees: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcYear;

Page 330: Documentation iOS SDLAbstractProtocol Class Reference

utcMonth

@abstract utc month

Required, Integer, 1 - 12

utcDay

@abstract utc day

Required, Integer, 1 - 31

SWIFT

var utcYear: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcMonth;

SWIFT

var utcMonth: NSNumber! { get set }

Page 331: Documentation iOS SDLAbstractProtocol Class Reference

utcHours

@abstract utc hours

Required, Integer, 0 - 23

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcDay;

SWIFT

var utcDay: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcHours;

SWIFT

var utcHours: NSNumber! { get set }

Page 332: Documentation iOS SDLAbstractProtocol Class Reference

utcMinutes

@abstract utc minutes

Required, Integer, 0 - 59

utcSeconds

@abstract utc seconds

Required, Integer, 0 - 59

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcMinutes;

SWIFT

var utcMinutes: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *utcSeconds;

Page 333: Documentation iOS SDLAbstractProtocol Class Reference

compassDirection

Potential Compass Directions

pdop

@abstract The 3D positional dilution of precision.

@discussion If undefined or unavailable, then value shall be set to 0

Required, Float, 0.0 - 10.0

SWIFT

var utcSeconds: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLCompassDirection *compassDirection;

SWIFT

var compassDirection: SDLCompassDirection! { get set }

Page 334: Documentation iOS SDLAbstractProtocol Class Reference

hdop

@abstract The horizontal dilution of precision

@discussion If undefined or unavailable, then value shall be set to 0

Required, Float, 0.0 - 10.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *pdop;

SWIFT

var pdop: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *hdop;

Page 335: Documentation iOS SDLAbstractProtocol Class Reference

vdop

@abstract the vertical dilution of precision

@discussion If undefined or unavailable, then value shall be set to 0

Required, Float, 0.0 - 10.0

actual

@abstract What the coordinates are based on

SWIFT

var hdop: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *vdop;

SWIFT

var vdop: NSNumber! { get set }

Page 336: Documentation iOS SDLAbstractProtocol Class Reference

@discussion YES, if coordinates are based on satellites. NO, if based on dead

reckoning.

Required, Boolean

satellites

@abstract The number of satellites in view

Required, Integer, 0 - 31

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *actual;

SWIFT

var actual: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *satellites;

Page 337: Documentation iOS SDLAbstractProtocol Class Reference

dimension

The supported dimensions of the GPS

Required

altitude

@abstract altitude in meters

Required, Float, -10000.0 - 10000.0

SWIFT

var satellites: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDimension *dimension;

SWIFT

var dimension: SDLDimension! { get set }

Page 338: Documentation iOS SDLAbstractProtocol Class Reference

heading

@abstract Heading based on the GPS data.

@discussion North is 0, East is 90, etc. Resolution is 0.01

Required, Float, 0.0 - 359.99

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *altitude;

SWIFT

var altitude: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *heading;

Page 339: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract speed in KPH

Required, Float, 0.0 - 500.0

SWIFT

var heading: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

SWIFT

var speed: NSNumber! { get set }

Page 340: Documentation iOS SDLAbstractProtocol Class Reference

SDLGenericResponse Class Reference

Section Contents

• -init• -initWithDictionary:

Overview

Generic Response is sent, when the name of a received msg cannot be

retrieved. Only used in case of an error. Currently, only resultCode

INVALID_DATA is used.

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLGenericResponse : SDLRPCResponse

Page 341: Documentation iOS SDLAbstractProtocol Class Reference

SDLGetDTCs Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithECUName:• -initWithECUName:mask:• ecuName• dtcMask

Overview

This RPC allows to request diagnostic module trouble codes from a certain

vehicle module

Function Group: ProprietaryData

HMILevel needs to be FULL, LIMITED or BACKGROUND

-init

Constructs a new SDLGetDTCs object

OBJECTIVE-C

@interface SDLGenericResponse : SDLRPCResponse

Page 342: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLGetDTCs object indicated by the dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 343: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithECUName:

Undocumented

-initWithECUName:mask:

Undocumented

PARAMETERS

OBJECTIVE-C

@interface SDLGetDTCs : SDLRPCRequest

OBJECTIVE-C

@interface SDLGetDTCs : SDLRPCRequest

Page 344: Documentation iOS SDLAbstractProtocol Class Reference

ecuName

@abstract a name of the module to receive the DTC form @discussion an

NSNumber value representing a name of the module to receive the DTC form

Notes: Minvalue:0; Maxvalue:65535

dtcMask

@abstract DTC Mask Byte to be sent in diagnostic request to module.

NSNumber* dtcMask Minvalue:0; Maxvalue:255

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *ecuName;

SWIFT

var ecuName: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *dtcMask;

Page 345: Documentation iOS SDLAbstractProtocol Class Reference

SDLGetDTCsResponse Class Reference

Section Contents

• -init• -initWithDictionary:• ecuHeader• dtc

Overview

SDLGetDTCsResponse is sent, when SDLGetDTCs has been called

Since SmartDeviceLink 2.0

-init

Undocumented

SWIFT

var dtcMask: NSNumber! { get set }

Page 346: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

ecuHeader

Undocumented

OBJECTIVE-C

@interface SDLGetDTCsResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLGetDTCsResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLGetDTCsResponse : SDLRPCResponse

Page 347: Documentation iOS SDLAbstractProtocol Class Reference

dtc

Undocumented

SDLGetVehicleData Class Reference

Section Contents

• -init• -initWithDictionary:• -

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clusterModeStatus:deviceStatus:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• vin• prndl• tirePressure• odometer• beltStatus

OBJECTIVE-C

@interface SDLGetDTCsResponse : SDLRPCResponse

Page 348: Documentation iOS SDLAbstractProtocol Class Reference

• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModeStatus• myKey

Overview

Requests surrent values of specific published vehicle data items.

Function Group: Location, VehicleInfo and DrivingChara

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 2.0

See SDLSubscribeVehicleData SDLUnsubscribeVehicleData

-init

@abstract Constructs a new SDLGetVehicleData object

OBJECTIVE-C

- (instancetype)init;

Page 349: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLGetVehicleData object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 350: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clu

Undocumented

gps

@abstract A boolean value. If true, requests Gps data

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *gps;

SWIFT

var gps: NSNumber! { get set }

Page 351: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract A boolean value. If true, requests speed data

rpm

@abstract A boolean value. If true, requests rpm data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

SWIFT

var speed: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rpm;

Page 352: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel

@abstract A boolean value. If true, requests FuelLevel data

fuelLevel_State

@abstract A boolean value. If true, requests fuelLevel_State data

SWIFT

var rpm: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel;

SWIFT

var fuelLevel: NSNumber! { get set }

Page 353: Documentation iOS SDLAbstractProtocol Class Reference

instantFuelConsumption

@abstract A boolean value. If true, requests instantFuelConsumption data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel_State;

SWIFT

var fuelLevel_State: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *instantFuelConsumption;

SWIFT

var instantFuelConsumption: NSNumber! { get set }

Page 354: Documentation iOS SDLAbstractProtocol Class Reference

externalTemperature

@abstract A boolean value. If true, requests externalTemperature data

vin

@abstract A boolean value. If true, requests Vehicle Identification Number

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *externalTemperature;

SWIFT

var externalTemperature: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *vin;

Page 355: Documentation iOS SDLAbstractProtocol Class Reference

prndl

@abstract A boolean value. If true, requests Currently selected gear data

tirePressure

@abstract A boolean value. If true, requests tire pressure status data

SWIFT

var vin: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *prndl;

SWIFT

var prndl: NSNumber! { get set }

Page 356: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract A boolean value. If true, requests odometer data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *tirePressure;

SWIFT

var tirePressure: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *odometer;

SWIFT

var odometer: NSNumber! { get set }

Page 357: Documentation iOS SDLAbstractProtocol Class Reference

beltStatus

@abstract A boolean value. If true, requests belt Status data

bodyInformation

@abstract A boolean value. If true, requests body Information data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *beltStatus;

SWIFT

var beltStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *bodyInformation;

Page 358: Documentation iOS SDLAbstractProtocol Class Reference

deviceStatus

@abstract A boolean value. If true, requests device Status data

driverBraking

@abstract A boolean value. If true, requests driver Braking data

SWIFT

var bodyInformation: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *deviceStatus;

SWIFT

var deviceStatus: NSNumber! { get set }

Page 359: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A boolean value. If true, requests wiper Status data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *driverBraking;

SWIFT

var driverBraking: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *wiperStatus;

SWIFT

var wiperStatus: NSNumber! { get set }

Page 360: Documentation iOS SDLAbstractProtocol Class Reference

headLampStatus

@abstract A boolean value. If true, requests Head Lamp Status data

engineTorque

@abstract A boolean value. If true, requests Engine Torque data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *headLampStatus;

SWIFT

var headLampStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *engineTorque;

Page 361: Documentation iOS SDLAbstractProtocol Class Reference

accPedalPosition

@abstract A boolean value. If true, means the accPedalPosition data has been

subscribed.

steeringWheelAngle

@abstract A boolean value. If true, means the steeringWheelAngle data has

been subscribed.

SWIFT

var engineTorque: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *accPedalPosition;

SWIFT

var accPedalPosition: NSNumber! { get set }

Page 362: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *steeringWheelAngle;

SWIFT

var steeringWheelAngle: NSNumber! { get set }

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

Page 363: Documentation iOS SDLAbstractProtocol Class Reference

emergencyEvent

Undocumented

clusterModeStatus

Undocumented

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

Page 364: Documentation iOS SDLAbstractProtocol Class Reference

myKey

Undocumented

SDLGetVehicleDataResponse ClassReference

Section Contents

• -init• -initWithDictionary:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• vin• prndl• tirePressure• odometer• beltStatus

OBJECTIVE-C

@interface SDLGetVehicleData : SDLRPCRequest

Page 365: Documentation iOS SDLAbstractProtocol Class Reference

• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModeStatus• myKey

Overview

Get Vehicle Data Response is sent, when SDLGetVehicleData has been called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLGetVehicleDataResponse object

OBJECTIVE-C

- (instancetype)init;

Page 366: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLGetVehicleDataResponse object indicated by

the NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 367: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

gps

@abstract A SDLGPSData* value. See GPSData.

speed

@abstract The vehicle speed in kilometers per hour.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLGPSData *gps;

SWIFT

var gps: SDLGPSData! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

Page 368: Documentation iOS SDLAbstractProtocol Class Reference

rpm

@abstract The number of revolutions per minute of the engine.

fuelLevel

@abstract The fuel level in the tank (percentage)

SWIFT

var speed: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rpm;

SWIFT

var rpm: NSNumber! { get set }

Page 369: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel_State

@abstract A SDLComponentVolumeStatus* value. The fuel level state.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel;

SWIFT

var fuelLevel: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLComponentVolumeStatus *fuelLevel_State;

SWIFT

var fuelLevel_State: SDLComponentVolumeStatus! { get set }

Page 370: Documentation iOS SDLAbstractProtocol Class Reference

instantFuelConsumption

@abstract The instantaneous fuel consumption in microlitres.

externalTemperature

@abstract The external temperature in degrees celsius.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *instantFuelConsumption;

SWIFT

var instantFuelConsumption: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *externalTemperature;

Page 371: Documentation iOS SDLAbstractProtocol Class Reference

vin

@abstract The Vehicle Identification Number

prndl

@abstract See PRNDL.

SWIFT

var externalTemperature: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *vin;

SWIFT

var vin: String! { get set }

Page 372: Documentation iOS SDLAbstractProtocol Class Reference

tirePressure

@abstract A SDLTireStatus* value. See TireStatus.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLPRNDL *prndl;

SWIFT

var prndl: SDLPRNDL! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTireStatus *tirePressure;

SWIFT

var tirePressure: SDLTireStatus! { get set }

Page 373: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract Odometer reading in km.

beltStatus

@abstract A SDLBeltStatus* value. The status of the seat belts.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *odometer;

SWIFT

var odometer: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBeltStatus *beltStatus;

Page 374: Documentation iOS SDLAbstractProtocol Class Reference

bodyInformation

@abstract A SDLBodyInformation* value. The body information including power

modes.

deviceStatus

@abstract A SDLDeviceStatus* value. The device status including signal and

battery strength.

SWIFT

var beltStatus: SDLBeltStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBodyInformation *bodyInformation;

SWIFT

var bodyInformation: SDLBodyInformation! { get set }

Page 375: Documentation iOS SDLAbstractProtocol Class Reference

driverBraking

@abstract A SDLVehicleDataResult* value. The status of the brake pedal.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDeviceStatus *deviceStatus;

SWIFT

var deviceStatus: SDLDeviceStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataEventStatus *driverBraking;

SWIFT

var driverBraking: SDLVehicleDataEventStatus! { get set }

Page 376: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A SDLWiperStatus* value. The status of the wipers.

headLampStatus

@abstract A SDLHeadLampStatus* value. Status of the head lamps.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLWiperStatus *wiperStatus;

SWIFT

var wiperStatus: SDLWiperStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLHeadLampStatus *headLampStatus;

Page 377: Documentation iOS SDLAbstractProtocol Class Reference

engineTorque

@abstract Torque value for engine (in Nm) on non-diesel variants.

accPedalPosition

@abstract Accelerator pedal position (percentage depressed)

SWIFT

var headLampStatus: SDLHeadLampStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *engineTorque;

SWIFT

var engineTorque: NSNumber! { get set }

Page 378: Documentation iOS SDLAbstractProtocol Class Reference

steeringWheelAngle

@abstract Current angle of the steering wheel (in deg)

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *accPedalPosition;

SWIFT

var accPedalPosition: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *steeringWheelAngle;

SWIFT

var steeringWheelAngle: NSNumber! { get set }

Page 379: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

emergencyEvent

Undocumented

OBJECTIVE-C

@interface SDLGetVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLGetVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLGetVehicleDataResponse : SDLRPCResponse

Page 380: Documentation iOS SDLAbstractProtocol Class Reference

clusterModeStatus

Undocumented

myKey

Undocumented

SDLGlobalProperty Class Reference

Section Contents

• +valueOf:• +values• +HELPPROMPT

OBJECTIVE-C

@interface SDLGetVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLGetVehicleDataResponse : SDLRPCResponse

Page 381: Documentation iOS SDLAbstractProtocol Class Reference

• +TIMEOUTPROMPT• +VRHELPTITLE• +VRHELPITEMS• +MENUNAME• +MENUICON• +KEYBOARDPROPERTIES

Overview

Properties of a user-initiated VR interaction (i.e. interactions started by the user

pressing the PTT button).

@since SDL 1.0

+valueOf:

Convert String to SDLGlobalProperty - parameter: value The value of the string

to get an object for - returns: SDLGlobalProperty

OBJECTIVE-C

+ (SDLGlobalProperty *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLGlobalProperty!

Page 382: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLGlobalProperty

+values

@abstract Store the enumeration of all possible SDLGlobalProperty - returns: An

array that store all possible SDLGlobalProperty

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 383: Documentation iOS SDLAbstractProtocol Class Reference

An array that store all possible SDLGlobalProperty

+HELPPROMPT

@abstract The help prompt to be spoken if the user needs assistance during a

user-initiated interaction. - returns: A SDLGlobalProperty with value of

HELPPROMPT

A SDLGlobalProperty with value of HELPPROMPT

RETURN VALUE

OBJECTIVE-C

+ (SDLGlobalProperty *)HELPPROMPT;

SWIFT

class func helpprompt() -> SDLGlobalProperty!

RETURN VALUE

Page 384: Documentation iOS SDLAbstractProtocol Class Reference

+TIMEOUTPROMPT

@abstract The prompt to be spoken if the user-initiated interaction times out

waiting for the user’s verbal input. - returns: A SDLGlobalProperty with value of

TIMEOUTPROMPT

A SDLGlobalProperty with value of TIMEOUTPROMPT

+VRHELPTITLE

Undocumented

OBJECTIVE-C

+ (SDLGlobalProperty *)TIMEOUTPROMPT;

SWIFT

class func timeoutprompt() -> SDLGlobalProperty!

RETURN VALUE

Page 385: Documentation iOS SDLAbstractProtocol Class Reference

+VRHELPITEMS

Undocumented

+MENUNAME

Undocumented

OBJECTIVE-C

@interface SDLGlobalProperty : SDLEnum

OBJECTIVE-C

@interface SDLGlobalProperty : SDLEnum

OBJECTIVE-C

@interface SDLGlobalProperty : SDLEnum

Page 386: Documentation iOS SDLAbstractProtocol Class Reference

+MENUICON

Undocumented

+KEYBOARDPROPERTIES

Undocumented

SDLHMICapabilities Class Reference

Section Contents

• -init• -initWithDictionary:• navigation

OBJECTIVE-C

@interface SDLGlobalProperty : SDLEnum

OBJECTIVE-C

@interface SDLGlobalProperty : SDLEnum

Page 387: Documentation iOS SDLAbstractProtocol Class Reference

• phoneCall

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

navigation

Availability of build in Nav. True: Available, False: Not Available

Boolean value. Optional.

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber *navigation;

SWIFT

@NSCopying var navigation: NSNumber! { get set }

Page 388: Documentation iOS SDLAbstractProtocol Class Reference

phoneCall

Availability of build in phone. True: Available, False: Not Available

Boolean value. Optional.

SDLHMILevel Class Reference

Section Contents

• +valueOf:• +values• +FULL• +LIMITED• +BACKGROUND• +NONE

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber *phoneCall;

SWIFT

@NSCopying var phoneCall: NSNumber! { get set }

Page 389: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Specifies current level of the HMI. An HMI level indicates the degree of user

interaction possible through the HMI (e.g. TTS only, display only, VR, etc.). The

HMI level varies for an application based on the type of display (i.e. Nav or non-

Nav) and the user directing “focus” to other applications (e.g. phone, other

mobile applications, etc.)

@since SDL 1.0

+valueOf:

Return HMILevel status (FULL, LIMITED, BACKGROUND, NONE)

value

OBJECTIVE-C

+ (SDLHMILevel *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLHMILevel!

PARAMETERS

Page 390: Documentation iOS SDLAbstractProtocol Class Reference

String value to retrieve the object for

Current HMI level

+values

Store all possible SDLHMILevel values

an array with all possible HMILevel values inside

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 391: Documentation iOS SDLAbstractProtocol Class Reference

+FULL

The application has full use of the SDL HMI. The app may output via TTS,

display, or streaming audio and may gather input via VR, Menu, and button

presses

the HMILevel with value of FULL

+LIMITED

This HMI Level is only defined for a media application using an HMI with an 8

inch touchscreen (Nav) system. The application’s Show text is displayed and it

receives button presses from media-oriented buttons (SEEKRIGHT, SEEKLEFT,

TUNEUP, TUNEDOWN, PRESET_0-9)

OBJECTIVE-C

+ (SDLHMILevel *)FULL;

SWIFT

class func full() -> SDLHMILevel!

RETURN VALUE

Page 392: Documentation iOS SDLAbstractProtocol Class Reference

the HMILevel with value of LIMITED

+BACKGROUND

App cannot interact with user via TTS, VR, Display or Button Presses. App can

perform the following operations:

@discussion

• Operation : AddCommand• Operation : DeleteCommand• Operation : AddSubMenu• Operation : DeleteSubMenu• Operation : CreateInteractionChoiceSet• Operation : DeleteInteractionChoiceSet

OBJECTIVE-C

+ (SDLHMILevel *)LIMITED;

SWIFT

class func limited() -> SDLHMILevel!

RETURN VALUE

Page 393: Documentation iOS SDLAbstractProtocol Class Reference

• Operation : SubscribeButton• Operation : UnsubscribeButton• Operation : Show• Operation : UnregisterAppInterface• Operation : ResetGlobalProperties• Operation : SetGlobalProperties

the HMILevel with value of BACKGROUND

+NONE

Application has been discovered by SDL, but it cannot send any requests or

receive any notifications

@discussion An HMILevel of NONE can also mean that the user has exited the

application by saying “exit appname” or selecting “exit” from the application’s

OBJECTIVE-C

+ (SDLHMILevel *)BACKGROUND;

SWIFT

class func background() -> SDLHMILevel!

RETURN VALUE

Page 394: Documentation iOS SDLAbstractProtocol Class Reference

menu. When this happens, the application still has an active interface

registration with SDL and all SDL resources the application has created (e.g.

Choice Sets, subscriptions, etc.) still exist. But while the HMILevel is NONE, the

application cannot send any messages to SYNC, except UnregisterAppInterface

the HMILevel with value of NONE

SDLHMIPermissions Class Reference

Section Contents

• -init• -initWithDictionary:

OBJECTIVE-C

+ (SDLHMILevel *)NONE;

SWIFT

class func none() -> SDLHMILevel!

RETURN VALUE

Page 395: Documentation iOS SDLAbstractProtocol Class Reference

• allowed• userDisallowed

Overview

Defining sets of HMI levels, which are permitted or prohibited for a given RPC.

@since SDL 2.0

-init

Constructs a newly allocated SDLHMIPermissions object

-initWithDictionary:

Constructs a newly allocated SDLHMIPermissions object indicated by the

dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 396: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

allowed

@abstract a set of all HMI levels that are permitted for this given RPC

SeeSDLHMILevel Required, Array of SDLHMILevel, Array size 0 - 100

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 397: Documentation iOS SDLAbstractProtocol Class Reference

userDisallowed

@abstract a set of all HMI levels that are prohibited for this given RPC

SeeSDLHMILevel Required, Array of SDLHMILevel, Array size 0 - 100

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *allowed;

SWIFT

var allowed: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *userDisallowed;

Page 398: Documentation iOS SDLAbstractProtocol Class Reference

SDLHMIZoneCapabilities ClassReference

Section Contents

• +valueOf:• +values• +FRONT• +BACK

Overview

Specifies HMI Zones in the vehicle.

@since SDL 1.0

+valueOf:

@abstract SDLHMIZoneCapabilities - parameter: value The value of the string

to get an object for - returns: SDLHMIZoneCapabilities

SWIFT

var userDisallowed: NSMutableArray! { get set }

Page 399: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLHMIZoneCapabilities

OBJECTIVE-C

+ (SDLHMIZoneCapabilities *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLHMIZoneCapabilities!

PARAMETERS

RETURN VALUE

Page 400: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract store all possible SDLHMIZoneCapabilities values - returns: an array

with all possible SDLHMIZoneCapabilities values inside

an array with all possible SDLHMIZoneCapabilities values inside

+FRONT

@abstract Indicates HMI available for front seat passengers. - returns: a

SDLHMIZoneCapabilities with value of FRONT

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 401: Documentation iOS SDLAbstractProtocol Class Reference

a SDLHMIZoneCapabilities with value of FRONT

+BACK

@abstract Indicates HMI available for rear seat passengers. - returns: a

SDLHMIZoneCapabilities with value of BACK

OBJECTIVE-C

+ (SDLHMIZoneCapabilities *)FRONT;

SWIFT

class func front() -> SDLHMIZoneCapabilities!

RETURN VALUE

OBJECTIVE-C

+ (SDLHMIZoneCapabilities *)BACK;

Page 402: Documentation iOS SDLAbstractProtocol Class Reference

a SDLHMIZoneCapabilities with value of BACK

SDLHeadLampStatus Class Reference

Section Contents

• -init• -initWithDictionary:• lowBeamsOn• highBeamsOn• ambientLightSensorStatus

Overview

Status of the head lamps

-init

@abstract Constructs a new SDLHeadLampStatus object

SWIFT

class func back() -> SDLHMIZoneCapabilities!

RETURN VALUE

Page 403: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLHeadLampStatus object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 404: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

lowBeamsOn

@abstract A boolean value. Status of the low beam lamps.

highBeamsOn

@abstract A boolean value. Status of the high beam lamps.

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *lowBeamsOn;

SWIFT

var lowBeamsOn: NSNumber! { get set }

Page 405: Documentation iOS SDLAbstractProtocol Class Reference

ambientLightSensorStatus

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *highBeamsOn;

SWIFT

var highBeamsOn: NSNumber! { get set }

OBJECTIVE-C

@interface SDLHeadLampStatus : SDLRPCStruct

Page 406: Documentation iOS SDLAbstractProtocol Class Reference

SDLIAPTransport Class Reference

Section Contents

• controlSession• session

Overview

Undocumented

controlSession

Undocumented

session

Undocumented

SDLIgnitionStableStatus ClassReference

Section Contents

• +valueOf:• +values• +IGNITION_SWITCH_NOT_STABLE• +IGNITION_SWITCH_STABLE• +MISSING_FROM_TRANSMITTER

Page 407: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Reflects the ignition switch stability.

@since SDL 2.0

+valueOf:

@abstract return SDLIgnitionStableStatus - parameter: value The value of the

string to get an object for - returns: SDLIgnitionStableStatus

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLIgnitionStableStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLIgnitionStableStatus!

PARAMETERS

Page 408: Documentation iOS SDLAbstractProtocol Class Reference

SDLIgnitionStableStatus

+values

@abstract store all possible SDLIgnitionStableStatus values - returns: an array

with all possible SDLIgnitionStableStatus values inside

an array with all possible SDLIgnitionStableStatus values inside

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 409: Documentation iOS SDLAbstractProtocol Class Reference

+IGNITION_SWITCH_NOT_STABLE

@abstract The current ignition switch status is considered not to be stable. -

returns: the Ignition Stable Status with value of IGNITION_SWITCH_NOT_STABLE

the Ignition Stable Status with value of IGNITION_SWITCH_NOT_STABLE

+IGNITION_SWITCH_STABLE

@abstract The current ignition switch status is considered to be stable. -

returns: the Ignition Stable Status with value of IGNITION_SWITCH_STABLE

OBJECTIVE-C

+ (SDLIgnitionStableStatus *)IGNITION_SWITCH_NOT_STABLE;

SWIFT

class func ignition_SWITCH_NOT_STABLE() -> SDLIgnitionStableStatus!

RETURN VALUE

Page 410: Documentation iOS SDLAbstractProtocol Class Reference

the Ignition Stable Status with value of IGNITION_SWITCH_STABLE

+MISSING_FROM_TRANSMITTER

Undocumented

OBJECTIVE-C

+ (SDLIgnitionStableStatus *)IGNITION_SWITCH_STABLE;

SWIFT

class func ignition_SWITCH_STABLE() -> SDLIgnitionStableStatus!

RETURN VALUE

OBJECTIVE-C

@interface SDLIgnitionStableStatus : SDLEnum

Page 411: Documentation iOS SDLAbstractProtocol Class Reference

SDLIgnitionStatus Class Reference

Section Contents

• +valueOf:• +values• +UNKNOWN• +OFF• +ACCESSORY• +RUN• +START• +INVALID

Overview

Reflects the status of ignition..

@since SDL 2.0

+valueOf:

@abstract return SDLIgnitionStatus - parameter: value The value of the string

to get an object for - returns: SDLIgnitionStatus object

OBJECTIVE-C

+ (SDLIgnitionStatus *)valueOf:(NSString *)value;

Page 412: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLIgnitionStatus object

+values

@abstract store all possible SDLIgnitionStatus values - returns: an array with all

possible SDLIgnitionStatus values inside

SWIFT

class func value(of value: String!) -> SDLIgnitionStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 413: Documentation iOS SDLAbstractProtocol Class Reference

an array with all possible SDLIgnitionStatus values inside

+UNKNOWN

@abstract Ignition status currently unknown - returns: Ignition Status with value

of UNKNOWN

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLIgnitionStatus *)UNKNOWN;

SWIFT

class func unknown() -> SDLIgnitionStatus!

Page 414: Documentation iOS SDLAbstractProtocol Class Reference

Ignition Status with value of UNKNOWN

+OFF

@abstract Ignition is off - returns: Ignition Status with value of OFF

Ignition Status with value of OFF

RETURN VALUE

OBJECTIVE-C

+ (SDLIgnitionStatus *)OFF;

SWIFT

class func off() -> SDLIgnitionStatus!

RETURN VALUE

Page 415: Documentation iOS SDLAbstractProtocol Class Reference

+ACCESSORY

@abstract Ignition is in mode accessory - returns: Ignition Status with value of

ACCESSORY

Ignition Status with value of ACCESSORY

+RUN

@abstract Ignition is in mode run - returns: Ignition Status with value of RUN

OBJECTIVE-C

+ (SDLIgnitionStatus *)ACCESSORY;

SWIFT

class func accessory() -> SDLIgnitionStatus!

RETURN VALUE

Page 416: Documentation iOS SDLAbstractProtocol Class Reference

Ignition Status with value of RUN

+START

@abstract Ignition is in mode start - returns: Ignition Status with value of START

OBJECTIVE-C

+ (SDLIgnitionStatus *)RUN;

SWIFT

class func run() -> SDLIgnitionStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLIgnitionStatus *)START;

Page 417: Documentation iOS SDLAbstractProtocol Class Reference

Ignition Status with value of START

+INVALID

@abstract Signal is invalid - returns: Ignition Status with value of INVALID

SWIFT

class func start() -> SDLIgnitionStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLIgnitionStatus *)INVALID;

SWIFT

class func invalid() -> SDLIgnitionStatus!

Page 418: Documentation iOS SDLAbstractProtocol Class Reference

Ignition Status with value of INVALID

SDLImage Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithName:ofType:• value• imageType

Overview

Specifies, which image shall be used, e.g. in SDLAlerts or on SDLSoftbuttons

provided the display supports it.

@since SDL 2.0

-init

Constructs a newly allocated SDLImage object

RETURN VALUE

Page 419: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLImage object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 420: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithName:ofType:

Undocumented

value

@abstract The static hex icon value or the binary image file name identifier

(sent by SDLPutFile)

Required, max length = 65535

PARAMETERS

OBJECTIVE-C

@interface SDLImage : SDLRPCStruct

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *value;

Page 421: Documentation iOS SDLAbstractProtocol Class Reference

imageType

@abstract Describes, whether it is a static or dynamic image

Required

SWIFT

var value: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLImageType *imageType;

SWIFT

var imageType: SDLImageType! { get set }

Page 422: Documentation iOS SDLAbstractProtocol Class Reference

SDLImageField Class Reference

Section Contents

• -init• -initWithDictionary:• name• imageTypeSupported• imageResolution

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

name

Undocumented

imageTypeSupported

Undocumented

Page 423: Documentation iOS SDLAbstractProtocol Class Reference

imageResolution

Undocumented

SDLImageFieldName Class Reference

Section Contents

• +valueOf:• +values• +softButtonImage• +choiceImage• +choiceSecondaryImage• +vrHelpItem• +turnIcon• +menuIcon• +cmdIcon• +appIcon• +graphic• +showConstantTBTIcon• +showConstantTBTNextTurnIcon• +locationImage

Overview

The name that identifies the filed. * * * @since SmartDeviceLink 3.0 *

+valueOf:

Undocumented

Page 424: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+softButtonImage

The image field for SoftButton *

OBJECTIVE-C

@interface SDLImageFieldName : SDLEnum

OBJECTIVE-C

@interface SDLImageFieldName : SDLEnum

OBJECTIVE-C

+ (SDLImageFieldName *)softButtonImage;

Page 425: Documentation iOS SDLAbstractProtocol Class Reference

+choiceImage

The first image field for Choice. *

+choiceSecondaryImage

The scondary image field for Choice. *

SWIFT

class func softButtonImage() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)choiceImage;

SWIFT

class func choiceImage() -> SDLImageFieldName!

Page 426: Documentation iOS SDLAbstractProtocol Class Reference

+vrHelpItem

The image field for vrHelpItem. *

OBJECTIVE-C

+ (SDLImageFieldName *)choiceSecondaryImage;

SWIFT

class func choiceSecondaryImage() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)vrHelpItem;

SWIFT

class func vrHelpItem() -> SDLImageFieldName!

Page 427: Documentation iOS SDLAbstractProtocol Class Reference

+turnIcon

The image field for Turn. *

+menuIcon

The image field for the menu icon in SetGlobalProperties. *

OBJECTIVE-C

+ (SDLImageFieldName *)turnIcon;

SWIFT

class func turnIcon() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)menuIcon;

Page 428: Documentation iOS SDLAbstractProtocol Class Reference

+cmdIcon

The image filed for AddCommand. *

+appIcon

The iamage field for the app icon ( set by setAppIcon). *

SWIFT

class func menuIcon() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)cmdIcon;

SWIFT

class func cmdIcon() -> SDLImageFieldName!

Page 429: Documentation iOS SDLAbstractProtocol Class Reference

+graphic

The image filed for Show. *

OBJECTIVE-C

+ (SDLImageFieldName *)appIcon;

SWIFT

class func appIcon() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)graphic;

SWIFT

class func graphic() -> SDLImageFieldName!

Page 430: Documentation iOS SDLAbstractProtocol Class Reference

+showConstantTBTIcon

The primary image field for ShowConstant TBT. *

+showConstantTBTNextTurnIcon

The secondary image field for ShowConstant TBT. *

OBJECTIVE-C

+ (SDLImageFieldName *)showConstantTBTIcon;

SWIFT

class func showConstantTBTIcon() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)showConstantTBTNextTurnIcon;

Page 431: Documentation iOS SDLAbstractProtocol Class Reference

+locationImage

The optional image of a destination / location @since SDL 4.0

SWIFT

class func showConstantTBTNextTurnIcon() -> SDLImageFieldName!

OBJECTIVE-C

+ (SDLImageFieldName *)locationImage;

SWIFT

class func locationImage() -> SDLImageFieldName!

Page 432: Documentation iOS SDLAbstractProtocol Class Reference

SDLImageResolution Class Reference

Section Contents

• -init• -initWithDictionary:• resolutionWidth• resolutionHeight

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

resolutionWidth

Undocumented

resolutionHeight

Undocumented

Page 433: Documentation iOS SDLAbstractProtocol Class Reference

SDLImageType Class Reference

Section Contents

• +valueOf:• +values• +STATIC• +DYNAMIC

Overview

Contains information about the type of image.

@since SDL 2.0

+valueOf:

@abstract return SDLImageType (STATIC / DYNAMIC)

OBJECTIVE-C

+ (SDLImageType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLImageType!

Page 434: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

An SDLImageType

+values

@abstract store all possible SDLImageType values

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 435: Documentation iOS SDLAbstractProtocol Class Reference

An array with all possible SDLImageType values inside

+STATIC

@abstract Just the static hex icon value to be used

The Image Type with value STATIC

RETURN VALUE

OBJECTIVE-C

+ (SDLImageType *)STATIC;

SWIFT

class func `static`() -> SDLImageType!

RETURN VALUE

Page 436: Documentation iOS SDLAbstractProtocol Class Reference

+DYNAMIC

@abstract Binary image file to be used (identifier to be sent by SDLPutFile)

See

SDLPutFile

The Image Type with value DYNAMIC

OBJECTIVE-C

+ (SDLImageType *)DYNAMIC;

SWIFT

class func dynamic() -> SDLImageType!

RETURN VALUE

Page 437: Documentation iOS SDLAbstractProtocol Class Reference

SDLInteractionMode Class Reference

Section Contents

• +valueOf:• +values• +MANUAL_ONLY• +VR_ONLY• +BOTH

Overview

For application-initiated interactions (SDLPerformInteraction), this specifies the

mode by which the user is prompted and by which the user’s selection is

indicated

@since SDL 1.0

+valueOf:

@abstract SDLInteractionMode - parameter: value The value of the string to get

an object for - returns: SDLInteractionMode

OBJECTIVE-C

+ (SDLInteractionMode *)valueOf:(NSString *)value;

Page 438: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLInteractionMode

+values

@abstract store all possible SDLInteractionMode values - returns: an array with

all possible SDLInteractionMode values inside

SWIFT

class func value(of value: String!) -> SDLInteractionMode!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 439: Documentation iOS SDLAbstractProtocol Class Reference

an array with all possible SDLInteractionMode values inside

+MANUAL_ONLY

@abstract Interaction Mode : Manual Only @discussion This mode causes the

interaction to occur only on the display, meaning the choices are presented and

selected only via the display. Selections are viewed with the SEEKRIGHT,

SEEKLEFT, TUNEUP, TUNEDOWN buttons. User’s selection is indicated with the

OK button

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLInteractionMode *)MANUAL_ONLY;

Page 440: Documentation iOS SDLAbstractProtocol Class Reference

Current Interaction Mode with value of MANUAL_ONLY

+VR_ONLY

@abstract Interaction Mode : VR Only @discussion This mode causes the

interaction to occur only through TTS and VR. The user is prompted via TTS to

select a choice by saying one of the choice’s synonyms

SWIFT

class func manual_ONLY() -> SDLInteractionMode!

RETURN VALUE

OBJECTIVE-C

+ (SDLInteractionMode *)VR_ONLY;

SWIFT

class func vr_ONLY() -> SDLInteractionMode!

Page 441: Documentation iOS SDLAbstractProtocol Class Reference

Current Interaction Mode with value of VR_ONLY

+BOTH

@abstract Interaction Mode : Manual & VR @discussion This mode is a

combination of MANUAL_ONLY and VR_ONLY, meaning the user is prompted

both visually and audibly. The user can make a selection either using the mode

described in MANUAL_ONLY or using the mode described in VR_ONLY.

If the user views selections as described in MANUAL_ONLY mode, the

interaction becomes strictly, and irreversibly, a MANUAL_ONLY interaction (i.e.

the VR session is cancelled, although the interaction itself is still in progress). If

the user interacts with the VR session in any way (e.g. speaks a phrase, even if

it is not a recognized choice), the interaction becomes strictly, and irreversibly,

a VR_ONLY interaction (i.e. the MANUAL_ONLY mode forms of interaction will no

longer be honored)

The TriggerSource parameter of the PerformInteraction response will indicate

which interaction mode the user finally chose to attempt the selection (even if

the interaction did not end with a selection being made)

RETURN VALUE

OBJECTIVE-C

+ (SDLInteractionMode *)BOTH;

Page 442: Documentation iOS SDLAbstractProtocol Class Reference

Current Interaction Mode with value of BOTH

SDLJingle Class Reference

Section Contents

• +NEGATIVE_JINGLE• +POSITIVE_JINGLE• +LISTEN_JINGLE• +INITIAL_JINGLE• +HELP_JINGLE

Overview

Undocumented

+NEGATIVE_JINGLE

Undocumented

SWIFT

class func both() -> SDLInteractionMode!

RETURN VALUE

Page 443: Documentation iOS SDLAbstractProtocol Class Reference

+POSITIVE_JINGLE

Undocumented

+LISTEN_JINGLE

Undocumented

+INITIAL_JINGLE

Undocumented

+HELP_JINGLE

Undocumented

SDLKeyboardEvent Class Reference

Section Contents

• +valueOf:• +values• +KEYPRESS• +ENTRY_SUBMITTED• +ENTRY_CANCELLED• +ENTRY_ABORTED• +ENTRY_VOICE

Overview

Enumeration listing possible keyboard events. * * @since SmartDeviceLink 3.0 *

Page 444: Documentation iOS SDLAbstractProtocol Class Reference

+valueOf:

Undocumented

+values

Undocumented

+KEYPRESS

The use has pressed the keyboard key (applies to both SINGLE_KEYPRESS and

RESEND_CURRENT_ENTRY modes). *

OBJECTIVE-C

@interface SDLKeyboardEvent : SDLEnum

OBJECTIVE-C

@interface SDLKeyboardEvent : SDLEnum

OBJECTIVE-C

+ (SDLKeyboardEvent *)KEYPRESS;

Page 445: Documentation iOS SDLAbstractProtocol Class Reference

+ENTRY_SUBMITTED

The User has finished entering text from the keyboard and submitted the entry.

*

+ENTRY_CANCELLED

The User has pressed the HMI-defined “Cancel” button. *

SWIFT

class func keypress() -> SDLKeyboardEvent!

OBJECTIVE-C

+ (SDLKeyboardEvent *)ENTRY_SUBMITTED;

SWIFT

class func entry_SUBMITTED() -> SDLKeyboardEvent!

Page 446: Documentation iOS SDLAbstractProtocol Class Reference

+ENTRY_ABORTED

The User has not finished entering text and the keyboard is aborted with the

event of higher priority. *

OBJECTIVE-C

+ (SDLKeyboardEvent *)ENTRY_CANCELLED;

SWIFT

class func entry_CANCELLED() -> SDLKeyboardEvent!

OBJECTIVE-C

+ (SDLKeyboardEvent *)ENTRY_ABORTED;

SWIFT

class func entry_ABORTED() -> SDLKeyboardEvent!

Page 447: Documentation iOS SDLAbstractProtocol Class Reference

+ENTRY_VOICE

@since SDL 4.0

SDLKeyboardLayout Class Reference

Section Contents

• +valueOf:• +values• +QWERTY• +QWERTZ

OBJECTIVE-C

+ (SDLKeyboardEvent *)ENTRY_VOICE;

SWIFT

class func entry_VOICE() -> SDLKeyboardEvent!

Page 448: Documentation iOS SDLAbstractProtocol Class Reference

• +AZERTY

Overview

Enumeration listing possible keyboard layouts * *Since SmartDeviceLink 3.0 *

+valueOf:

Undocumented

+values

Undocumented

+QWERTY

QWERTY layout (the name comes from the first six keys

appearing on the top left letter row of the keyboard and read from left to right)

*

OBJECTIVE-C

@interface SDLKeyboardLayout : SDLEnum

OBJECTIVE-C

@interface SDLKeyboardLayout : SDLEnum

Page 449: Documentation iOS SDLAbstractProtocol Class Reference

+QWERTZ

QWERTZ layout (the name comes from the first six keys

appearing on the top left letter row of the keyboard and read from left to right)

*

OBJECTIVE-C

+ (SDLKeyboardLayout *)QWERTY;

SWIFT

class func qwerty() -> SDLKeyboardLayout!

OBJECTIVE-C

+ (SDLKeyboardLayout *)QWERTZ;

Page 450: Documentation iOS SDLAbstractProtocol Class Reference

+AZERTY

AZERTY layout (the name comes from the first six keys

appearing on the top left letter row of the keyboard and read from left to right)

*

SWIFT

class func qwertz() -> SDLKeyboardLayout!

OBJECTIVE-C

+ (SDLKeyboardLayout *)AZERTY;

SWIFT

class func azerty() -> SDLKeyboardLayout!

Page 451: Documentation iOS SDLAbstractProtocol Class Reference

SDLKeyboardProperties Class Reference

Section Contents

• -init• -initWithDictionary:• -

initWithLanguage:layout:keypressMode:limitedCharacterList:autoCompleteText:• language• keyboardLayout• keypressMode• limitedCharacterList• autoCompleteText

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

-

initWithLanguage:layout:keypressMode:limitedCharacterList:autoCompleteText

Undocumented

Page 452: Documentation iOS SDLAbstractProtocol Class Reference

language

Undocumented

keyboardLayout

Undocumented

keypressMode

Undocumented

limitedCharacterList

Undocumented

autoCompleteText

Undocumented

SDLKeypressMode Class Reference

Section Contents

• +valueOf:• +values• +SINGLE_KEYPRESS• +QUEUE_KEYPRESSES

Page 453: Documentation iOS SDLAbstractProtocol Class Reference

• +RESEND_CURRENT_ENTRY

Overview

Enumeration listing possible keyboard events. *

* Note: Depending on keypressMode value (from keyboardProperties structure

of UI.SetGlobalProperties),

HMI must send the onKeyboardInput notification with the following data:

SINGLE_KEYPRESS,QUEUE_KEYPRESSES,RESEND_CURRENT_ENTRY. * @since

SmartDeviceLink 3.0 *

+valueOf:

Undocumented

+values

Undocumented

OBJECTIVE-C

@interface SDLKeypressMode : SDLEnum

OBJECTIVE-C

@interface SDLKeypressMode : SDLEnum

Page 454: Documentation iOS SDLAbstractProtocol Class Reference

+SINGLE_KEYPRESS

SINGLE_KEYPRESS:

Each and every User`s keypress must be reported (new notification for every

newly entered single symbol). *

+QUEUE_KEYPRESSES

QUEUE_KEYPRESSES:

The whole entry is reported only after the User submits it (by ‘Search’ button

click displayed on touchscreen keyboard) *

OBJECTIVE-C

+ (SDLKeypressMode *)SINGLE_KEYPRESS;

SWIFT

class func single_KEYPRESS() -> SDLKeypressMode!

OBJECTIVE-C

+ (SDLKeypressMode *)QUEUE_KEYPRESSES;

Page 455: Documentation iOS SDLAbstractProtocol Class Reference

+RESEND_CURRENT_ENTRY

RESEND_CURRENT_ENTRY:

The whole entry must be reported each and every time the User makes a new

keypress

(new notification with all previously entered symbols and a newly entered one

appended). *

SWIFT

class func queue_KEYPRESSES() -> SDLKeypressMode!

OBJECTIVE-C

+ (SDLKeypressMode *)RESEND_CURRENT_ENTRY;

SWIFT

class func resend_CURRENT_ENTRY() -> SDLKeypressMode!

Page 456: Documentation iOS SDLAbstractProtocol Class Reference

SDLLanguage Class Reference

Section Contents

• +valueOf:• +values• +EN_US• +ES_MX• +FR_CA• +DE_DE• +ES_ES• +EN_GB• +RU_RU• +TR_TR• +PL_PL• +FR_FR• +IT_IT• +SV_SE• +PT_PT• +NL_NL• +EN_AU• +ZH_CN• +ZH_TW• +JA_JP• +AR_SA• +KO_KR• +PT_BR• +CS_CZ• +DA_DK• +NO_NO

Overview

Specifies the language to be used for TTS, VR, displayed messages/menus

Page 457: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 1.0

+valueOf:

@abstract Get a Langusge according to a String

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLLanguage *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLLanguage!

PARAMETERS

Page 458: Documentation iOS SDLAbstractProtocol Class Reference

The Language

+values

@abstract store all possible Language values

an array with all possible Language values inside

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 459: Documentation iOS SDLAbstractProtocol Class Reference

+EN_US

Undocumented

+ES_MX

@abstract Spanish - Mexico

OBJECTIVE-C

@interface SDLLanguage : SDLEnum

OBJECTIVE-C

+ (SDLLanguage *)ES_MX;

SWIFT

class func es_MX() -> SDLLanguage!

Page 460: Documentation iOS SDLAbstractProtocol Class Reference

+FR_CA

@abstract French - Canada

+DE_DE

@abstract German - Germany

OBJECTIVE-C

+ (SDLLanguage *)FR_CA;

SWIFT

class func fr_CA() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)DE_DE;

Page 461: Documentation iOS SDLAbstractProtocol Class Reference

+ES_ES

@abstract Spanish - Spain

+EN_GB

@abstract English - Great Britain

SWIFT

class func de_DE() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)ES_ES;

SWIFT

class func es_ES() -> SDLLanguage!

Page 462: Documentation iOS SDLAbstractProtocol Class Reference

+RU_RU

@abstract Russian - Russia

OBJECTIVE-C

+ (SDLLanguage *)EN_GB;

SWIFT

class func en_GB() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)RU_RU;

SWIFT

class func ru_RU() -> SDLLanguage!

Page 463: Documentation iOS SDLAbstractProtocol Class Reference

+TR_TR

@abstract Turkish - Turkey

+PL_PL

@abstract Polish - Poland

OBJECTIVE-C

+ (SDLLanguage *)TR_TR;

SWIFT

class func tr_TR() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)PL_PL;

Page 464: Documentation iOS SDLAbstractProtocol Class Reference

+FR_FR

@abstract French - France

+IT_IT

@abstract Italian - Italy

SWIFT

class func pl_PL() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)FR_FR;

SWIFT

class func fr_FR() -> SDLLanguage!

Page 465: Documentation iOS SDLAbstractProtocol Class Reference

+SV_SE

@abstract Swedish - Sweden

OBJECTIVE-C

+ (SDLLanguage *)IT_IT;

SWIFT

class func it_IT() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)SV_SE;

SWIFT

class func sv_SE() -> SDLLanguage!

Page 466: Documentation iOS SDLAbstractProtocol Class Reference

+PT_PT

@abstract Portuguese - Portugal

+NL_NL

@abstract Dutch (Standard) - Netherlands

OBJECTIVE-C

+ (SDLLanguage *)PT_PT;

SWIFT

class func pt_PT() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)NL_NL;

Page 467: Documentation iOS SDLAbstractProtocol Class Reference

+EN_AU

@abstract English - Australia

+ZH_CN

@abstract Mandarin - China

SWIFT

class func nl_NL() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)EN_AU;

SWIFT

class func en_AU() -> SDLLanguage!

Page 468: Documentation iOS SDLAbstractProtocol Class Reference

+ZH_TW

@abstract Mandarin - Taiwan

OBJECTIVE-C

+ (SDLLanguage *)ZH_CN;

SWIFT

class func zh_CN() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)ZH_TW;

SWIFT

class func zh_TW() -> SDLLanguage!

Page 469: Documentation iOS SDLAbstractProtocol Class Reference

+JA_JP

@abstract Japanese - Japan

+AR_SA

@abstract Arabic - Saudi Arabia

OBJECTIVE-C

+ (SDLLanguage *)JA_JP;

SWIFT

class func ja_JP() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)AR_SA;

Page 470: Documentation iOS SDLAbstractProtocol Class Reference

+KO_KR

@abstract Korean - South Korea

+PT_BR

@abstract Portuguese - Brazil

SWIFT

class func ar_SA() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)KO_KR;

SWIFT

class func ko_KR() -> SDLLanguage!

Page 471: Documentation iOS SDLAbstractProtocol Class Reference

+CS_CZ

@abstract Czech - Czech Republic

OBJECTIVE-C

+ (SDLLanguage *)PT_BR;

SWIFT

class func pt_BR() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)CS_CZ;

SWIFT

class func cs_CZ() -> SDLLanguage!

Page 472: Documentation iOS SDLAbstractProtocol Class Reference

+DA_DK

@abstract Danish - Denmark

+NO_NO

@abstract Norwegian - Norway

OBJECTIVE-C

+ (SDLLanguage *)DA_DK;

SWIFT

class func da_DK() -> SDLLanguage!

OBJECTIVE-C

+ (SDLLanguage *)NO_NO;

Page 473: Documentation iOS SDLAbstractProtocol Class Reference

SDLLayoutMode Class Reference

Section Contents

• +valueOf:• +values• +ICON_ONLY• +ICON_WITH_SEARCH• +LIST_ONLY• +LIST_WITH_SEARCH• +KEYBOARD

Overview

For touchscreen interactions, the mode of how the choices are presented.

@since SDL 3.0

+valueOf:

Undocumented

SWIFT

class func no_NO() -> SDLLanguage!

Page 474: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+ICON_ONLY

This mode causes the interaction to display the previous set of choices as

icons.

OBJECTIVE-C

@interface SDLLayoutMode : SDLEnum

OBJECTIVE-C

@interface SDLLayoutMode : SDLEnum

OBJECTIVE-C

+ (SDLLayoutMode *)ICON_ONLY;

Page 475: Documentation iOS SDLAbstractProtocol Class Reference

+ICON_WITH_SEARCH

This mode causes the interaction to display the previous set of choices as icons

along with a search field in the HMI.

+LIST_ONLY

This mode causes the interaction to display the previous set of choices as a list.

SWIFT

class func icon_ONLY() -> SDLLayoutMode!

OBJECTIVE-C

+ (SDLLayoutMode *)ICON_WITH_SEARCH;

SWIFT

class func icon_WITH_SEARCH() -> SDLLayoutMode!

Page 476: Documentation iOS SDLAbstractProtocol Class Reference

+LIST_WITH_SEARCH

This mode causes the interaction to display the previous set of choices as a list

along with a search field in the HMI.

OBJECTIVE-C

+ (SDLLayoutMode *)LIST_ONLY;

SWIFT

class func list_ONLY() -> SDLLayoutMode!

OBJECTIVE-C

+ (SDLLayoutMode *)LIST_WITH_SEARCH;

SWIFT

class func list_WITH_SEARCH() -> SDLLayoutMode!

Page 477: Documentation iOS SDLAbstractProtocol Class Reference

+KEYBOARD

This mode causes the interaction to immediately display a keyboard entry

through the HMI.

SDLLifecycleConfiguration ClassReference

Section Contents

• -init• +defaultConfigurationWithAppName:appId:• +debugConfigurationWithAppName:appId:ipAddress:port:• tcpDebugMode• tcpDebugIPAddress

OBJECTIVE-C

+ (SDLLayoutMode *)KEYBOARD;

SWIFT

class func keyboard() -> SDLLayoutMode!

Page 478: Documentation iOS SDLAbstractProtocol Class Reference

• tcpDebugPort• appName• appId• resumeHash• isMedia• appType• language• languagesSupported• appIcon• shortAppName• ttsName• voiceRecognitionCommandNames• securityManagers• logFlags

Overview

Configuration options for SDLManager

-init

Undocumented

+defaultConfigurationWithAppName:appId:

A production configuration that runs using IAP. Additional functionality should

be customized on the properties.

OBJECTIVE-C

@interface SDLLifecycleConfiguration : NSObject <NSCopying>

Page 479: Documentation iOS SDLAbstractProtocol Class Reference

appName

The name of the app.

appId

The appId to be used. This should be registered with the radio’s

manufacturer.

OBJECTIVE-C

+ (nonnull SDLLifecycleConfiguration *)defaultConfigurationWithAppName:(nonnull NSString *)appName appId:(nonnull NSString *)appId;

SWIFT

class func defaultConfiguration(withAppName appName: Any!, appId: Any!) -> SDLLifecycleConfiguration!

PARAMETERS

Page 480: Documentation iOS SDLAbstractProtocol Class Reference

The lifecycle configuration

+debugConfigurationWithAppName:appId:ipAddress:port:

A debug configuration that runs using TCP. Additional functionality should be

customized on the properties.

RETURN VALUE

OBJECTIVE-C

+ (nonnull SDLLifecycleConfiguration *)debugConfigurationWithAppName:(nonnull NSString *)appName appId:(nonnull NSString *)appId ipAddress:(nonnull NSString *)ipAddress port:(UInt16)port;

SWIFT

class func debugConfiguration(withAppName appName: Any!, appId: Any!, ipAddress: Any!, port: Any!) -> SDLLifecycleConfiguration!

Page 481: Documentation iOS SDLAbstractProtocol Class Reference

appName

The name of the app.

appId

The appId to be used. This should be registered with the radio’s

manufacturer.

ipAddress

The ip address of the server to connect to

port

The port of the server to connect to

The lifecycle configuration

tcpDebugMode

Whether or not debug mode is enabled

PARAMETERS

RETURN VALUE

Page 482: Documentation iOS SDLAbstractProtocol Class Reference

tcpDebugIPAddress

The ip address at which the library will look for a server

tcpDebugPort

The port at which the library will look for a server

OBJECTIVE-C

@property (readonly, assign, nonatomic) BOOL tcpDebugMode;

SWIFT

var tcpDebugMode: Int32 { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic, null_resettable) NSString *tcpDebugIPAddress;

Page 483: Documentation iOS SDLAbstractProtocol Class Reference

appName

The full name of the app

appId

The app id. This must be the same as the app id received from the SDL

developer portal or OEM.

OBJECTIVE-C

@property (readonly, assign, nonatomic) UInt16 tcpDebugPort;

SWIFT

var tcpDebugPort: Int32 { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSString *_Nonnull appName;

Page 484: Documentation iOS SDLAbstractProtocol Class Reference

resumeHash

A hash id which should be passed to the remote system in the

RegisterAppInterface

isMedia

This is an automatically set based on the app type

OBJECTIVE-C

@property (readonly, copy, nonatomic) NSString *_Nonnull appId;

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) NSString *resumeHash;

OBJECTIVE-C

@property (readonly, assign, nonatomic) BOOL isMedia;

Page 485: Documentation iOS SDLAbstractProtocol Class Reference

appType

The application type

language

The default language to use

SWIFT

var isMedia: Int32 { get }

OBJECTIVE-C

@property (readwrite, strong, nonatomic, null_resettable) SDLAppHMIType *appType;

SWIFT

var appType: SDLAppHMIType! { get set }

Page 486: Documentation iOS SDLAbstractProtocol Class Reference

languagesSupported

An array of all the supported languages

appIcon

The application icon to be used on an app launching screen

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLLanguage *_Nonnull language;

SWIFT

var language: SDLLanguage! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic) NSArray<SDLLanguage *> *_Nonnull languagesSupported;

Page 487: Documentation iOS SDLAbstractProtocol Class Reference

shortAppName

An abbrevited application name that will be used on the app launching screen if

the full one would be truncated

ttsName

A Text to Speech String for voice recognition of the mobile application name.

OBJECTIVE-C

@property (readwrite, strong, nonatomic, nullable) SDLFile *appIcon;

SWIFT

var appIcon: SDLFile? { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) NSString *shortAppName;

Page 488: Documentation iOS SDLAbstractProtocol Class Reference

voiceRecognitionCommandNames

Additional voice recognition commands. May not interfere with any other app

name or global commands.

securityManagers

Set security managers which could be used. This is primarily used with video

streaming applications to authenticate and perhaps encrypt traffic data.

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) NSArray<SDLTTSChunk *> *ttsName;

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) NSArray<NSString *> *voiceRecognitionCommandNames;

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) NSArray<Class<SDLSecurityType>> *securityManagers;

Page 489: Documentation iOS SDLAbstractProtocol Class Reference

logFlags

Which logging capabilities are currently enabled. The default is Console logging

only.

SDLListFiles Class Reference

Section Contents

• -init

OBJECTIVE-C

@property (assign, readwrite, nonatomic) SDLLogOutput logFlags;

SWIFT

var logFlags: Int32 { get set }

Page 490: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

Requests the current list of resident filenames for the registered app. Not

supported on First generation SDL vehicles

Since SmartDeviceLink 2.0

-init

Constructs a new SDLListFiles object

-initWithDictionary:

Constructs a new SDLListFiles object indicated by the dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 491: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLListFilesResponse Class Reference

Section Contents

• -init• -initWithDictionary:• filenames

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 492: Documentation iOS SDLAbstractProtocol Class Reference

• spaceAvailable

Overview

SDLListFilesResponse is sent, when SDLListFiles has been called

Since SmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

filenames

Undocumented

OBJECTIVE-C

@interface SDLListFilesResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLListFilesResponse : SDLRPCResponse

Page 493: Documentation iOS SDLAbstractProtocol Class Reference

spaceAvailable

Undocumented

SDLLocationCoordinate Class Reference

Section Contents

• latitudeDegrees• longitudeDegrees

Overview

Undocumented

OBJECTIVE-C

@interface SDLListFilesResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLListFilesResponse : SDLRPCResponse

Page 494: Documentation iOS SDLAbstractProtocol Class Reference

latitudeDegrees

@abstract Latitude of the location

Required, Double -90 - 90

longitudeDegrees

@abstract Longitude of the location

Required, Double -180 - 180

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLFloat> *latitudeDegrees;

SWIFT

@NSCopying var latitudeDegrees: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLFloat> *longitudeDegrees;

Page 495: Documentation iOS SDLAbstractProtocol Class Reference

SDLLocationDetails Class Reference

Section Contents

• coordinate• locationName• addressLines• locationDescription• phoneNumber• locationImage• searchAddress

Overview

Undocumented

coordinate

@abstract Latitude/Longitude of the location

SeeSDLLocationCoordinate Optional

SWIFT

@NSCopying var longitudeDegrees: NSNumber! { get set }

Page 496: Documentation iOS SDLAbstractProtocol Class Reference

locationName

@abstract Name of location.

Optional, Max length 500 chars

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLLocationCoordinate *coordinate;

SWIFT

var coordinate: SDLLocationCoordinate! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *locationName;

Page 497: Documentation iOS SDLAbstractProtocol Class Reference

addressLines

@abstract Location address for display purposes only.

Optional, Array of Strings, Array length 0 - 4, Max String length 500

locationDescription

@abstract Description intended location / establishment.

Optional, Max length 500 chars

SWIFT

var locationName: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSArray<NSString *> *addressLines;

SWIFT

var addressLines: [String]! { get set }

Page 498: Documentation iOS SDLAbstractProtocol Class Reference

phoneNumber

@abstract Phone number of location / establishment.

Optional, Max length 500 chars

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *locationDescription;

SWIFT

var locationDescription: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *phoneNumber;

Page 499: Documentation iOS SDLAbstractProtocol Class Reference

locationImage

@abstract Image / icon of intended location.

SeeSDLImage Optional

searchAddress

@abstract Address to be used by navigation engines for search.

See

SWIFT

var phoneNumber: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLImage *locationImage;

SWIFT

var locationImage: SDLImage! { get set }

Page 500: Documentation iOS SDLAbstractProtocol Class Reference

SDLOASISAddress Optional

SDLLockScreenConfiguration ClassReference

Section Contents

• showInOptionalState• enableAutomaticLockScreen• backgroundColor• appIcon• customViewController• -init• +disabledConfiguration• +enabledConfiguration

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLOasisAddress *searchAddress;

SWIFT

var searchAddress: SDLOasisAddress! { get set }

Page 501: Documentation iOS SDLAbstractProtocol Class Reference

• +enabledConfigurationWithAppIcon:backgroundColor:• +enabledConfigurationWithViewController:

Overview

Undocumented

showInOptionalState

Whether or not the lock screen should be shown in the “lock screen optional”

state. Defaults to ‘NO’.

enableAutomaticLockScreen

If YES, the lock screen should be managed by SDL and automatically engage

when necessary. If NO, then the lock screen will never be engaged.

OBJECTIVE-C

@property (assign, readwrite, nonatomic) BOOL showInOptionalState;

SWIFT

var showInOptionalState: Int32 { get set }

Page 502: Documentation iOS SDLAbstractProtocol Class Reference

backgroundColor

The background color of the lock screen. This could be a branding color, or

leave at the default for a dark blue-gray.

appIcon

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

OBJECTIVE-C

@property (readonly, assign, nonatomic) BOOL enableAutomaticLockScreen;

SWIFT

var enableAutomaticLockScreen: Int32 { get }

OBJECTIVE-C

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

Page 503: Documentation iOS SDLAbstractProtocol Class Reference

customViewController

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

-init

Undocumented

+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

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

OBJECTIVE-C

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

Page 504: Documentation iOS SDLAbstractProtocol Class Reference

The configuration

+enabledConfiguration

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

not be used.

OBJECTIVE-C

+ (nonnull instancetype)disabledConfiguration;

SWIFT

class func disabled() -> Self!

RETURN VALUE

OBJECTIVE-C

+ (nonnull instancetype)enabledConfiguration;

Page 505: Documentation iOS SDLAbstractProtocol Class Reference

The configuration

+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.

SWIFT

class func enabled() -> Self!

RETURN VALUE

OBJECTIVE-C

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

Page 506: Documentation iOS SDLAbstractProtocol Class Reference

lockScreenAppIcon

The app icon to be shown on the lock screen

lockScreenBackgroundColor

The color of the lock screen background

The configuration

+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

SWIFT

class func enabledConfiguration(withAppIcon lockScreenAppIcon: Any!, backgroundColor lockScreenBackgroundColor: Any!) -> Self!

PARAMETERS

RETURN VALUE

Page 507: Documentation iOS SDLAbstractProtocol Class Reference

SDLLockScreenViewController and pass it here to continue to have the vehicle

icon set to your view controller by the manager.

viewController

The view controller to be managed

The configuration

OBJECTIVE-C

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

SWIFT

class func enabledConfiguration(withViewController viewController: Any!) -> Self!

PARAMETERS

RETURN VALUE

Page 508: Documentation iOS SDLAbstractProtocol Class Reference

SDLLockScreenStatus Class Reference

Section Contents

• +valueOf:• +values• +OFF• +OPTIONAL• +REQUIRED

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+OFF

LockScreen is Not Required

OBJECTIVE-C

+ (SDLLockScreenStatus *)OFF;

Page 509: Documentation iOS SDLAbstractProtocol Class Reference

+OPTIONAL

LockScreen is Optional

+REQUIRED

LockScreen is Not Required

SWIFT

class func off() -> SDLLockScreenStatus!

OBJECTIVE-C

+ (SDLLockScreenStatus *)OPTIONAL;

SWIFT

class func optional() -> SDLLockScreenStatus!

Page 510: Documentation iOS SDLAbstractProtocol Class Reference

SDLLockScreenViewController ClassReference

Section Contents

• appIcon• vehicleIcon• backgroundColor

Overview

Undocumented

OBJECTIVE-C

+ (SDLLockScreenStatus *)REQUIRED;

SWIFT

class func required() -> SDLLockScreenStatus!

Page 511: Documentation iOS SDLAbstractProtocol Class Reference

appIcon

The app’s icon. This will be set by the lock screen configuration.

vehicleIcon

The vehicle’s designated icon. This will be set by the lock screen manager when

it is notified that a lock screen icon has been downloaded.

backgroundColor

The designated background color set in the lock screen configuration, or the

default SDL gray-blue.

OBJECTIVE-C

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

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) UIImage *vehicleIcon;

Page 512: Documentation iOS SDLAbstractProtocol Class Reference

SDLMaintenanceModeStatus ClassReference

Section Contents

• +valueOf:• +values• +NORMAL• +NEAR• +ACTIVE• +FEATURE_NOT_PRESENT

Overview

The SDLMaintenanceModeStatus class.

+valueOf:

@abstract Maintenance Mode Status - parameter: value The value of the string

to get an object for - returns: SDLMaintenanceModeStatus

OBJECTIVE-C

@property (readwrite, copy, nonatomic, nullable) UIColor *backgroundColor;

Page 513: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLMaintenanceModeStatus

OBJECTIVE-C

+ (SDLMaintenanceModeStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLMaintenanceModeStatus!

PARAMETERS

RETURN VALUE

Page 514: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract declare an array that store all possible Maintenance Mode Status

inside - returns: the array

the array

+NORMAL

@abstract Maintenance Mode Status : Normal - returns: the object with value of

NORMAL

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 515: Documentation iOS SDLAbstractProtocol Class Reference

the object with value of NORMAL

+NEAR

@abstract Maintenance Mode Status : Near - returns: the object with value of

NEAR

OBJECTIVE-C

+ (SDLMaintenanceModeStatus *)NORMAL;

SWIFT

class func normal() -> SDLMaintenanceModeStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLMaintenanceModeStatus *)NEAR;

Page 516: Documentation iOS SDLAbstractProtocol Class Reference

the object with value of NEAR

+ACTIVE

@abstract Maintenance Mode Status : Active - returns: the object with value of

ACTIVE

SWIFT

class func near() -> SDLMaintenanceModeStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLMaintenanceModeStatus *)ACTIVE;

SWIFT

class func active() -> SDLMaintenanceModeStatus!

Page 517: Documentation iOS SDLAbstractProtocol Class Reference

the object with value of ACTIVE

+FEATURE_NOT_PRESENT

@abstract Maintenance Mode Status : Feature not present - returns: the object

with value of FEATURE_NOT_PRESENT

the object with value of FEATURE_NOT_PRESENT

RETURN VALUE

OBJECTIVE-C

+ (SDLMaintenanceModeStatus *)FEATURE_NOT_PRESENT;

SWIFT

class func feature_NOT_PRESENT() -> SDLMaintenanceModeStatus!

RETURN VALUE

Page 518: Documentation iOS SDLAbstractProtocol Class Reference

SDLManager Class Reference

Section Contents

• configuration• hmiLevel• fileManager• permissionManager• streamManager• registerResponse• delegate• proxy• -initWithConfiguration:delegate:• -startWithReadyHandler:• -stop• -sendRequest:• -sendRequest:withResponseHandler:

Overview

Undocumented

configuration

The configuration the manager was set up with.

OBJECTIVE-C

@property (readonly, copy, nonatomic) SDLConfiguration *_Nonnull configuration;

Page 519: Documentation iOS SDLAbstractProtocol Class Reference

hmiLevel

The current HMI level of the running app.

fileManager

The file manager to be used by the running app.

SWIFT

@NSCopying var configuration: SDLConfiguration { get }

OBJECTIVE-C

@property (readonly, copy, nonatomic) SDLHMILevel *_Nonnull hmiLevel;

SWIFT

@NSCopying var hmiLevel: SDLHMILevel { get }

Page 520: Documentation iOS SDLAbstractProtocol Class Reference

permissionManager

The permission manager monitoring RPC permissions.

OBJECTIVE-C

@property (readonly, strong, nonatomic) SDLFileManager *_Nonnull fileManager;

SWIFT

var fileManager: SDLFileManager { get }

OBJECTIVE-C

@property (readonly, strong, nonatomic) SDLPermissionManager *_Nonnull permissionManager;

SWIFT

var permissionManager: SDLPermissionManager { get }

Page 521: Documentation iOS SDLAbstractProtocol Class Reference

streamManager

The streaming media manager to be used for starting video sessions.

registerResponse

The response of a register call after it has been received.

OBJECTIVE-C

@property (readonly, strong, nonatomic, nullable) SDLStreamingMediaManager *streamManager;

SWIFT

var streamManager: SDLStreamingMediaManager? { get }

OBJECTIVE-C

@property (readonly, strong, nonatomic, nullable) SDLRegisterAppInterfaceResponse *registerResponse;

Page 522: Documentation iOS SDLAbstractProtocol Class Reference

delegate

The manager’s delegate.

proxy

Undocumented

-initWithConfiguration:delegate:

Initialize the manager with a configuration. Call startWithHandler to begin

waiting for a connection.

SWIFT

var registerResponse: SDLRegisterAppInterfaceResponse? { get }

OBJECTIVE-C

@property (readwrite, nonatomic, nullable) id<SDLManagerDelegate> delegate;

Page 523: Documentation iOS SDLAbstractProtocol Class Reference

configuration

Your app’s unique configuration for setup.

delegate

An optional delegate to be notified of hmi level changes and startup

and shutdown. It is recommended that you implement this.

An instance of SDLManager

OBJECTIVE-C

- (nonnull instancetype)initWithConfiguration:(nonnull SDLConfiguration *)configuration delegate:(nullable id<SDLManagerDelegate>)delegate;

PARAMETERS

RETURN VALUE

Page 524: Documentation iOS SDLAbstractProtocol Class Reference

-startWithReadyHandler:

Start the manager, which will tell it to start looking for a connection. Once one

does, it will automatically run the setup process and call the readyBlock when

done.

readyHandler

OBJECTIVE-C

- (void)startWithReadyHandler:(nonnull SDLManagerReadyBlock)readyHandler;

SWIFT

func start(readyHandler: @escaping SDLManagerReadyBlock)

PARAMETERS

Page 525: Documentation iOS SDLAbstractProtocol Class Reference

The block called when the manager is ready to be used or an error

occurs while attempting to become ready.

-stop

Stop the manager, it will disconnect if needed and no longer look for a

connection. You probably don’t need to call this method ever.

If you do call this method, you must wait for SDLManagerDelegate’s

managerDidDisconnect callback to call startWithReadyHandler:.

-sendRequest:

Send an RPC request and don’t bother with the response or error. If you need

the response or error, call sendRequest:withCompletionHandler: instead.

OBJECTIVE-C

- (void)stop;

SWIFT

func stop()

Page 526: Documentation iOS SDLAbstractProtocol Class Reference

request

The RPC request to send

-sendRequest:withResponseHandler:

Send an RPC request and set a completion handler that will be called with the

response when the response returns.

OBJECTIVE-C

- (void)sendRequest:(nonnull SDLRPCRequest *)request;

SWIFT

func send(_ request: SDLRPCRequest)

PARAMETERS

Page 527: Documentation iOS SDLAbstractProtocol Class Reference

request

The RPC request to send

handler

The handler that will be called when the response returns

OBJECTIVE-C

- (void)sendRequest:(nonnull SDLRPCRequest *)request withResponseHandler:(nullable SDLResponseHandler)handler;

SWIFT

func send(_ request: SDLRPCRequest, withResponseHandler handler: SDLResponseHandler? = nil)

PARAMETERS

Page 528: Documentation iOS SDLAbstractProtocol Class Reference

SDLMediaClockFormat Class Reference

Section Contents

• +valueOf:• +values• +CLOCK1• +CLOCK2• +CLOCK3• +CLOCKTEXT1• +CLOCKTEXT2• +CLOCKTEXT3• +CLOCKTEXT4

Overview

Indicates the format of the time displayed on the connected SDL unit.

Format description follows the following nomenclature:

Sp = Space

| = or

c = character

@since SDL 1.0

+valueOf:

@abstract Media Clock Format

Page 529: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLMediaClockFormat

+values

@abstract declare an array that store all possible Media clock formats inside

OBJECTIVE-C

+ (SDLMediaClockFormat *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLMediaClockFormat!

PARAMETERS

RETURN VALUE

Page 530: Documentation iOS SDLAbstractProtocol Class Reference

the array

+CLOCK1

@abstract Media clock format: Clock1

@discussion

• maxHours = 19• maxMinutes = 59• maxSeconds = 59

• - returns: The SDLMediaClockFormat object with value CLOCK1

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 531: Documentation iOS SDLAbstractProtocol Class Reference

The SDLMediaClockFormat object with value CLOCK1

+CLOCK2

@abstract Media clock format: Clock2

@discussion

• maxHours = 59• maxMinutes = 59• maxSeconds = 59

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCK1;

SWIFT

class func clock1() -> SDLMediaClockFormat!

RETURN VALUE

Page 532: Documentation iOS SDLAbstractProtocol Class Reference

The SDLMediaClockFormat object with value CLOCK2

+CLOCK3

@abstract Media clock format: Clock3

@discussion

• maxHours = 9• maxMinutes = 59• maxSeconds = 59

@since SDL 2.0 - returns: The SDLMediaClockFormat object with value CLOCK3

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCK2;

SWIFT

class func clock2() -> SDLMediaClockFormat!

RETURN VALUE

Page 533: Documentation iOS SDLAbstractProtocol Class Reference

The SDLMediaClockFormat object with value CLOCK3

+CLOCKTEXT1

@abstract Media clock format: ClockText1

@discussion

• 5 characters possible• Format: 1|sp c :|sp c c• 1|sp : digit “1” or space• c : character out of following character set: sp|0-9|[letters, see TypeII

column in XLS.• :|sp : colon or space• used for Type II headunit

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCK3;

SWIFT

class func clock3() -> SDLMediaClockFormat!

RETURN VALUE

Page 534: Documentation iOS SDLAbstractProtocol Class Reference

The SDLMediaClockFormat object with value CLOCKTEXT1

+CLOCKTEXT2

@abstract Media clock format: ClockText2

@discussion

• 5 characters possible• Format: 1|sp c :|sp c c• 1|sp : digit “1” or space• c : character out of following character set: sp|0-9|[letters, see CID column

in XLS.• :|sp : colon or space• used for CID headunit

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCKTEXT1;

SWIFT

class func clocktext1() -> SDLMediaClockFormat!

RETURN VALUE

Page 535: Documentation iOS SDLAbstractProtocol Class Reference

difference between CLOCKTEXT1 and CLOCKTEXT2 is the supported characterset

The SDLMediaClockFormat object with value CLOCKTEXT2

+CLOCKTEXT3

@abstract Media clock format: ClockText3

@discussion

• 6 chars possible• Format: 1|sp c c :|sp c c• 1|sp : digit “1” or space• c : character out of following character set: sp|0-9|[letters, see Type 5

column in XLS].• :|sp : colon or space

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCKTEXT2;

SWIFT

class func clocktext2() -> SDLMediaClockFormat!

RETURN VALUE

Page 536: Documentation iOS SDLAbstractProtocol Class Reference

• used for Type V headunit

difference between CLOCKTEXT1 and CLOCKTEXT2 is the supported characterset

The SDLMediaClockFormat object with value CLOCKTEXT3

+CLOCKTEXT4

@abstract Media clock format: ClockText4

@discussion

• 6 chars possible• Format: c :|sp c c : c c• :|sp : colon or space• c : character out of following character set: sp|0-9|[letters]

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCKTEXT3;

SWIFT

class func clocktext3() -> SDLMediaClockFormat!

RETURN VALUE

Page 537: Documentation iOS SDLAbstractProtocol Class Reference

• used for MFD3/4/5 headunits

@since SDL 2.0 - returns: The SDLMediaClockFormat object with value

CLOCKTEXT4

The SDLMediaClockFormat object with value CLOCKTEXT4

SDLMenuParams Class Reference

Section Contents

• -init• -initWithDictionary:

OBJECTIVE-C

+ (SDLMediaClockFormat *)CLOCKTEXT4;

SWIFT

class func clocktext4() -> SDLMediaClockFormat!

RETURN VALUE

Page 538: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithMenuName:• -initWithMenuName:parentId:position:• parentID• position• menuName

Overview

Used when adding a sub menu to an application menu or existing sub menu.

@since SDL 1.0

-init

Constructs a newly allocated SDLMenuParams object

-initWithDictionary:

Constructs a newly allocated SDLMenuParams object indicated by the

dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 539: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithMenuName:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLMenuParams : SDLRPCStruct

Page 540: Documentation iOS SDLAbstractProtocol Class Reference

-initWithMenuName:parentId:position:

Undocumented

parentID

@abstract the unique ID of an existing submenu to which a command will be

added @discussion If this element is not provided, the command will be added

to the top level of the Command Menu.

Optional, Integer, 0 - 2,000,000,000

OBJECTIVE-C

@interface SDLMenuParams : SDLRPCStruct

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *parentID;

SWIFT

var parentID: NSNumber! { get set }

Page 541: Documentation iOS SDLAbstractProtocol Class Reference

position

@abstract The position within the items of the parent Command Menu

@discussion 0 will insert at the front, 1 will insert after the first existing

element, etc.

Position of any submenu will always be located before the return and exit

options.

• If position is greater or equal than the number of items in the parent

Command Menu, the sub menu will be appended to the end of that

Command Menu.• If this element is omitted, the entry will be added at the end of the parent

menu.

Optional, Integer, 0 - 1000

menuName

@abstract the menu name which appears in menu, representing this command

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *position;

SWIFT

var position: NSNumber! { get set }

Page 542: Documentation iOS SDLAbstractProtocol Class Reference

Required, max length 500 characters

SDLMyKey Class Reference

Section Contents

• -init• -initWithDictionary:• e911Override

Overview

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *menuName;

SWIFT

var menuName: String! { get set }

Page 543: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

e911Override

Undocumented

SDLNotificationConstants ClassReference

Section Contents

• +allResponseNames• +allButtonEventNotifications

Overview

Undocumented

+allResponseNames

Undocumented

Page 544: Documentation iOS SDLAbstractProtocol Class Reference

+allButtonEventNotifications

Undocumented

SDLOasisAddress Class Reference

Section Contents

• -

initWithSubThoroughfare:thoroughfare:locality:administrativeArea:postalCode:countryCode:• -

initWithSubThoroughfare:thoroughfare:locality:administrativeArea:postalCode:countryCode:countryName:su• countryName• countryCode• postalCode• administrativeArea• subAdministrativeArea• locality• subLocality• thoroughfare• subThoroughfare

Overview

Undocumented

-

initWithSubThoroughfare:thoroughfare:locality:administrativeArea:postalCode:

Undocumented

Page 545: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithSubThoroughfare:thoroughfare:locality:administrativeArea:postalCode:

Undocumented

countryName

@abstract Name of the country (localized)

Optional, max length = 200

countryCode

@abstract countryCode of the country(ISO 3166-2)

Optional, max length = 200

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *countryName;

SWIFT

var countryName: String! { get set }

Page 546: Documentation iOS SDLAbstractProtocol Class Reference

postalCode

@abstract postalCode of location (PLZ, ZIP, PIN, CAP etc.)

Optional, max length = 200

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *countryCode;

SWIFT

var countryCode: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *postalCode;

Page 547: Documentation iOS SDLAbstractProtocol Class Reference

administrativeArea

@abstract Portion of country (e.g. state)

Optional, max length = 200

subAdministrativeArea

@abstract Portion of administrativeArea (e.g. county)

Optional, max length = 200

SWIFT

var postalCode: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *administrativeArea;

SWIFT

var administrativeArea: String! { get set }

Page 548: Documentation iOS SDLAbstractProtocol Class Reference

locality

@abstract Hypernym for city/village

Optional, max length = 200

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *subAdministrativeArea;

SWIFT

var subAdministrativeArea: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *locality;

Page 549: Documentation iOS SDLAbstractProtocol Class Reference

subLocality

@abstract Hypernym for district

Optional, max length = 200

thoroughfare

@abstract Hypernym for street, road etc.

Optional, max length = 200

SWIFT

var locality: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *subLocality;

SWIFT

var subLocality: String! { get set }

Page 550: Documentation iOS SDLAbstractProtocol Class Reference

subThoroughfare

@abstract Portion of thoroughfare (e.g. house number)

Optional, max length = 200

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *thoroughfare;

SWIFT

var thoroughfare: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *subThoroughfare;

Page 551: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnAppInterfaceUnregistered ClassReference

Section Contents

• -init• -initWithDictionary:• reason

Overview

Notifies an application that its interface registration has been terminated. This

means that all SDL resources associated with the application are discarded,

including the Command Menu, Choice Sets, button subscriptions, etc.

For more information about SDL resources related to an interface registration,

see SDLRegisterAppInterface.

@since SDL 1.0 - see: SDLRegisterAppInterface

-init

Constructs a newly allocated SDLOnAppInterfaceUnregistered object

SWIFT

var subThoroughfare: String! { get set }

Page 552: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLOnAppInterfaceUnregistered object indicated

by the dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 553: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

reason

@abstract The reason application’s interface was terminated

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLAppInterfaceUnregisteredReason *reason;

SWIFT

var reason: SDLAppInterfaceUnregisteredReason! { get set }

Page 554: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnAudioPassThru Class Reference

Section Contents

• -init• -initWithDictionary:

Overview

Binary data is in binary part of hybrid msg.

HMI Status Requirements:

HMILevel:

◦ BACKGROUND, FULL, LIMITED

AudioStreamingState:

◦ TBD

SystemContext:

◦ TBD

-init

Constructs a newly allocated SDLOnAudioPassThru object

OBJECTIVE-C

- (instancetype)init;

Page 555: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLOnAudioPassThru object indicated by the

dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 556: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

SDLOnButtonEvent Class Reference

Section Contents

• -init• -initWithDictionary:• buttonName• buttonEventMode• customButtonID

Overview

Notifies application that user has depressed or released a button to which the

application has subscribed.

Further information about button events and button-presses can be found at

SDLSubscribeButton.

HMI Status Requirements:

HMILevel:

◦ The application will receive SDLOnButtonEvent notifications for all

subscribed buttons when HMILevel is FULL.◦ The application will receive SDLOnButtonEvent notifications for

subscribed media buttons when HMILevel is LIMITED.◦ Media buttons include SEEKLEFT, SEEKRIGHT, TUNEUP, TUNEDOWN,

and PRESET_0-PRESET_9.

Page 557: Documentation iOS SDLAbstractProtocol Class Reference

◦ The application will not receive SDLOnButtonEvent notification when

HMILevel is BACKGROUND.

AudioStreamingState:

◦ Any

SystemContext:

◦ MAIN, VR. In MENU, only PRESET buttons. In VR, pressing any

subscribable button will cancel VR.

SeeSDLSubscribeButton

@since SDL 1.0

-init

Constructs a newly allocated SDLOnButtonEvent object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 558: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLOnButtonEvent object indicated by

the dictionary parameter

dict

The dictionary to use

buttonName

@abstract The name of the button

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 559: Documentation iOS SDLAbstractProtocol Class Reference

buttonEventMode

@abstract Indicates whether this is an UP or DOWN event

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonName *buttonName;

SWIFT

var buttonName: SDLButtonName! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonEventMode *buttonEventMode;

SWIFT

var buttonEventMode: SDLButtonEventMode! { get set }

Page 560: Documentation iOS SDLAbstractProtocol Class Reference

customButtonID

@abstract If ButtonName is “CUSTOM_BUTTON”, this references the integer ID

passed by a custom button. (e.g. softButton ID)

@since SDL 2.0

Optional, Integer, 0 - 65536

SDLOnButtonPress Class Reference

Section Contents

• -init• -initWithDictionary:

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *customButtonID;

SWIFT

var customButtonID: NSNumber! { get set }

Page 561: Documentation iOS SDLAbstractProtocol Class Reference

• buttonName• buttonPressMode• customButtonID

Overview

Notifies application of button press events for buttons to which the application

is subscribed. SDL supports two button press events defined as follows:

• SHORT - Occurs when a button is depressed, then released within two

seconds. The event is considered to occur immediately after the button is

released.• LONG - Occurs when a button is depressed and held for two seconds or

more. The event is considered to occur immediately after the two second

threshold has been crossed, before the button is released

HMI Status Requirements:

HMILevel:

◦ The application will receive OnButtonPress notifications for all

subscribed buttons when HMILevel is FULL.◦ The application will receive OnButtonPress notifications for

subscribed media buttons when HMILevel is LIMITED.◦ Media buttons include SEEKLEFT, SEEKRIGHT, TUNEUP, TUNEDOWN,

and PRESET_0-PRESET_9.◦ The application will not receive OnButtonPress notification when

HMILevel is BACKGROUND or NONE.

AudioStreamingState:

◦ Any

SystemContext:

◦ MAIN, VR. In MENU, only PRESET buttons. In VR, pressing any

subscribable button will cancel VR.

SeeSDLSubscribeButton SeeSDLUnsubscribeButton

Page 562: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 1.0

-init

Constructs a newly allocated SDLOnButtonPress object

-initWithDictionary:

Constructs a newly allocated SDLOnButtonPress object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 563: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

buttonName

@abstract the button’s name

SeeSDLButtonName Required

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonName *buttonName;

Page 564: Documentation iOS SDLAbstractProtocol Class Reference

buttonPressMode

@abstract Indicates whether this is a LONG or SHORT button press event

SeeSDLButtonPressMode Required

customButtonID

@abstract If ButtonName is “CUSTOM_BUTTON”, this references the integer ID

passed by a custom button. (e.g. softButton ID)

SWIFT

var buttonName: SDLButtonName! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonPressMode *buttonPressMode;

SWIFT

var buttonPressMode: SDLButtonPressMode! { get set }

Page 565: Documentation iOS SDLAbstractProtocol Class Reference

@since SDL 2.0

Optional, Integer 0 - 65536

SDLOnCommand Class Reference

Section Contents

• -init• -initWithDictionary:• cmdID

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *customButtonID;

SWIFT

var customButtonID: NSNumber! { get set }

Page 566: Documentation iOS SDLAbstractProtocol Class Reference

• triggerSource

Overview

This is called when a command was selected via VR after pressing the PTT

button, or selected from the menu after pressing the MENU button.

Note: The sequence of SDLOnHMIStatus and SDLOnCommand notifications for

user-initiated interactions is indeterminate.

@since SDL 1.0 - see: SDLAddCommand SDLDeleteCommand

SDLDeleteSubMenu

-init

Constructs a newly allocated SDLRPCNotification object

-initWithDictionary:

Constructs a newly allocated SDLRPCNotification object indicated by the

dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 567: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

cmdID

@abstract The command ID of the command the user selected. This is the

command ID value provided by the application in the SDLAddCommand

operation that created the command.

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 568: Documentation iOS SDLAbstractProtocol Class Reference

triggerSource

@abstract Indicates whether command was selected via voice or via a menu

selection (using the OK button).

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *cmdID;

SWIFT

var cmdID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTriggerSource *triggerSource;

SWIFT

var triggerSource: SDLTriggerSource! { get set }

Page 569: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnDriverDistraction ClassReference

Section Contents

• -init• -initWithDictionary:• state

Overview

Notifies the application of the current driver distraction state (whether driver

distraction rules are in effect, or not).

HMI Status Requirements:

HMILevel:

◦ Can be sent with FULL, LIMITED or BACKGROUND

AudioStreamingState:

◦ Any

SystemContext:

◦ Any

@since SDL 1.0

-init

Constructs a newly allocated SDLOnDriverDistraction object

Page 570: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLOnDriverDistraction object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 571: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

state

@abstract The driver distraction state (i.e. whether driver distraction rules are

in effect, or not)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDriverDistractionState *state;

SWIFT

var state: SDLDriverDistractionState! { get set }

Page 572: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnEncodedSyncPData ClassReference

Section Contents

• -init• -initWithDictionary:• data• URL• Timeout

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

data

Undocumented

URL

Undocumented

Page 573: Documentation iOS SDLAbstractProtocol Class Reference

Timeout

Undocumented

SDLOnHMIStatus Class Reference

Section Contents

• -init• -initWithDictionary:• hmiLevel• audioStreamingState• systemContext

Overview

Notifies an application that HMI conditions have changed for the application.

This indicates whether the application can speak phrases, display text, perform

interactions, receive button presses and events, stream audio, etc. This

notification will be sent to the application when there has been a change in any

one or several of the indicated states (SDLHMILevel, SDLAudioStreamingState

or SDLSystemContext) for the application.

All three values are, in principle, independent of each other (though there may

be some relationships). A value for one parameter should not be interpreted

from the value of another parameter.

There are no guarantees about the timeliness or latency of the

SDLOnHMIStatus notification. Therefore, for example, information such as

SDLAudioStreamingState may not indicate that the audio stream became

inaudible to the user exactly when the SDLOnHMIStatus notification was

received.

@since SDL 1.0

Page 574: Documentation iOS SDLAbstractProtocol Class Reference

-init

Constructs a newly allocated SDLOnHMIStatus object

-initWithDictionary:

Constructs a newly allocated SDLOnHMIStatus object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 575: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

hmiLevel

@abstract SDLHMILevel in effect for the application

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLHMILevel *hmiLevel;

SWIFT

var hmiLevel: SDLHMILevel! { get set }

Page 576: Documentation iOS SDLAbstractProtocol Class Reference

audioStreamingState

@abstract Current state of audio streaming for the application. When this

parameter has a value of NOT_AUDIBLE, the application must stop streaming

audio to SDL.

Informs app whether any currently streaming audio is audible to user (AUDIBLE)

or not (NOT_AUDIBLE). A value of NOT_AUDIBLE means that either the

application’s audio will not be audible to the user, or that the application’s

audio should not be audible to the user (i.e. some other application on the

mobile device may be streaming audio and the application’s audio would be

blended with that other audio).

systemContext

@abstract the System Context @discussion whether a user-initiated interaction

is in-progress (VRSESSION or MENU), or not (MAIN)

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLAudioStreamingState *audioStreamingState;

SWIFT

var audioStreamingState: SDLAudioStreamingState! { get set }

Page 577: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnHashChange Class Reference

Section Contents

• -init• -initWithDictionary:• hashID

Overview

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSystemContext *systemContext;

SWIFT

var systemContext: SDLSystemContext! { get set }

Page 578: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

hashID

Undocumented

SDLOnKeyboardInput Class Reference

Section Contents

• -init• -initWithDictionary:• event• data

Overview

Undocumented

-init

Undocumented

Page 579: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

event

Undocumented

data

Undocumented

SDLOnLanguageChange ClassReference

Section Contents

• -init• -initWithDictionary:• language• hmiDisplayLanguage

Overview

Provides information to what language the SDL HMI language was changed

@since SDL 2.0

-init

Constructs a newly allocated SDLOnLanguageChange object

Page 580: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLOnLanguageChange object indicated by the

dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 581: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

language

@abstract Current SDL voice engine (VR+TTS) language

hmiDisplayLanguage

@abstract Current display language

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *language;

SWIFT

var language: SDLLanguage! { get set }

Page 582: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnLockScreenStatus ClassReference

Section Contents

• -init• -initWithDictionary:• driverDistractionStatus• userSelected• lockScreenStatus

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *hmiDisplayLanguage;

SWIFT

var hmiDisplayLanguage: SDLLanguage! { get set }

Page 583: Documentation iOS SDLAbstractProtocol Class Reference

• hmiLevel

Overview

-init

Undocumented

-initWithDictionary:

Undocumented

To help prevent driver distraction, any SmartDeviceLink application is required t

This lockscreen must perform the following:Limit all application control usability from the mobile device with a full-screenFor simplicity, the OnLockScreenStatus RPC will be provided via the onOnLockScreeThe call back also includes details regarding the current HMI_Status level, drive

OBJECTIVE-C

@interface SDLOnLockScreenStatus : SDLRPCNotification

OBJECTIVE-C

@interface SDLOnLockScreenStatus : SDLRPCNotification

Page 584: Documentation iOS SDLAbstractProtocol Class Reference

driverDistractionStatus

Get the current driver distraction status(i.e. whether driver distraction rules are

in effect, or not)

String

userSelected

Get user selection status for the application (has the app been selected via hmi

or voice command)

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *driverDistractionStatus;

SWIFT

var driverDistractionStatus: NSNumber! { get set }

RETURN VALUE

Page 585: Documentation iOS SDLAbstractProtocol Class Reference

Boolean the current user selection status

lockScreenStatus

Get the {@linkplain LockScreenStatus} enumeration, indicating if the

lockscreen should be required, optional or off

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *userSelected;

SWIFT

var userSelected: NSNumber! { get set }

RETURN VALUE

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLockScreenStatus *lockScreenStatus;

Page 586: Documentation iOS SDLAbstractProtocol Class Reference

{@linkplain LockScreenStatus}

hmiLevel

Get HMILevel in effect for the application

SWIFT

var lockScreenStatus: SDLLockScreenStatus! { get set }

RETURN VALUE

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLHMILevel *hmiLevel;

SWIFT

var hmiLevel: SDLHMILevel! { get set }

Page 587: Documentation iOS SDLAbstractProtocol Class Reference

{@linkplain HMILevel} the current HMI Level in effect for the application

SDLOnPermissionsChange ClassReference

Section Contents

• -init• -initWithDictionary:• permissionItem

Overview

Provides update to app of which sets of functions are available

@since SDL 2.0

-init

Constructs a newly allocated SDLOnPermissionsChange object

RETURN VALUE

OBJECTIVE-C

- (instancetype)init;

Page 588: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a newly allocated SDLOnPermissionsChange object indicated by the

dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 589: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

permissionItem

@abstract Describes change in permissions for a given set of RPCs

Required, Array of SDLPermissionItem, Array size 0 - 500

SeeSDLPermissionItem

SDLOnSyncPData Class Reference

Section Contents

• -init

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *permissionItem;

SWIFT

var permissionItem: NSMutableArray! { get set }

Page 590: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• URL• Timeout

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

URL

Undocumented

Timeout

Undocumented

SDLOnSystemRequest Class Reference

Section Contents

• -init• -initWithDictionary:• requestType• url

Page 591: Documentation iOS SDLAbstractProtocol Class Reference

• timeout• fileType• offset• length

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

requestType

Undocumented

url

Undocumented

timeout

Undocumented

fileType

Undocumented

Page 592: Documentation iOS SDLAbstractProtocol Class Reference

offset

Undocumented

length

Undocumented

SDLOnTBTClientState Class Reference

Section Contents

• -init• -initWithDictionary:• state

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

state

Undocumented

Page 593: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnTouchEvent Class Reference

Section Contents

• -init• -initWithDictionary:• type• event

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

type

Undocumented

event

Undocumented

Page 594: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnVehicleData Class Reference

Section Contents

• -init• -initWithDictionary:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• vin• prndl• tirePressure• odometer• beltStatus• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModeStatus

Page 595: Documentation iOS SDLAbstractProtocol Class Reference

• myKey

Overview

Request vehicle data.

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLOnVehicleData object

-initWithDictionary:

@abstract Constructs a new SDLOnVehicleData object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 596: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

gps

@abstract A SDLGPSData* value. See GPSData.

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLGPSData *gps;

Page 597: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract The vehicle speed in kilometers per hour.

rpm

@abstract The number of revolutions per minute of the engine.

SWIFT

var gps: SDLGPSData! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

SWIFT

var speed: NSNumber! { get set }

Page 598: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel

@abstract The fuel level in the tank (percentage)

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rpm;

SWIFT

var rpm: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel;

SWIFT

var fuelLevel: NSNumber! { get set }

Page 599: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel_State

@abstract A SDLComponentVolumeStatus* value. The fuel level state.

instantFuelConsumption

@abstract The instantaneous fuel consumption in microlitres.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLComponentVolumeStatus *fuelLevel_State;

SWIFT

var fuelLevel_State: SDLComponentVolumeStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *instantFuelConsumption;

Page 600: Documentation iOS SDLAbstractProtocol Class Reference

externalTemperature

@abstract The external temperature in degrees celsius.

vin

@abstract The Vehicle Identification Number

SWIFT

var instantFuelConsumption: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *externalTemperature;

SWIFT

var externalTemperature: NSNumber! { get set }

Page 601: Documentation iOS SDLAbstractProtocol Class Reference

prndl

@abstract See PRNDL.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *vin;

SWIFT

var vin: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLPRNDL *prndl;

SWIFT

var prndl: SDLPRNDL! { get set }

Page 602: Documentation iOS SDLAbstractProtocol Class Reference

tirePressure

@abstract A SDLTireStatus* value. See TireStatus.

odometer

@abstract Odometer reading in km.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTireStatus *tirePressure;

SWIFT

var tirePressure: SDLTireStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *odometer;

Page 603: Documentation iOS SDLAbstractProtocol Class Reference

beltStatus

@abstract A SDLBeltStatus* value. The status of the seat belts.

bodyInformation

@abstract A SDLBodyInformation* value. The body information including power

modes.

SWIFT

var odometer: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBeltStatus *beltStatus;

SWIFT

var beltStatus: SDLBeltStatus! { get set }

Page 604: Documentation iOS SDLAbstractProtocol Class Reference

deviceStatus

@abstract A SDLDeviceStatus* value. The device status including signal and

battery strength.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBodyInformation *bodyInformation;

SWIFT

var bodyInformation: SDLBodyInformation! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDeviceStatus *deviceStatus;

Page 605: Documentation iOS SDLAbstractProtocol Class Reference

driverBraking

@abstract A SDLVehicleDataResult* value. The status of the brake pedal.

wiperStatus

@abstract A SDLWiperStatus* value. The status of the wipers.

SWIFT

var deviceStatus: SDLDeviceStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataEventStatus *driverBraking;

SWIFT

var driverBraking: SDLVehicleDataEventStatus! { get set }

Page 606: Documentation iOS SDLAbstractProtocol Class Reference

headLampStatus

@abstract A SDLHeadLampStatus* value. Status of the head lamps.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLWiperStatus *wiperStatus;

SWIFT

var wiperStatus: SDLWiperStatus! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLHeadLampStatus *headLampStatus;

SWIFT

var headLampStatus: SDLHeadLampStatus! { get set }

Page 607: Documentation iOS SDLAbstractProtocol Class Reference

engineTorque

@abstract Torque value for engine (in Nm) on non-diesel variants.

accPedalPosition

@abstract Accelerator pedal position (percentage depressed)

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *engineTorque;

SWIFT

var engineTorque: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *accPedalPosition;

Page 608: Documentation iOS SDLAbstractProtocol Class Reference

steeringWheelAngle

@abstract Current angle of the steering wheel (in deg)

eCallInfo

Undocumented

SWIFT

var accPedalPosition: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *steeringWheelAngle;

SWIFT

var steeringWheelAngle: NSNumber! { get set }

Page 609: Documentation iOS SDLAbstractProtocol Class Reference

airbagStatus

Undocumented

emergencyEvent

Undocumented

OBJECTIVE-C

@interface SDLOnVehicleData : SDLRPCNotification

OBJECTIVE-C

@interface SDLOnVehicleData : SDLRPCNotification

OBJECTIVE-C

@interface SDLOnVehicleData : SDLRPCNotification

Page 610: Documentation iOS SDLAbstractProtocol Class Reference

clusterModeStatus

Undocumented

myKey

Undocumented

SDLPRNDL Class Reference

Section Contents

• +valueOf:• +values• +PARK

OBJECTIVE-C

@interface SDLOnVehicleData : SDLRPCNotification

OBJECTIVE-C

@interface SDLOnVehicleData : SDLRPCNotification

Page 611: Documentation iOS SDLAbstractProtocol Class Reference

• +REVERSE• +NEUTRAL• +DRIVE• +SPORT• +LOWGEAR• +FIRST• +SECOND• +THIRD• +FOURTH• +FIFTH• +SIXTH• +SEVENTH• +EIGHTH• +UNKNOWN• +FAULT

Overview

The selected gear the car is in.

@since SDL 2.0

+valueOf:

@abstract get SDLPRNDL according value string

OBJECTIVE-C

+ (SDLPRNDL *)valueOf:(NSString *)value;

Page 612: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLPRNDL object

+values

@abstract declare an array to store all possible SDLPRNDL values

SWIFT

class func value(of value: String!) -> SDLPRNDL!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 613: Documentation iOS SDLAbstractProtocol Class Reference

the array

+PARK

@abstract Park

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)PARK;

SWIFT

class func park() -> SDLPRNDL!

Page 614: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: PARK

+REVERSE

@abstract Reverse gear

SDLPRNDL: REVERSE

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)REVERSE;

SWIFT

class func reverse() -> SDLPRNDL!

RETURN VALUE

Page 615: Documentation iOS SDLAbstractProtocol Class Reference

+NEUTRAL

@abstract No gear

SDLPRNDL: NEUTRAL

+DRIVE

@abstract: Drive gear

OBJECTIVE-C

+ (SDLPRNDL *)NEUTRAL;

SWIFT

class func neutral() -> SDLPRNDL!

RETURN VALUE

Page 616: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: DRIVE

+SPORT

@abstract Drive Sport mode

OBJECTIVE-C

+ (SDLPRNDL *)DRIVE;

SWIFT

class func drive() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)SPORT;

Page 617: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: SPORT

+LOWGEAR

@abstract 1st gear hold

SWIFT

class func sport() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)LOWGEAR;

SWIFT

class func lowgear() -> SDLPRNDL!

Page 618: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: LOWGEAR

+FIRST

@abstract First gear

SDLPRNDL: FIRST

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)FIRST;

SWIFT

class func first() -> SDLPRNDL!

RETURN VALUE

Page 619: Documentation iOS SDLAbstractProtocol Class Reference

+SECOND

@abstract Second gear

SDLPRNDL: SECOND

+THIRD

@abstract Third gear

OBJECTIVE-C

+ (SDLPRNDL *)SECOND;

SWIFT

class func second() -> SDLPRNDL!

RETURN VALUE

Page 620: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: THIRD

+FOURTH

@abstract Fourth gear

OBJECTIVE-C

+ (SDLPRNDL *)THIRD;

SWIFT

class func third() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)FOURTH;

Page 621: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: FOURTH

+FIFTH

@abstract Fifth gear

SWIFT

class func fourth() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)FIFTH;

SWIFT

class func fifth() -> SDLPRNDL!

Page 622: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: FIFTH

+SIXTH

@abstract Sixth gear

SDLPRNDL: SIXTH

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)SIXTH;

SWIFT

class func sixth() -> SDLPRNDL!

RETURN VALUE

Page 623: Documentation iOS SDLAbstractProtocol Class Reference

+SEVENTH

@abstract Seventh gear

SDLPRNDL: SEVENTH

+EIGHTH

@abstract Eighth gear

OBJECTIVE-C

+ (SDLPRNDL *)SEVENTH;

SWIFT

class func seventh() -> SDLPRNDL!

RETURN VALUE

Page 624: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: EIGHTH

+UNKNOWN

@abstract Unknown

OBJECTIVE-C

+ (SDLPRNDL *)EIGHTH;

SWIFT

class func eighth() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)UNKNOWN;

Page 625: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: UNKNOWN

+FAULT

@abstract Fault

SWIFT

class func unknown() -> SDLPRNDL!

RETURN VALUE

OBJECTIVE-C

+ (SDLPRNDL *)FAULT;

SWIFT

class func fault() -> SDLPRNDL!

Page 626: Documentation iOS SDLAbstractProtocol Class Reference

SDLPRNDL: FAULT

SDLParameterPermissions ClassReference

Section Contents

• -init• -initWithDictionary:• allowed• userDisallowed

Overview

Defining sets of parameters, which are permitted or prohibited for a given RPC.

@since SDL 2.0

-init

@abstract Constructs a newly allocated SDLParameterPermissions object

RETURN VALUE

Page 627: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLParameterPermissions object

indicated by the dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 628: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

allowed

@abstract A set of all parameters that are permitted for this given RPC.

Required, Array of String, max String length = 100, Array size 0 - 100

userDisallowed

@abstract A set of all parameters that are prohibited for this given RPC.

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *allowed;

SWIFT

var allowed: NSMutableArray! { get set }

Page 629: Documentation iOS SDLAbstractProtocol Class Reference

Required, Array of String, max String length = 100, Array size 0 - 100

SDLPerformAudioPassThru ClassReference

Section Contents

• -init• -initWithDictionary:• -initWithSamplingRate:bitsPerSample:audioType:maxDuration:• -

initWithInitialPrompt:audioPassThruDisplayText1:audioPassThruDisplayText2:samplingRate:bitsPerSample:au• initialPrompt• audioPassThruDisplayText1• audioPassThruDisplayText2

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *userDisallowed;

SWIFT

var userDisallowed: NSMutableArray! { get set }

Page 630: Documentation iOS SDLAbstractProtocol Class Reference

• samplingRate• maxDuration• bitsPerSample• audioType• muteAudio

Overview

This will open an audio pass thru session. By doing so the app can receive

audio data through the vehicle microphone

Function Group: AudioPassThru

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 2.0

See SDLEndAudioPassThru

-init

@abstract Constructs a new SDLPerformAudioPassThru object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 631: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLPerformAudioPassThru object indicated by the

NSMutableDictionary - parameter: dict The dictionary to use

dict

The dictionary to use

-

initWithSamplingRate:bitsPerSample:audioType:maxDuration:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 632: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithInitialPrompt:audioPassThruDisplayText1:audioPassThruDisplayText2:sa

Undocumented

initialPrompt

@abstract initial prompt which will be spoken before opening the audio pass

thru session by SDL @discussion initialPrompt a Vector value represents the

initial prompt which will be spoken before opening the audio pass thru session

by SDL

Notes:

• This is an array of text chunks of type TTSChunk• The array must have at least one item• If omitted, then no initial prompt is spoken• Array Minsize: 1• Array Maxsize: 100

OBJECTIVE-C

@interface SDLPerformAudioPassThru : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformAudioPassThru : SDLRPCRequest

Page 633: Documentation iOS SDLAbstractProtocol Class Reference

audioPassThruDisplayText1

@abstract a line of text displayed during audio capture @discussion

audioPassThruDisplayText1 a String value representing the line of text

displayed during audio capture

Notes: Maxlength=500

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *initialPrompt;

SWIFT

var initialPrompt: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *audioPassThruDisplayText1;

Page 634: Documentation iOS SDLAbstractProtocol Class Reference

audioPassThruDisplayText2

@abstract A line of text displayed during audio capture @discussion

audioPassThruDisplayText2 a String value representing the line of text

displayed during audio capture

Notes: Maxlength=500

samplingRate

@abstract A samplingRate

SWIFT

var audioPassThruDisplayText1: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *audioPassThruDisplayText2;

SWIFT

var audioPassThruDisplayText2: String! { get set }

Page 635: Documentation iOS SDLAbstractProtocol Class Reference

@discussion a SamplingRate value representing a 8 or 16 or 22 or 24 khz

maxDuration

@abstract the maximum duration of audio recording in milliseconds

@discussion maxDuration an Integer value representing the maximum duration

of audio recording in millisecond

Notes: Minvalue:1; Maxvalue:1000000

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSamplingRate *samplingRate;

SWIFT

var samplingRate: SDLSamplingRate! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *maxDuration;

Page 636: Documentation iOS SDLAbstractProtocol Class Reference

bitsPerSample

@abstract the quality the audio is recorded - 8 bit or 16 bit

@discussion a BitsPerSample value representing 8 bit or 16 bit

audioType

@abstract an audioType

SWIFT

var maxDuration: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLBitsPerSample *bitsPerSample;

SWIFT

var bitsPerSample: SDLBitsPerSample! { get set }

Page 637: Documentation iOS SDLAbstractProtocol Class Reference

muteAudio

@abstract a Boolean value representing if the current audio source should be

muted during the APT session

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLAudioType *audioType;

SWIFT

var audioType: SDLAudioType! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *muteAudio;

SWIFT

var muteAudio: NSNumber! { get set }

Page 638: Documentation iOS SDLAbstractProtocol Class Reference

SDLPerformAudioPassThruResponseClass Reference

Section Contents

• -init• -initWithDictionary:

Overview

Perform Audio Pass Thru Response is sent, when PerformAudioPassThru has

been called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLPerformAudioPassThruResponse object

OBJECTIVE-C

- (instancetype)init;

Page 639: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLPerformAudioPassThruResponse object

indicated by the dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 640: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

SDLPerformInteraction Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithInteractionChoiceSetId:• -initWithInteractionChoiceSetIdList:• -initWithInitialPrompt:initialText:interactionChoiceSetID:• -initWithInitialPrompt:initialText:interactionChoiceSetID:vrHelp:• -

initWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeoutPrompt:interactionMode:timeo• -

initWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeoutPrompt:interactionMode:timeo• -

initWithInitialChunks:initialText:interactionChoiceSetIDList:helpChunks:timeoutChunks:interactionMode:time• -

initWithInitialChunks:initialText:interactionChoiceSetIDList:helpChunks:timeoutChunks:interactionMode:time• initialText• initialPrompt• interactionMode• interactionChoiceSetIDList• helpPrompt• timeoutPrompt• timeout• vrHelp

Page 641: Documentation iOS SDLAbstractProtocol Class Reference

• interactionLayout

Overview

Performs an application-initiated interaction in which the user can select a

{@linkplain Choice} from among the specified Choice Sets. For instance, an

application may use a PerformInteraction to ask a user to say the name of a

song to play. The user’s response is only valid if it appears in the specified

Choice Sets and is recognized by SDL

Function Group: Base

HMILevel needs to be FULL

Since SmartDeviceLink 1.0

See SDLCreateInteractionChoiceSet SDLDeleteInteractionChoiceSet

-init

@abstract Constructs a new SDLPerformInteraction object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 642: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLPerformInteraction object indicated by the

NSMutableDictionary - parameter: dict The dictionary to use

dict

The dictionary to use

-initWithInteractionChoiceSetId:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 643: Documentation iOS SDLAbstractProtocol Class Reference

-initWithInteractionChoiceSetIdList:

Undocumented

-

initWithInitialPrompt:initialText:interactionChoiceSetID:

Undocumented

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

Page 644: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithInitialPrompt:initialText:interactionChoiceSetID:vrHelp:

Undocumented

-

initWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeout

Undocumented

-

initWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeout

Undocumented

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

Page 645: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithInitialChunks:initialText:interactionChoiceSetIDList:helpChunks:timeout

Undocumented

-

initWithInitialChunks:initialText:interactionChoiceSetIDList:helpChunks:timeout

Undocumented

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

Page 646: Documentation iOS SDLAbstractProtocol Class Reference

initialText

@abstract The Text that Displayed when the interaction begins. This text may

be overlaid by the “Listening” prompt during the interaction. Text is displayed

on first line of multiline display, and is centered. If text does not fit on line, it

will be truncated

initialPrompt

@abstract An array of one or more TTSChunks that, taken together, specify

what is to be spoken to the user at the start of an interaction

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *initialText;

SWIFT

var initialText: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *initialPrompt;

Page 647: Documentation iOS SDLAbstractProtocol Class Reference

interactionMode

@abstract The Indicates mode that indicate how user selects interaction

choice. User can choose either by voice (VR_ONLY), by visual selection from the

menu (MANUAL_ONLY), or by either mode (BOTH)

interactionChoiceSetIDList

@abstract A Vector value representing an Array of one or more Choice Set IDs

SWIFT

var initialPrompt: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLInteractionMode *interactionMode;

SWIFT

var interactionMode: SDLInteractionMode! { get set }

Page 648: Documentation iOS SDLAbstractProtocol Class Reference

helpPrompt

@abstract A Vector which taken together, specify the help phrase to be spoken

when the user says “help” during the VR session

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *interactionChoiceSetIDList;

SWIFT

var interactionChoiceSetIDList: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *helpPrompt;

Page 649: Documentation iOS SDLAbstractProtocol Class Reference

timeoutPrompt

@abstract An array of TTSChunks which, taken together, specify the phrase to

be spoken when the listen times out during the VR session

timeout

@abstract An Integer value representing the amount of time, in milliseconds,

SDL will wait for the user to make a choice (VR or Menu)

SWIFT

var helpPrompt: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *timeoutPrompt;

SWIFT

var timeoutPrompt: NSMutableArray! { get set }

Page 650: Documentation iOS SDLAbstractProtocol Class Reference

vrHelp

@abstract A Voice recognition Help, which is a suggested VR Help Items to

display on-screen during Perform Interaction @since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *timeout;

SWIFT

var timeout: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrHelp;

SWIFT

var vrHelp: NSMutableArray! { get set }

Page 651: Documentation iOS SDLAbstractProtocol Class Reference

interactionLayout

Undocumented

SDLPerformInteractionResponse ClassReference

Section Contents

• -init• -initWithDictionary:• choiceID• manualTextEntry• triggerSource

Overview

PerformInteraction Response is sent, when SDLPerformInteraction has been

called

@since SDL 1.0

OBJECTIVE-C

@interface SDLPerformInteraction : SDLRPCRequest

Page 652: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLPerformInteractionResponse object

-initWithDictionary:

@abstract Constructs a new SDLPerformInteractionResponse object indicated

by the dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 653: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

choiceID

@abstract ID of the choice that was selected in response to PerformInteraction.

@discussion Only is valid if general result is “success:true”.

Optional, Integer, 0 - 2,000,000,000

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *choiceID;

Page 654: Documentation iOS SDLAbstractProtocol Class Reference

manualTextEntry

@abstract Manually entered text selection, e.g. through keyboard

@discussion Can be returned in lieu of choiceID, depending on trigger source

Optional, Max length 500 chars

triggerSource

@abstract A SDLTriggerSource object which will be shown in the HMI

SWIFT

var choiceID: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *manualTextEntry;

SWIFT

var manualTextEntry: String! { get set }

Page 655: Documentation iOS SDLAbstractProtocol Class Reference

@discussion Only is valid if resultCode is SUCCESS.

SDLPermissionItem Class Reference

Section Contents

• -init• -initWithDictionary:• rpcName• hmiPermissions• parameterPermissions

Overview

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTriggerSource *triggerSource;

SWIFT

var triggerSource: SDLTriggerSource! { get set }

Page 656: Documentation iOS SDLAbstractProtocol Class Reference

-init

Undocumented

-initWithDictionary:

Undocumented

rpcName

Undocumented

hmiPermissions

Undocumented

parameterPermissions

Undocumented

SDLPermissionManager Class Reference

Section Contents

• -startWithCompletionHandler:• -stop• -isRPCAllowed:• -groupStatusOfRPCs:• -statusOfRPCs:• -addObserverForRPCs:groupType:withHandler:• -removeAllObservers

Page 657: Documentation iOS SDLAbstractProtocol Class Reference

• -removeObserverForIdentifier:

Overview

Undocumented

-startWithCompletionHandler:

Start the manager with a completion block that will be called when startup

completes. This is used internally. To use an SDLPermissionManager, you should

use the manager found on SDLManager .

completionHandler

OBJECTIVE-C

- (void)startWithCompletionHandler: (nonnull void (^)(BOOL, NSError *_Nullable))completionHandler;

SWIFT

func start(completionHandler: @escaping (Bool, Error?) -> Void)

PARAMETERS

Page 658: Documentation iOS SDLAbstractProtocol Class Reference

The block to be called when the manager’s setup is complete.

-stop

Stop the manager. This method is used internally.

-isRPCAllowed:

Determine if an individual RPC is allowed for the current HMI level

OBJECTIVE-C

- (void)stop;

SWIFT

func stop()

OBJECTIVE-C

- (BOOL)isRPCAllowed:(nonnull SDLPermissionRPCName)rpcName;

Page 659: Documentation iOS SDLAbstractProtocol Class Reference

rpcName

The name of the RPC to be tested, for example, SDLShow

YES if the RPC is allowed at the current HMI level, NO if not

-groupStatusOfRPCs:

Determine if all RPCs are allowed for the current HMI level

SWIFT

func isRPCAllowed(_ rpcName: String) -> Bool

PARAMETERS

RETURN VALUE

OBJECTIVE-C

- (SDLPermissionGroupStatus)groupStatusOfRPCs: (nonnull NSArray<SDLPermissionRPCName> *)rpcNames;

Page 660: Documentation iOS SDLAbstractProtocol Class Reference

rpcNames

The RPCs to check

AllAllowed if all of the permissions are allowed, AllDisallowed if all the

permissions are disallowed, Any if some are allowed, and some are disallowed

-statusOfRPCs:

Retrieve a dictionary with keys that are the passed in RPC names, and objects

of an NSNumber specifying if that RPC is currently allowed

SWIFT

func groupStatus(ofRPCs rpcNames: [String]) -> SDLPermissionGroupStatus

PARAMETERS

RETURN VALUE

Page 661: Documentation iOS SDLAbstractProtocol Class Reference

rpcNames

An array of RPC names to check

A dictionary specifying if the passed in RPC names are currently allowed or not

OBJECTIVE-C

- (nonnull NSDictionary<SDLPermissionRPCName, NSNumber<SDLBool> *> *)statusOfRPCs:(nonnull NSArray<SDLPermissionRPCName> *)rpcNames;

SWIFT

func status(ofRPCs rpcNames: [String]) -> [String : NSNumber]

PARAMETERS

RETURN VALUE

Page 662: Documentation iOS SDLAbstractProtocol Class Reference

-addObserverForRPCs:groupType:withHandler:

Add an observer for specified RPC names, with a callback that will be called

whenever the value changes, as well as immediately with the current status.

Warning

This block will be captured by the SDLPermissionsManager, be sure to use

weakself/strongself if you are referencing self within your observer block.

Warning

The observer may be called before this method returns, do not attempt to

remove the observer from within the observer. That could send nil to

removeObserverForIdentifier:. If you want functionality like that, call

groupStatusOfRPCs: instead.

OBJECTIVE-C

- (nonnull SDLPermissionObserverIdentifier)addObserverForRPCs:(nonnull NSArray<SDLPermissionRPCName> *)rpcNames groupType:(SDLPermissionGroupType)groupType withHandler:(nonnull SDLPermissionsChangedHandler)handler;

SWIFT

func addObserver(forRPCs rpcNames: [String], groupType: SDLPermissionGroupType, withHandler handler: @escaping SDLPermissionsChangedHandler) -> UUID

Page 663: Documentation iOS SDLAbstractProtocol Class Reference

rpcNames

The RPCs to be observed

groupType

Affects the times that the observer block will be called. If Any, any

change to any RPC in rpcNames will cause the observer block to be

called. If AllAllowed, the block will be called when: 1. Every RPC in

rpcNames becomes allowed 2. The group of rpcNames goes from all

being allowed to some or all being disallowed.

handler

The block that will be called whenever permissions change.

An identifier that can be passed to removeObserverForIdentifer: to remove the

observer

-removeAllObservers

Remove every current observer

PARAMETERS

RETURN VALUE

Page 664: Documentation iOS SDLAbstractProtocol Class Reference

-removeObserverForIdentifier:

Remove block observers for the specified RPC

OBJECTIVE-C

- (void)removeAllObservers;

SWIFT

func removeAllObservers()

OBJECTIVE-C

- (void)removeObserverForIdentifier: (nonnull SDLPermissionObserverIdentifier)identifier;

SWIFT

func removeObserver(forIdentifier identifier: UUID)

Page 665: Documentation iOS SDLAbstractProtocol Class Reference

identifier

The identifier specifying which observer to remove

SDLPermissionStatus Class Reference

Section Contents

• +valueOf:• +values• +ALLOWED• +DISALLOWED• +USER_DISALLOWED• +USER_CONSENT_PENDING

Overview

Enumeration that describes possible permission states of a policy table entry.

@since SDL 2.0

+valueOf:

@abstract SDLPermissionStatus

PARAMETERS

Page 666: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

a SDLPermissionStatus object

OBJECTIVE-C

+ (SDLPermissionStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLPermissionStatus!

PARAMETERS

RETURN VALUE

Page 667: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract declare an array to store all possible SDLPermissionStatus values -

returns: the array

the array

+ALLOWED

@abstract permission: allowed - returns: permission status: ALLOWED

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 668: Documentation iOS SDLAbstractProtocol Class Reference

permission status: ALLOWED

+DISALLOWED

@abstract permission: disallowed - returns: permission status: DISALLOWED

OBJECTIVE-C

+ (SDLPermissionStatus *)ALLOWED;

SWIFT

class func allowed() -> SDLPermissionStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLPermissionStatus *)DISALLOWED;

Page 669: Documentation iOS SDLAbstractProtocol Class Reference

permission status: DISALLOWED

+USER_DISALLOWED

@abstract permission: user disallowed - returns: permission status:

USER_DISALLOWED

SWIFT

class func disallowed() -> SDLPermissionStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLPermissionStatus *)USER_DISALLOWED;

SWIFT

class func user_DISALLOWED() -> SDLPermissionStatus!

Page 670: Documentation iOS SDLAbstractProtocol Class Reference

permission status: USER_DISALLOWED

+USER_CONSENT_PENDING

@abstract permission: user consent pending - returns: permission status:

USER_CONSENT_PENDING

permission status: USER_CONSENT_PENDING

RETURN VALUE

OBJECTIVE-C

+ (SDLPermissionStatus *)USER_CONSENT_PENDING;

SWIFT

class func user_CONSENT_PENDING() -> SDLPermissionStatus!

RETURN VALUE

Page 671: Documentation iOS SDLAbstractProtocol Class Reference

SDLPowerModeQualificationStatusClass Reference

Section Contents

• +valueOf:• +values• +POWER_MODE_UNDEFINED• +POWER_MODE_EVALUATION_IN_PROGRESS• +NOT_DEFINED• +POWER_MODE_OK

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+POWER_MODE_UNDEFINED

Undocumented

+POWER_MODE_EVALUATION_IN_PROGRESS

Undocumented

Page 672: Documentation iOS SDLAbstractProtocol Class Reference

+NOT_DEFINED

Undocumented

+POWER_MODE_OK

Undocumented

SDLPowerModeStatus Class Reference

Section Contents

• +valueOf:• +values• +KEY_OUT• +KEY_RECENTLY_OUT• +KEY_APPROVED_0• +POST_ACCESORY_0• +ACCESORY_1• +POST_IGNITION_1• +IGNITION_ON_2• +RUNNING_2• +CRANK_3

Overview

Undocumented

+valueOf:

Undocumented

Page 673: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+KEY_OUT

Undocumented

+KEY_RECENTLY_OUT

Undocumented

+KEY_APPROVED_0

Undocumented

+POST_ACCESORY_0

Undocumented

+ACCESORY_1

Undocumented

+POST_IGNITION_1

Undocumented

+IGNITION_ON_2

Undocumented

Page 674: Documentation iOS SDLAbstractProtocol Class Reference

+RUNNING_2

Undocumented

+CRANK_3

Undocumented

SDLPredefinedLayout Class Reference

Section Contents

• +valueOf:• +values• +DEFAULT• +MEDIA• +NON_MEDIA• +ONSCREEN_PRESETS• +NAV_FULLSCREEN_MAP• +NAV_LIST• +NAV_KEYBOARD• +GRAPHIC_WITH_TEXT• +TEXT_WITH_GRAPHIC• +TILES_ONLY• +TEXTBUTTONS_ONLY• +GRAPHIC_WITH_TILES• +TILES_WITH_GRAPHIC• +GRAPHIC_WITH_TEXT_AND_SOFTBUTTONS• +TEXT_AND_SOFTBUTTONS_WITH_GRAPHIC• +GRAPHIC_WITH_TEXTBUTTONS• +TEXTBUTTONS_WITH_GRAPHIC• +LARGE_GRAPHIC_WITH_SOFTBUTTONS• +DOUBLE_GRAPHIC_WITH_SOFTBUTTONS

Page 675: Documentation iOS SDLAbstractProtocol Class Reference

• +LARGE_GRAPHIC_ONLY

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+DEFAULT

Undocumented

+MEDIA

Undocumented

+NON_MEDIA

Undocumented

+ONSCREEN_PRESETS

Undocumented

+NAV_FULLSCREEN_MAP

Undocumented

Page 676: Documentation iOS SDLAbstractProtocol Class Reference

+NAV_LIST

Undocumented

+NAV_KEYBOARD

Undocumented

+GRAPHIC_WITH_TEXT

Undocumented

+TEXT_WITH_GRAPHIC

Undocumented

+TILES_ONLY

Undocumented

+TEXTBUTTONS_ONLY

Undocumented

+GRAPHIC_WITH_TILES

Undocumented

+TILES_WITH_GRAPHIC

Undocumented

Page 677: Documentation iOS SDLAbstractProtocol Class Reference

+GRAPHIC_WITH_TEXT_AND_SOFTBUTTONS

Undocumented

+TEXT_AND_SOFTBUTTONS_WITH_GRAPHIC

Undocumented

+GRAPHIC_WITH_TEXTBUTTONS

Undocumented

+TEXTBUTTONS_WITH_GRAPHIC

Undocumented

+LARGE_GRAPHIC_WITH_SOFTBUTTONS

Undocumented

+DOUBLE_GRAPHIC_WITH_SOFTBUTTONS

Undocumented

+LARGE_GRAPHIC_ONLY

Undocumented

Page 678: Documentation iOS SDLAbstractProtocol Class Reference

SDLPrerecordedSpeech Class Reference

Section Contents

• +valueOf:• +values• +HELP_JINGLE• +INITIAL_JINGLE• +LISTEN_JINGLE• +POSITIVE_JINGLE• +NEGATIVE_JINGLE

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+HELP_JINGLE

Undocumented

+INITIAL_JINGLE

Undocumented

Page 679: Documentation iOS SDLAbstractProtocol Class Reference

+LISTEN_JINGLE

Undocumented

+POSITIVE_JINGLE

Undocumented

+NEGATIVE_JINGLE

Undocumented

SDLPresetBankCapabilities ClassReference

Section Contents

• -init• -initWithDictionary:• onScreenPresetsAvailable

Overview

Contains information about on-screen preset capabilities.

@since SDL 2.0

-init

@abstract Constructs a newly allocated SDLPresetBankCapabilities object

Page 680: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLPresetBankCapabilities object

indicated by the dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 681: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

onScreenPresetsAvailable

@abstract If Onscreen custom presets are available.

Required, Boolean

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *onScreenPresetsAvailable;

SWIFT

var onScreenPresetsAvailable: NSNumber! { get set }

Page 682: Documentation iOS SDLAbstractProtocol Class Reference

SDLPrimaryAudioSource ClassReference

Section Contents

• +valueOf:• +values• +NO_SOURCE_SELECTED• +USB• +USB2• +BLUETOOTH_STEREO_BTST• +LINE_IN• +IPOD• +MOBILE_APP

Overview

Reflects the current primary audio source of SDL (if selected).

@since SDL 2.0

+valueOf:

@abstract get SDLPrimaryAudioSource according value string

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)valueOf:(NSString *)value;

Page 683: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object enum for

SDLPrimaryAudioSource object

+values

@abstract declare an array to store all possible SDLPrimaryAudioSource values

- returns: the array

SWIFT

class func value(of value: String!) -> SDLPrimaryAudioSource!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 684: Documentation iOS SDLAbstractProtocol Class Reference

the array

+NO_SOURCE_SELECTED

@abstract Currently no source selected - returns: the current primary audio

source: NO_SOURCE_SELECTED

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)NO_SOURCE_SELECTED;

SWIFT

class func no_SOURCE_SELECTED() -> SDLPrimaryAudioSource!

Page 685: Documentation iOS SDLAbstractProtocol Class Reference

the current primary audio source: NO_SOURCE_SELECTED

+USB

@abstract USB is current source - returns: the current primary audio source:

USB

the current primary audio source: USB

RETURN VALUE

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)USB;

SWIFT

class func usb() -> SDLPrimaryAudioSource!

RETURN VALUE

Page 686: Documentation iOS SDLAbstractProtocol Class Reference

+USB2

@abstract USB2 is current source - returns: the current primary audio source:

USB2

the current primary audio source: USB2

+BLUETOOTH_STEREO_BTST

@abstract Bluetooth Stereo is current source - returns: the current primary

audio source: BLUETOOTH_STEREO_BTST

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)USB2;

SWIFT

class func usb2() -> SDLPrimaryAudioSource!

RETURN VALUE

Page 687: Documentation iOS SDLAbstractProtocol Class Reference

the current primary audio source: BLUETOOTH_STEREO_BTST

+LINE_IN

@abstract Line in is current source - returns: the current primary audio source:

LINE_IN

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)BLUETOOTH_STEREO_BTST;

SWIFT

class func bluetooth_STEREO_BTST() -> SDLPrimaryAudioSource!

RETURN VALUE

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)LINE_IN;

Page 688: Documentation iOS SDLAbstractProtocol Class Reference

the current primary audio source: LINE_IN

+IPOD

@abstract iPod is current source - returns: the current primary audio source:

IPOD

SWIFT

class func line_IN() -> SDLPrimaryAudioSource!

RETURN VALUE

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)IPOD;

SWIFT

class func ipod() -> SDLPrimaryAudioSource!

Page 689: Documentation iOS SDLAbstractProtocol Class Reference

the current primary audio source: IPOD

+MOBILE_APP

@abstract Mobile app is current source - returns: the current primary audio

source: MOBILE_APP

the current primary audio source: MOBILE_APP

RETURN VALUE

OBJECTIVE-C

+ (SDLPrimaryAudioSource *)MOBILE_APP;

SWIFT

class func mobile_APP() -> SDLPrimaryAudioSource!

RETURN VALUE

Page 690: Documentation iOS SDLAbstractProtocol Class Reference

SDLProtocol Class Reference

Section Contents

• -sendStartSessionWithType:• -startServiceWithType:• -startSecureServiceWithType:completionHandler:• -sendEndSessionWithType:• -endServiceWithType:• -sendRPC:• -sendRPC:encrypted:error:• -sendRPCRequest:• -sendRawData:withServiceType:• -sendEncryptedRawData:onService:• -handleBytesFromTransport:

Overview

Undocumented

-sendStartSessionWithType:

Undocumented

-startServiceWithType:

Undocumented

-startSecureServiceWithType:completionHandler:

Undocumented

Page 691: Documentation iOS SDLAbstractProtocol Class Reference

-sendEndSessionWithType:

Undocumented

-endServiceWithType:

Undocumented

-sendRPC:

Undocumented

-sendRPC:encrypted:error:

Undocumented

-sendRPCRequest:

Undocumented

-sendRawData:withServiceType:

Undocumented

-sendEncryptedRawData:onService:

Undocumented

-handleBytesFromTransport:

Undocumented

Page 692: Documentation iOS SDLAbstractProtocol Class Reference

SDLProtocolHeader Class Reference

Section Contents

• _version• _size• version• size• compressed• encrypted• frameType• serviceType• frameData• sessionID• bytesInPayload• -init• -data• -parse:• -description• +headerForVersion:

Overview

Undocumented

_version

Undocumented

_size

Undocumented

Page 693: Documentation iOS SDLAbstractProtocol Class Reference

version

Undocumented

size

Undocumented

compressed

Undocumented

encrypted

Undocumented

frameType

Undocumented

serviceType

Undocumented

frameData

Undocumented

sessionID

Undocumented

Page 694: Documentation iOS SDLAbstractProtocol Class Reference

bytesInPayload

Undocumented

-init

Undocumented

-data

Undocumented

-parse:

Undocumented

-description

Undocumented

+headerForVersion:

Undocumented

SDLProtocolMessage Class Reference

Section Contents

• header• payload• data

Page 695: Documentation iOS SDLAbstractProtocol Class Reference

• +messageWithHeader:andPayload:• -size• -description• -rpcDictionary• +determineVersion:

Overview

Undocumented

header

Undocumented

payload

Undocumented

data

Undocumented

+messageWithHeader:andPayload:

Undocumented

-size

Undocumented

-description

Undocumented

Page 696: Documentation iOS SDLAbstractProtocol Class Reference

-rpcDictionary

Undocumented

+determineVersion:

Undocumented

SDLProxy Class Reference

Section Contents

• _version• _bulkSessionID• _isConnected• _alreadyDestructed• protocol• transport• proxyListeners• startSessionTimer• debugConsoleGroupName• proxyVersion• streamingMediaManager• -initWithTransport:protocol:delegate:• -dispose• -addDelegate:• -removeDelegate:• -sendRPC:• -sendRPCRequest:• -handleRPCDictionary:• -handleRpcMessage:• -handleProtocolMessage:• -addSecurityManagers:forAppId:

Page 697: Documentation iOS SDLAbstractProtocol Class Reference

• +enableSiphonDebug• +disableSiphonDebug• -putFileStream:withRequest:

Overview

Undocumented

_version

Undocumented

_bulkSessionID

Undocumented

_isConnected

Undocumented

_alreadyDestructed

Undocumented

protocol

Undocumented

transport

Undocumented

Page 698: Documentation iOS SDLAbstractProtocol Class Reference

proxyListeners

Undocumented

startSessionTimer

Undocumented

debugConsoleGroupName

Undocumented

proxyVersion

Undocumented

streamingMediaManager

Undocumented

-initWithTransport:protocol:delegate:

Undocumented

-dispose

Undocumented

-addDelegate:

Undocumented

Page 699: Documentation iOS SDLAbstractProtocol Class Reference

-removeDelegate:

Undocumented

-sendRPC:

Undocumented

-sendRPCRequest:

Undocumented

-handleRPCDictionary:

Undocumented

-handleRpcMessage:

Undocumented

-handleProtocolMessage:

Undocumented

-addSecurityManagers:forAppId:

Undocumented

+enableSiphonDebug

Undocumented

Page 700: Documentation iOS SDLAbstractProtocol Class Reference

+disableSiphonDebug

Undocumented

-putFileStream:withRequest:

Puts data into a file on the module @abstract Performs a putFile for a given

input stream, performed in chunks, for handling very large files. - parameter:

inputStream A stream containing the data to put to the module. - parameter:

putFileRPCRequest A SDLPutFile object containing the parameters for the put(s)

@discussion The proxy will read from the stream based on the max MTU size

and send them in individual putFile requests. This may result in multiple

responses being received, one for each request. Note: the length parameter of

the putFileRPCRequest will be ignored. The proxy will substitute the number of

bytes read from the stream.

OBJECTIVE-C

- (void)putFileStream:(NSInputStream *)inputStream withRequest:(SDLPutFile *)putFileRPCRequest;

SWIFT

func putFileStream(_ inputStream: InputStream!, withRequest putFileRPCRequest: SDLPutFile!)

Page 701: Documentation iOS SDLAbstractProtocol Class Reference

inputStream

A stream containing the data to put to the module.

putFileRPCRequest

A SDLPutFile object containing the parameters for the put(s)

SDLProxyFactory Class Reference

Section Contents

• +buildSDLProxyWithListener:• +buildSDLProxyWithListener:tcpIPAddress:tcpPort:

Overview

Undocumented

+buildSDLProxyWithListener:

Undocumented

+buildSDLProxyWithListener:tcpIPAddress:tcpPort:

Undocumented

PARAMETERS

Page 702: Documentation iOS SDLAbstractProtocol Class Reference

SDLPutFile Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithFileName:fileType:• -initWithFileName:fileType:persistentFile:• -initWithFileName:fileType:persistentFile:systemFile:offset:length:• syncFileName• fileType• persistentFile• systemFile• offset• length

Overview

Used to push a binary data onto the SDL module from a mobile device, such as

icons and album art

Since SmartDeviceLink 2.0 - see: SDLDeleteFile - see: SDLListFiles

-init

Constructs a new SDLPutFile object

OBJECTIVE-C

- (instancetype)init;

Page 703: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLPutFile object indicated by the dictionary parameter

dict

The dictionary to use

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 704: Documentation iOS SDLAbstractProtocol Class Reference

-initWithFileName:fileType:

Undocumented

-initWithFileName:fileType:persistentFile:

Undocumented

-

initWithFileName:fileType:persistentFile:systemFile:offset:length:

Undocumented

OBJECTIVE-C

@interface SDLPutFile : SDLRPCRequest

OBJECTIVE-C

@interface SDLPutFile : SDLRPCRequest

Page 705: Documentation iOS SDLAbstractProtocol Class Reference

syncFileName

A file reference name

Required, maxlength 255 characters

fileType

A FileType value representing a selected file type

Required

OBJECTIVE-C

@interface SDLPutFile : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *syncFileName;

SWIFT

var syncFileName: String! { get set }

Page 706: Documentation iOS SDLAbstractProtocol Class Reference

persistentFile

A value to indicates if the file is meant to persist between sessions / ignition

cycles. If set to TRUE, then the system will aim to persist this file through

session / cycles. While files with this designation will have priority over others,

they are subject to deletion by the system at any time. In the event of

automatic deletion by the system, the app will receive a rejection and have to

resend the file. If omitted, the value will be set to false

Boolean, Optional, default = NO

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLFileType *fileType;

SWIFT

var fileType: SDLFileType! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *persistentFile;

Page 707: Documentation iOS SDLAbstractProtocol Class Reference

systemFile

Indicates if the file is meant to be passed through core to elsewhere on the

system. If set to TRUE, then the system will instead pass the data thru as it

arrives to a predetermined area outside of core.

Boolean, Optional, default = NO

offset

Offset in bytes for resuming partial data chunks.

SWIFT

var persistentFile: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *systemFile;

SWIFT

var systemFile: NSNumber! { get set }

Page 708: Documentation iOS SDLAbstractProtocol Class Reference

Integer, Optional, 0 - 100,000,000,000

length

Length in bytes for resuming partial data chunks. If offset is set to 0, then

length is the total length of the file to be downloaded

Integer, Optional, 0 - 100,000,000,000

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *offset;

SWIFT

var offset: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *length;

Page 709: Documentation iOS SDLAbstractProtocol Class Reference

SDLPutFileResponse Class Reference

Section Contents

• -init• -initWithDictionary:• spaceAvailable

Overview

Put File Response is sent, when SDLPutFile has been called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLPutFileResponse object

SWIFT

var length: NSNumber! { get set }

OBJECTIVE-C

- (instancetype)init;

Page 710: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLPutFileResponse object indicated by the

dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 711: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

spaceAvailable

Undocumented

SDLRPCMessage Class Reference

Section Contents

• function• parameters• messageType• -initWithName:• -initWithDictionary:• -getFunctionName• -setFunctionName:• -getParameters:• -setParameters:value:• bulkData• name• messageType

OBJECTIVE-C

@interface SDLPutFileResponse : SDLRPCResponse

Page 712: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

function

Undocumented

parameters

Undocumented

messageType

Undocumented

-initWithName:

Undocumented

-initWithDictionary:

Undocumented

-getFunctionName

Undocumented

-setFunctionName:

Undocumented

Page 713: Documentation iOS SDLAbstractProtocol Class Reference

-getParameters:

Undocumented

-setParameters:value:

Undocumented

bulkData

Undocumented

name

Undocumented

messageType

Undocumented

SDLRPCNotification Class Reference

Section Contents

• -initWithName:• -initWithDictionary:

Overview

Undocumented

Page 714: Documentation iOS SDLAbstractProtocol Class Reference

-initWithName:

Undocumented

-initWithDictionary:

Undocumented

SDLRPCNotificationNotification ClassReference

Section Contents

• notification• -initWithName:object:rpcNotification:

Overview

Undocumented

notification

Undocumented

-initWithName:object:rpcNotification:

Undocumented

Page 715: Documentation iOS SDLAbstractProtocol Class Reference

SDLRPCRequest Class Reference

Section Contents

• correlationID

Overview

Undocumented

correlationID

Undocumented

SDLRPCRequestFactory Class Reference

Section Contents

• +buildAddCommandWithID:menuName:parentID:position:vrCommands:iconValue:iconType:correlationID:• +buildAddCommandWithID:menuName:vrCommands:correlationID:• +buildAddCommandWithID:vrCommands:correlationID:• +buildAddCommandWithID:menuName:parentID:position:vrCommands:iconValue:iconType:handler:• +buildAddCommandWithID:menuName:vrCommands:handler:• +buildAddCommandWithID:vrCommands:handler:• +buildAddSubMenuWithID:menuName:position:correlationID:• +buildAddSubMenuWithID:menuName:correlationID:• +buildAlertWithTTS:alertText1:alertText2:alertText3:playTone:duration:correlationID:• +buildAlertWithTTS:alertText1:alertText2:playTone:duration:correlationID:• +buildAlertWithTTS:playTone:correlationID:• +buildAlertWithTTSChunks:alertText1:alertText2:alertText3:playTone:duration:softButtons:correlationID:

Page 716: Documentation iOS SDLAbstractProtocol Class Reference

• +buildAlertWithTTSChunks:playTone:correlationID:• +buildAlertWithAlertText1:alertText2:alertText3:duration:softButtons:correlationID:• +buildAlertWithAlertText1:alertText2:alertText3:duration:correlationID:• +buildAlertWithAlertText1:alertText2:duration:correlationID:• +buildAlertManeuverwithTTSchunks:softButtons:correlationID:• +buildChangeRegistrationWithLanguage:hmiDisplayLanguage:correlationID:• +buildCreateInteractionChoiceSetWithID:choiceSet:correlationID:• +buildDeleteCommandWithID:correlationID:• +buildDeleteFileWithName:correlationID:• +buildDialNumberWithNumber:• +buildListFilesWithCorrelationID:• +buildDeleteInteractionChoiceSetWithID:correlationID:• +buildDeleteSubMenuWithID:correlationID:• +buildEndAudioPassThruWithCorrelationID:• +buildGetDTCsWithECUName:correlationID:• +buildGetVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:instantFuelConsumption:externalTemper• +buildPerformAudioPassThruWithInitialPrompt:audioPassThruDisplayText1:audioPassThruDisplayText2:samp• +buildPerformInteractionWithInitialChunks:initialText:interactionChoiceSetIDList:helpChunks:timeoutChunks• +buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeoutPrompt:• +buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetID:vrHelp:correlationID:• +buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetIDList:helpPrompt:timeoutPrompt:• +buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetID:correlationID:• +buildPutFileWithFileName:fileType:persistentFile:correlationId:• +buildPutFileWithFileName:fileType:persisistentFile:correlationID:• +buildReadDIDWithECUName:didLocation:correlationID:• +buildRegisterAppInterfaceWithAppName:ttsName:vrSynonyms:isMediaApp:languageDesired:hmiDisplayLa• +buildRegisterAppInterfaceWithAppName:isMediaApp:languageDesired:appID:• +buildRegisterAppInterfaceWithAppName:languageDesired:appID:• +buildResetGlobalPropertiesWithProperties:correlationID:• +buildSendLocationWithLongitude:latitude:locationName:locationDescription:address:phoneNumber:image• +buildScrollableMessage:timeout:softButtons:correlationID:• +buildSetAppIconWithFileName:correlationID:• +buildSetDisplayLayout:correlationID:• +buildSetGlobalPropertiesWithHelpText:timeoutText:vrHelpTitle:vrHelp:correlationID:• +buildSetGlobalPropertiesWithHelpText:timeoutText:correlationID:• +buildSetMediaClockTimerWithHours:minutes:seconds:updateMode:correlationID:• +buildSetMediaClockTimerWithUpdateMode:correlationID:• +buildShowWithMainField1:mainField2:mainField3:mainField4:statusBar:mediaClock:mediaTrack:alignment:

Page 717: Documentation iOS SDLAbstractProtocol Class Reference

• +buildShowWithMainField1:mainField2:statusBar:mediaClock:mediaTrack:alignment:correlationID:• +buildShowWithMainField1:mainField2:alignment:correlationID:• +buildSliderDynamicFooterWithNumTicks:position:sliderHeader:sliderFooter:timeout:correlationID:• +buildSliderStaticFooterWithNumTicks:position:sliderHeader:sliderFooter:timeout:correlationID:• +buildSoftButtonWithType:text:image:highlighted:buttonID:systemAction:handler:• +buildSpeakWithTTSChunks:correlationID:• +buildSpeakWithTTS:correlationID:• +buildSubscribeButtonWithName:correlationID:• +buildSubscribeButtonWithName:handler:• +buildSubscribeVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:instantFuelConsumption:externalT• +buildShowConstantTBTWithString:navigationText2:eta:timeToDestination:totalDistance:turnIcon:nextTurnIc• +buildUnregisterAppInterfaceWithCorrelationID:• +buildUnsubscribeButtonWithName:correlationID:• +buildUnsubscribeVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:instantFuelConsumption:externa• +buildUpdateTurnListWithTurnList:softButtons:correlationID:

Overview

Undocumented

+buildAddCommandWithID:menuName:parentID:position:vrCommands:iconValu

Undocumented

+buildAddCommandWithID:menuName:vrCommands:correlationID:

Undocumented

+buildAddCommandWithID:vrCommands:correlationID:

Undocumented

+buildAddCommandWithID:menuName:parentID:position:vrCommands:iconValu

Undocumented

Page 718: Documentation iOS SDLAbstractProtocol Class Reference

+buildAddCommandWithID:menuName:vrCommands:handler:

Undocumented

+buildAddCommandWithID:vrCommands:handler:

Undocumented

+buildAddSubMenuWithID:menuName:position:correlationID:

Undocumented

+buildAddSubMenuWithID:menuName:correlationID:

Undocumented

+buildAlertWithTTS:alertText1:alertText2:alertText3:playTone:duration:correlat

Undocumented

+buildAlertWithTTS:alertText1:alertText2:playTone:duration:correlationID:

Undocumented

+buildAlertWithTTS:playTone:correlationID:

Undocumented

+buildAlertWithTTSChunks:alertText1:alertText2:alertText3:playTone:duration:s

Undocumented

Page 719: Documentation iOS SDLAbstractProtocol Class Reference

+buildAlertWithTTSChunks:playTone:correlationID:

Undocumented

+buildAlertWithAlertText1:alertText2:alertText3:duration:softButtons:correlatio

Undocumented

+buildAlertWithAlertText1:alertText2:alertText3:duration:correlationID:

Undocumented

+buildAlertWithAlertText1:alertText2:duration:correlationID:

Undocumented

+buildAlertManeuverwithTTSchunks:softButtons:correlationID:

Undocumented

+buildChangeRegistrationWithLanguage:hmiDisplayLanguage:correlationID:

Undocumented

+buildCreateInteractionChoiceSetWithID:choiceSet:correlationID:

Undocumented

+buildDeleteCommandWithID:correlationID:

Undocumented

Page 720: Documentation iOS SDLAbstractProtocol Class Reference

+buildDeleteFileWithName:correlationID:

Undocumented

+buildDialNumberWithNumber:

Undocumented

+buildListFilesWithCorrelationID:

Undocumented

+buildDeleteInteractionChoiceSetWithID:correlationID:

Undocumented

+buildDeleteSubMenuWithID:correlationID:

Undocumented

+buildEndAudioPassThruWithCorrelationID:

Undocumented

+buildGetDTCsWithECUName:correlationID:

Undocumented

+buildGetVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:instantFuelC

Undocumented

Page 721: Documentation iOS SDLAbstractProtocol Class Reference

+buildPerformAudioPassThruWithInitialPrompt:audioPassThruDisplayText1:aud

Undocumented

+buildPerformInteractionWithInitialChunks:initialText:interactionChoiceSetIDLis

Undocumented

+buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetIDLis

Undocumented

+buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetID:v

Undocumented

+buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetIDLis

Undocumented

+buildPerformInteractionWithInitialPrompt:initialText:interactionChoiceSetID:co

Undocumented

+buildPutFileWithFileName:fileType:persistentFile:correlationId:

Undocumented

+buildPutFileWithFileName:fileType:persisistentFile:correlationID:

Undocumented

Page 722: Documentation iOS SDLAbstractProtocol Class Reference

+buildReadDIDWithECUName:didLocation:correlationID:

Undocumented

+buildRegisterAppInterfaceWithAppName:ttsName:vrSynonyms:isMediaApp:lan

Undocumented

+buildRegisterAppInterfaceWithAppName:isMediaApp:languageDesired:appID:

Undocumented

+buildRegisterAppInterfaceWithAppName:languageDesired:appID:

Undocumented

+buildResetGlobalPropertiesWithProperties:correlationID:

Undocumented

+buildSendLocationWithLongitude:latitude:locationName:locationDescription:a

Undocumented

+buildScrollableMessage:timeout:softButtons:correlationID:

Undocumented

+buildSetAppIconWithFileName:correlationID:

Undocumented

Page 723: Documentation iOS SDLAbstractProtocol Class Reference

+buildSetDisplayLayout:correlationID:

Undocumented

+buildSetGlobalPropertiesWithHelpText:timeoutText:vrHelpTitle:vrHelp:correlat

Undocumented

+buildSetGlobalPropertiesWithHelpText:timeoutText:correlationID:

Undocumented

+buildSetMediaClockTimerWithHours:minutes:seconds:updateMode:correlation

Undocumented

+buildSetMediaClockTimerWithUpdateMode:correlationID:

Undocumented

+buildShowWithMainField1:mainField2:mainField3:mainField4:statusBar:media

Undocumented

+buildShowWithMainField1:mainField2:statusBar:mediaClock:mediaTrack:align

Undocumented

+buildShowWithMainField1:mainField2:alignment:correlationID:

Undocumented

Page 724: Documentation iOS SDLAbstractProtocol Class Reference

+buildSliderDynamicFooterWithNumTicks:position:sliderHeader:sliderFooter:tim

Undocumented

+buildSliderStaticFooterWithNumTicks:position:sliderHeader:sliderFooter:timeo

Undocumented

+buildSoftButtonWithType:text:image:highlighted:buttonID:systemAction:hand

Undocumented

+buildSpeakWithTTSChunks:correlationID:

Undocumented

+buildSpeakWithTTS:correlationID:

Undocumented

+buildSubscribeButtonWithName:correlationID:

Undocumented

+buildSubscribeButtonWithName:handler:

Undocumented

+buildSubscribeVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:instan

Undocumented

Page 725: Documentation iOS SDLAbstractProtocol Class Reference

+buildShowConstantTBTWithString:navigationText2:eta:timeToDestination:tota

Undocumented

+buildUnregisterAppInterfaceWithCorrelationID:

Undocumented

+buildUnsubscribeButtonWithName:correlationID:

Undocumented

+buildUnsubscribeVehicleDataWithGPS:speed:rpm:fuelLevel:fuelLevelState:inst

Undocumented

+buildUpdateTurnListWithTurnList:softButtons:correlationID:

Undocumented

SDLRPCResponse Class Reference

Section Contents

• correlationID• success• resultCode

Page 726: Documentation iOS SDLAbstractProtocol Class Reference

• info

Overview

Undocumented

correlationID

Undocumented

success

Undocumented

resultCode

Undocumented

info

Undocumented

SDLRPCResponseNotification ClassReference

Section Contents

• response

Page 727: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithName:object:rpcResponse:

Overview

Undocumented

response

Undocumented

-initWithName:object:rpcResponse:

Undocumented

SDLRPCStruct Class Reference

Section Contents

• store• -initWithDictionary:• -init• -serializeAsDictionary:

Overview

Undocumented

store

Undocumented

Page 728: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

-init

Undocumented

-serializeAsDictionary:

Undocumented

SDLReadDID Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithECUName:didLocation:• ecuName• didLocation

Overview

Non periodic vehicle data read request. This is an RPC to get diagnostics data

from certain vehicle modules. DIDs of a certain module might differ from

vehicle type to vehicle type

Function Group: ProprietaryData

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 2.0

Page 729: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLReadDID object

-initWithDictionary:

@abstract Constructs a new SDLReadDID object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 730: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithECUName:didLocation:

Undocumented

ecuName

@abstract An ID of the vehicle module

Notes: Minvalue:0; Maxvalue:65535

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLReadDID : SDLRPCRequest

Page 731: Documentation iOS SDLAbstractProtocol Class Reference

didLocation

@abstract Raw data from vehicle data DID location(s)

a Vector value representing raw data from vehicle data DID location(s)

Notes:

• Minvalue:0; Maxvalue:65535• ArrayMin:0; ArrayMax:1000

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *ecuName;

SWIFT

var ecuName: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *didLocation;

Page 732: Documentation iOS SDLAbstractProtocol Class Reference

SDLReadDIDResponse Class Reference

Section Contents

• -init• -initWithDictionary:• didResult

Overview

Read DID Response is sent, when ReadDID has been called

Since SmartDeviceLink 2.0

-init

Undocumented

SWIFT

var didLocation: NSMutableArray! { get set }

OBJECTIVE-C

@interface SDLReadDIDResponse : SDLRPCResponse

Page 733: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

didResult

Undocumented

SDLRegisterAppInterface ClassReference

Section Contents

• -init

OBJECTIVE-C

@interface SDLReadDIDResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLReadDIDResponse : SDLRPCResponse

Page 734: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -initWithLifecycleConfiguration:• -initWithAppName:appId:languageDesired:• -

initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:• -

initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:ttsName:vrSynonyms:hmiDis• syncMsgVersion• appName• ttsName• ngnMediaScreenAppName• vrSynonyms• isMediaApplication• languageDesired• hmiDisplayLanguageDesired• appHMIType• hashID• deviceInfo• appID• appInfo

Overview

Registers the application’s interface with SDL®, declaring properties of the

registration, including the messaging interface version, the app name, etc. The

mobile application must establish its interface registration with SDL before any

other interaction with SDL® can take place. The registration lasts until it is

terminated either by the application calling the SDLUnregisterAppInterface

method, or by SDL® sending an SDLOnAppInterfaceUnregistered notification,

or by loss of the underlying transport connection, or closing of the underlying

message transmission protocol RPC session

Until the application receives its first SDLOnHMIStatus Notification, its HMI

Status is assumed to be: SDLHMILevel=NONE, SDLAudioStreamingState

=NOT_AUDIBLE, SDLSystemContext=MAIN

All SDL® resources which the application creates or uses (e.g. Choice Sets,

Command Menu, etc.) are associated with the application’s interface

registration. Therefore, when the interface registration ends, the SDL®

Page 735: Documentation iOS SDLAbstractProtocol Class Reference

resources associated with the application are disposed of. As a result, even

though the application itself may continue to run on its host platform (e.g.

mobile device) after the interface registration terminates, the application will

not be able to use the SDL® HMI without first establishing a new interface

registration and re-creating its required SDL® resources. That is, SDL®

resources created by (or on behalf of) an application do not persist beyond the

life-span of the interface registration

Resources and settings whose lifespan is tied to the duration of an application’s

interface registration:

• Choice Sets• Command Menus (built by successive calls to SDLAddCommand )• Media clock timer display value• Media clock timer display value• Media clock timer display value

The autoActivateID is used to grant an application the HMILevel and

AudioStreamingState it had when it last disconnected

Notes: The autoActivateID parameter, and associated behavior, is currently

ignored by SDL®

When first calling this method (i.e. first time within life cycle of mobile app), an

autoActivateID should not be included. After successfully registering an

interface, an autoActivateID is returned to the mobile application for it to use in

subsequent connections. If the connection between SDL® and the mobile

application is lost, such as the vehicle is turned off while the application is

running, the autoActivateID can then be passed in another call to

RegisterAppInterface to re-acquire SDLHMILevel=FULL

If the application intends to stream audio it is important to indicate so via the

isMediaApp parameter. When set to true, audio will reliably stream without any

configuration required by the user. When not set, audio may stream, depending

on what the user might have manually configured as a media source on SDL®

There is no time limit for how long the autoActivateID is “valid” (i.e. would

confer focus and opt-in)

HMILevel is not defined before registering

@since SDL 1.0

Page 736: Documentation iOS SDLAbstractProtocol Class Reference

SeeSDLUnregisterAppInterface SDLOnAppInterfaceUnregistered

-init

@abstract Constructs a new SDLRegisterAppInterface object

-initWithDictionary:

@abstract Constructs a new SDLRegisterAppInterface object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 737: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithLifecycleConfiguration:

Undocumented

-initWithAppName:appId:languageDesired:

Undocumented

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLRegisterAppInterface : SDLRPCRequest

Page 738: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:

Undocumented

-

initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:t

Undocumented

OBJECTIVE-C

@interface SDLRegisterAppInterface : SDLRPCRequest

OBJECTIVE-C

@interface SDLRegisterAppInterface : SDLRPCRequest

OBJECTIVE-C

@interface SDLRegisterAppInterface : SDLRPCRequest

Page 739: Documentation iOS SDLAbstractProtocol Class Reference

syncMsgVersion

@abstract The version of the SDL interface

Required

appName

@abstract The Mobile Application’s Name, This name is displayed in the SDL

Mobile Applications menu. It also serves as the unique identifier of the

application for SmartDeviceLink

@discussion • Needs to be unique over all applications.• May not be empty.• May not start with a new line character.• May not interfere with any name or synonym of previously registered

applications and any predefined blacklist of words (global commands).• Needs to be unique over all applications. Applications with the same name will

be rejected.

Required, Max length 100 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSyncMsgVersion *syncMsgVersion;

SWIFT

var syncMsgVersion: SDLSyncMsgVersion! { get set }

Page 740: Documentation iOS SDLAbstractProtocol Class Reference

ttsName

@abstract TTS string for VR recognition of the mobile application name.

@discussion Meant to overcome any failing on speech engine in properly

pronouncing / understanding app name. • Needs to be unique over all applications.• May not be empty.• May not start with a new line character.

Optional, Array of SDLTTSChunk, Array size 1 - 100

@since SDL 2.0 - see: SDLTTSChunk

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *appName;

SWIFT

var appName: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *ttsName;

Page 741: Documentation iOS SDLAbstractProtocol Class Reference

ngnMediaScreenAppName

@abstract A String representing an abbreviated version of the mobile

application’s name (if necessary) that will be displayed on the media screen

@discussion If not provided, the appName is used instead (and will be

truncated if too long)

Optional, Max length 100 chars

SWIFT

var ttsName: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *ngnMediaScreenAppName;

SWIFT

var ngnMediaScreenAppName: String! { get set }

Page 742: Documentation iOS SDLAbstractProtocol Class Reference

vrSynonyms

@abstract Defines a additional voice recognition commands

@discussion May not interfere with any app name of previously registered

applications and any predefined blacklist of words (global commands)

Optional, Array of Strings, Array length 1 - 100, Max String length 40

isMediaApplication

@abstract Indicates if the application is a media or a non-media application.

@discussion Only media applications will be able to stream audio to head units

that is audible outside of the BT media source.

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrSynonyms;

SWIFT

var vrSynonyms: NSMutableArray! { get set }

Page 743: Documentation iOS SDLAbstractProtocol Class Reference

languageDesired

@abstract A Language enumeration indicating what language the application

intends to use for user interaction (TTS and VR).

@discussion If there is a mismatch with the head unit, the app will be able to

change this registration with changeRegistration prior to app being brought into

focus.

Required

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *isMediaApplication;

SWIFT

var isMediaApplication: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *languageDesired;

Page 744: Documentation iOS SDLAbstractProtocol Class Reference

hmiDisplayLanguageDesired

@abstract An enumeration indicating what language the application intends to

use for user interaction (Display).

@discussion If there is a mismatch with the head unit, the app will be able to

change this registration with changeRegistration prior to app being brought into

focus.

Required

@since SDL 2.0

SWIFT

var languageDesired: SDLLanguage! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *hmiDisplayLanguageDesired;

SWIFT

var hmiDisplayLanguageDesired: SDLLanguage! { get set }

Page 745: Documentation iOS SDLAbstractProtocol Class Reference

appHMIType

@abstract A list of all applicable app types stating which classifications to be

given to the app.

Optional, Array of SDLAppHMIType, Array size 1 - 100

@since SDL 2.0 - see: SDLAppHMIType

hashID

@abstract ID used to uniquely identify current state of all app data that can

persist through connection cycles (e.g. ignition cycles).

@discussion This registered data (commands, submenus, choice sets, etc.) can

be reestablished without needing to explicitly reregister each piece. If omitted,

then the previous state of an app’s commands, etc. will not be restored.

When sending hashID, all RegisterAppInterface parameters should still be

provided (e.g. ttsName, etc.).

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *appHMIType;

SWIFT

var appHMIType: NSMutableArray! { get set }

Page 746: Documentation iOS SDLAbstractProtocol Class Reference

Optional, max length 100 chars

deviceInfo

@abstract Information about the connecting device

Optional

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *hashID;

SWIFT

var hashID: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDeviceInfo *deviceInfo;

Page 747: Documentation iOS SDLAbstractProtocol Class Reference

appID

@abstract ID used to validate app with policy table entries

Required, max length 100

@since SDL 2.0

appInfo

@abstract Information about the application running

SWIFT

var deviceInfo: SDLDeviceInfo! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *appID;

SWIFT

var appID: String! { get set }

Page 748: Documentation iOS SDLAbstractProtocol Class Reference

Optional

SDLRegisterAppInterfaceResponseClass Reference

Section Contents

• -init• -initWithDictionary:• syncMsgVersion• language• hmiDisplayLanguage• displayCapabilities• buttonCapabilities• softButtonCapabilities• presetBankCapabilities

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLAppInfo *appInfo;

SWIFT

var appInfo: SDLAppInfo! { get set }

Page 749: Documentation iOS SDLAbstractProtocol Class Reference

• hmiZoneCapabilities• speechCapabilities• prerecordedSpeech• vrCapabilities• audioPassThruCapabilities• vehicleType• supportedDiagModes• hmiCapabilities• sdlVersion• systemSoftwareVersion

Overview

@abstract Register AppInterface Response is sent, when

SDLRegisterAppInterface has been called

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLRegisterAppInterfaceResponse object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 750: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Constructs a new SDLRegisterAppInterfaceResponse object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

The dictionary to use

syncMsgVersion

SeeSDLSyncMsgVersion Optional

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 751: Documentation iOS SDLAbstractProtocol Class Reference

language

The currently active VR+TTS language on Sync.

SeeSDLLanguage Optional

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSyncMsgVersion *syncMsgVersion;

SWIFT

var syncMsgVersion: SDLSyncMsgVersion! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *language;

Page 752: Documentation iOS SDLAbstractProtocol Class Reference

hmiDisplayLanguage

The currently active display language on Sync

SeeSDLLanguage @since SmartDeviceLink 2.0 Optional

displayCapabilities

SeeSDLDisplayCapabilities

SWIFT

var language: SDLLanguage! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLLanguage *hmiDisplayLanguage;

SWIFT

var hmiDisplayLanguage: SDLLanguage! { get set }

Page 753: Documentation iOS SDLAbstractProtocol Class Reference

Optional

buttonCapabilities

SeeSDLButtonCapabilities Optional, Array of length 1 - 100, of SDLButtonCapabilities

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLDisplayCapabilities *displayCapabilities;

SWIFT

var displayCapabilities: SDLDisplayCapabilities! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *buttonCapabilities;

Page 754: Documentation iOS SDLAbstractProtocol Class Reference

softButtonCapabilities

If returned, the platform supports on-screen SoftButtons

SeeSDLSoftButtonCapabilities Optional, Array of length 1 - 100, of SDLSoftButtonCapabilities

presetBankCapabilities

If returned, the platform supports custom on-screen Presets

See

SWIFT

var buttonCapabilities: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *softButtonCapabilities;

SWIFT

var softButtonCapabilities: NSMutableArray! { get set }

Page 755: Documentation iOS SDLAbstractProtocol Class Reference

SDLPresetBankCapabilities Optional

hmiZoneCapabilities

SeeSDLHMIZoneCapabilities Optional, Array of length 1 - 100, of SDLHMIZoneCapabilities

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLPresetBankCapabilities *presetBankCapabilities;

SWIFT

var presetBankCapabilities: SDLPresetBankCapabilities! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *hmiZoneCapabilities;

Page 756: Documentation iOS SDLAbstractProtocol Class Reference

speechCapabilities

SeeSDLSpeechCapabilities Optional, Array of length 1 - 100, of SDLSpeechCapabilities

prerecordedSpeech

SeeSDLPrerecordedSpeech Optional, Array of length 1 - 100, of SDLPrerecordedSpeech

SWIFT

var hmiZoneCapabilities: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *speechCapabilities;

SWIFT

var speechCapabilities: NSMutableArray! { get set }

Page 757: Documentation iOS SDLAbstractProtocol Class Reference

vrCapabilities

SeeSDLVRCapabilities Optional, Array of length 1 - 100, of SDLVRCapabilities

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *prerecordedSpeech;

SWIFT

var prerecordedSpeech: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrCapabilities;

Page 758: Documentation iOS SDLAbstractProtocol Class Reference

audioPassThruCapabilities

SeeSDLAudioPassThruCapabilities Optional, Array of length 1 - 100, of SDLAudioPassThruCapabilities

vehicleType

Specifies the vehicle’s type

SeeSDLVehicleType

SWIFT

var vrCapabilities: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *audioPassThruCapabilities;

SWIFT

var audioPassThruCapabilities: NSMutableArray! { get set }

Page 759: Documentation iOS SDLAbstractProtocol Class Reference

Optional, Array of length 1 - 100, of SDLVehicleType

supportedDiagModes

Specifies the white-list of supported diagnostic modes (0x00-0xFF) capable for

DiagnosticMessage requests. If a mode outside this list is requested, it will be

rejected.

Optional, Array of length 1 - 100, Integer 0 - 255

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleType *vehicleType;

SWIFT

var vehicleType: SDLVehicleType! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *supportedDiagModes;

Page 760: Documentation iOS SDLAbstractProtocol Class Reference

hmiCapabilities

SeeSDLHMICapabilities Optional

sdlVersion

The SmartDeviceLink version

Optional, String max length 100

SWIFT

var supportedDiagModes: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLHMICapabilities *hmiCapabilities;

SWIFT

var hmiCapabilities: SDLHMICapabilities! { get set }

Page 761: Documentation iOS SDLAbstractProtocol Class Reference

systemSoftwareVersion

The software version of the system that implements the SmartDeviceLink core

Optional, String max length 100

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *sdlVersion;

SWIFT

var sdlVersion: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *systemSoftwareVersion;

Page 762: Documentation iOS SDLAbstractProtocol Class Reference

SDLRequestType Class Reference

Section Contents

• +valueOf:• +values• +HTTP• +FILE_RESUME• +AUTH_REQUEST• +AUTH_CHALLENGE• +AUTH_ACK• +PROPRIETARY• +QUERY_APPS• +LAUNCH_APP• +LOCK_SCREEN_ICON_URL• +TRAFFIC_MESSAGE_CHANNEL• +DRIVER_PROFILE• +VOICE_SEARCH• +NAVIGATION• +PHONE• +CLIMATE• +SETTINGS• +VEHICLE_DIAGNOSTICS• +EMERGENCY• +MEDIA

SWIFT

var systemSoftwareVersion: String! { get set }

Page 763: Documentation iOS SDLAbstractProtocol Class Reference

• +FOTA

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+HTTP

Undocumented

+FILE_RESUME

Undocumented

+AUTH_REQUEST

Undocumented

+AUTH_CHALLENGE

Undocumented

+AUTH_ACK

Undocumented

Page 764: Documentation iOS SDLAbstractProtocol Class Reference

+PROPRIETARY

Undocumented

+QUERY_APPS

Undocumented

+LAUNCH_APP

Undocumented

+LOCK_SCREEN_ICON_URL

Undocumented

+TRAFFIC_MESSAGE_CHANNEL

Undocumented

+DRIVER_PROFILE

Undocumented

+VOICE_SEARCH

Undocumented

+NAVIGATION

Undocumented

Page 765: Documentation iOS SDLAbstractProtocol Class Reference

+PHONE

Undocumented

+CLIMATE

Undocumented

+SETTINGS

Undocumented

+VEHICLE_DIAGNOSTICS

Undocumented

+EMERGENCY

Undocumented

+MEDIA

Undocumented

+FOTA

Undocumented

Page 766: Documentation iOS SDLAbstractProtocol Class Reference

SDLResetGlobalProperties ClassReference

Section Contents

• -init• -initWithDictionary:• -initWithProperties:• properties

Overview

Resets the passed global properties to their default values as defined by SDL

The HELPPROMPT global property default value is generated by SDL consists of

the first vrCommand of each Command Menu item defined at the moment PTT

is pressed

The TIMEOUTPROMPT global property default value is the same as the

HELPPROMPT global property default value

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 1.0 See SetGlobalProperties

-init

@abstract Constructs a new SDLResetGlobalProperties object

OBJECTIVE-C

- (instancetype)init;

Page 767: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLResetGlobalProperties object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 768: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-initWithProperties:

Undocumented

properties

@abstract An array of one or more GlobalProperty enumeration elements

indicating which global properties to reset to their default value

OBJECTIVE-C

@interface SDLResetGlobalProperties : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *properties;

SWIFT

var properties: NSMutableArray! { get set }

Page 769: Documentation iOS SDLAbstractProtocol Class Reference

SDLResetGlobalPropertiesResponseClass Reference

Section Contents

• -init• -initWithDictionary:

Overview

Reset Global Properties Response is sent, when SDLResetGlobalProperties has

been called

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLResetGlobalPropertiesResponse object

OBJECTIVE-C

- (instancetype)init;

Page 770: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLResetGlobalPropertiesResponse object

indicated by the NSMutableDictionary parameter - parameter: dict The

dictionary to use

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 771: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLResult Class Reference

Section Contents

• +valueOf:• +values• +SUCCESS• +INVALID_DATA• +CHAR_LIMIT_EXCEEDED• +UNSUPPORTED_REQUEST• +OUT_OF_MEMORY• +TOO_MANY_PENDING_REQUESTS• +INVALID_ID• +DUPLICATE_NAME• +TOO_MANY_APPLICATIONS• +APPLICATION_REGISTERED_ALREADY• +UNSUPPORTED_VERSION• +WRONG_LANGUAGE• +APPLICATION_NOT_REGISTERED• +IN_USE• +VEHICLE_DATA_NOT_ALLOWED• +VEHICLE_DATA_NOT_AVAILABLE• +REJECTED• +ABORTED

PARAMETERS

Page 772: Documentation iOS SDLAbstractProtocol Class Reference

• +IGNORED• +UNSUPPORTED_RESOURCE• +FILE_NOT_FOUND• +GENERIC_ERROR• +DISALLOWED• +USER_DISALLOWED• +TIMED_OUT• +CANCEL_ROUTE• +TRUNCATED_DATA• +RETRY• +WARNINGS• +SAVED• +INVALID_CERT• +EXPIRED_CERT• +RESUME_FAILED

Overview

Defines the possible result codes returned by SDL to the application in a

response to a requested operation

@since SDL 1.0

+valueOf:

@abstract get SDLResult according value string - parameter: value The value of

the string to get an object for - returns: SDLResult object

OBJECTIVE-C

+ (SDLResult *)valueOf:(NSString *)value;

Page 773: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLResult object

+values

@abstract declare an array to store all possible SDLResult values - returns: the

array

SWIFT

class func value(of value: String!) -> SDLResult!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 774: Documentation iOS SDLAbstractProtocol Class Reference

the array

+SUCCESS

@abstract The request succeeded

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLResult *)SUCCESS;

SWIFT

class func success() -> SDLResult!

Page 775: Documentation iOS SDLAbstractProtocol Class Reference

+INVALID_DATA

@abstract Result code : Invalid Data

@discussion The data sent is invalid. For example: • Invalid Json syntax• Parameters out of bounds (number or enum range)• Mandatory parameters not provided• Parameter provided with wrong type• Invalid characters• Empty string

+CHAR_LIMIT_EXCEEDED

Undocumented

OBJECTIVE-C

+ (SDLResult *)INVALID_DATA;

SWIFT

class func invalid_DATA() -> SDLResult!

Page 776: Documentation iOS SDLAbstractProtocol Class Reference

+UNSUPPORTED_REQUEST

@abstract The request is not supported by SDL

+OUT_OF_MEMORY

@abstract The system could not process the request because the necessary

memory couldn’t be allocated

OBJECTIVE-C

@interface SDLResult : SDLEnum

OBJECTIVE-C

+ (SDLResult *)UNSUPPORTED_REQUEST;

SWIFT

class func unsupported_REQUEST() -> SDLResult!

Page 777: Documentation iOS SDLAbstractProtocol Class Reference

+TOO_MANY_PENDING_REQUESTS

@abstract There are too many requests pending (means that the response has

not been delivered yet).

@discussion There is a limit of 1000 pending requests at a time.

OBJECTIVE-C

+ (SDLResult *)OUT_OF_MEMORY;

SWIFT

class func out_OF_MEMORY() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)TOO_MANY_PENDING_REQUESTS;

Page 778: Documentation iOS SDLAbstractProtocol Class Reference

+INVALID_ID

@abstract One of the provided IDs is not valid. @discussion For example: • CorrelationID• CommandID• MenuID

+DUPLICATE_NAME

@abstract The provided name or synonym is a duplicate of some already-

defined name or synonym.

SWIFT

class func too_MANY_PENDING_REQUESTS() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)INVALID_ID;

SWIFT

class func invalid_ID() -> SDLResult!

Page 779: Documentation iOS SDLAbstractProtocol Class Reference

+TOO_MANY_APPLICATIONS

There are already too many registered applications.

OBJECTIVE-C

+ (SDLResult *)DUPLICATE_NAME;

SWIFT

class func duplicate_NAME() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)TOO_MANY_APPLICATIONS;

SWIFT

class func too_MANY_APPLICATIONS() -> SDLResult!

Page 780: Documentation iOS SDLAbstractProtocol Class Reference

+APPLICATION_REGISTERED_ALREADY

RegisterApplication has been called again, after a RegisterApplication was

successful before.

+UNSUPPORTED_VERSION

The Head Unit doesn’t support the protocol that is requested by the mobile

application.

OBJECTIVE-C

+ (SDLResult *)APPLICATION_REGISTERED_ALREADY;

SWIFT

class func application_REGISTERED_ALREADY() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)UNSUPPORTED_VERSION;

Page 781: Documentation iOS SDLAbstractProtocol Class Reference

+WRONG_LANGUAGE

The requested language is currently not supported. Might be because of a

mismatch of the currently active language on the head unit and the requested

language.

+APPLICATION_NOT_REGISTERED

A command can not be executed because no application has been registered

with RegisterApplication.

SWIFT

class func unsupported_VERSION() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)WRONG_LANGUAGE;

SWIFT

class func wrong_LANGUAGE() -> SDLResult!

Page 782: Documentation iOS SDLAbstractProtocol Class Reference

+IN_USE

The data may not be changed, because it is currently in use. For example when

trying to delete a command set that is currently involved in an interaction.

OBJECTIVE-C

+ (SDLResult *)APPLICATION_NOT_REGISTERED;

SWIFT

class func application_NOT_REGISTERED() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)IN_USE;

SWIFT

class func in_USE() -> SDLResult!

Page 783: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLE_DATA_NOT_ALLOWED

The user has turned off access to vehicle data, and it is globally unavailable to

mobile applications.

+VEHICLE_DATA_NOT_AVAILABLE

The requested vehicle data is not available on this vehicle or is not published.

OBJECTIVE-C

+ (SDLResult *)VEHICLE_DATA_NOT_ALLOWED;

SWIFT

class func vehicle_DATA_NOT_ALLOWED() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)VEHICLE_DATA_NOT_AVAILABLE;

Page 784: Documentation iOS SDLAbstractProtocol Class Reference

+REJECTED

The requested command was rejected, e.g. because mobile app is in

background and cannot perform any HMI commands. Or an HMI command (e.g.

Speak) is rejected because a higher priority HMI command (e.g. Alert) is

playing.

SWIFT

class func vehicle_DATA_NOT_AVAILABLE() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)REJECTED;

SWIFT

class func rejected() -> SDLResult!

Page 785: Documentation iOS SDLAbstractProtocol Class Reference

+ABORTED

A command was aborted, for example due to user interaction (e.g. user pressed

button). Or an HMI command (e.g. Speak) is aborted because a higher priority

HMI command (e.g. Alert) was requested.

+IGNORED

A command was ignored, because the intended result is already in effect. For

example, SetMediaClockTimer was used to pause the media clock although the

clock is paused already.

OBJECTIVE-C

+ (SDLResult *)ABORTED;

SWIFT

class func aborted() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)IGNORED;

Page 786: Documentation iOS SDLAbstractProtocol Class Reference

+UNSUPPORTED_RESOURCE

A button that was requested for subscription is not supported under the current

system.

+FILE_NOT_FOUND

A specified file could not be found on the head unit.

SWIFT

class func ignored() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)UNSUPPORTED_RESOURCE;

SWIFT

class func unsupported_RESOURCE() -> SDLResult!

Page 787: Documentation iOS SDLAbstractProtocol Class Reference

+GENERIC_ERROR

Provided data is valid but something went wrong in the lower layers.

OBJECTIVE-C

+ (SDLResult *)FILE_NOT_FOUND;

SWIFT

class func file_NOT_FOUND() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)GENERIC_ERROR;

SWIFT

class func generic_ERROR() -> SDLResult!

Page 788: Documentation iOS SDLAbstractProtocol Class Reference

+DISALLOWED

RPC is not authorized in local policy table.

+USER_DISALLOWED

RPC is included in a functional group explicitly blocked by the user.

OBJECTIVE-C

+ (SDLResult *)DISALLOWED;

SWIFT

class func disallowed() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)USER_DISALLOWED;

Page 789: Documentation iOS SDLAbstractProtocol Class Reference

+TIMED_OUT

Overlay reached the maximum timeout and closed.

+CANCEL_ROUTE

User selected to Cancel Route.

SWIFT

class func user_DISALLOWED() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)TIMED_OUT;

SWIFT

class func timed_OUT() -> SDLResult!

Page 790: Documentation iOS SDLAbstractProtocol Class Reference

+TRUNCATED_DATA

The RPC (e.g. ReadDID) executed successfully but the data exceeded the

platform maximum threshold and thus, only part of the data is available.

OBJECTIVE-C

+ (SDLResult *)CANCEL_ROUTE;

SWIFT

class func cancel_ROUTE() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)TRUNCATED_DATA;

SWIFT

class func truncated_DATA() -> SDLResult!

Page 791: Documentation iOS SDLAbstractProtocol Class Reference

+RETRY

The user interrupted the RPC (e.g. PerformAudioPassThru) and indicated to

start over. Note, the app must issue the new RPC.

+WARNINGS

The RPC (e.g. SubscribeVehicleData) executed successfully but one or more

items have a warning or failure.

OBJECTIVE-C

+ (SDLResult *)RETRY;

SWIFT

class func retry() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)WARNINGS;

Page 792: Documentation iOS SDLAbstractProtocol Class Reference

+SAVED

The RPC (e.g. Slider) executed successfully and the user elected to save the

current position / value.

+INVALID_CERT

The certificate provided during authentication is invalid.

SWIFT

class func warnings() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)SAVED;

SWIFT

class func saved() -> SDLResult!

Page 793: Documentation iOS SDLAbstractProtocol Class Reference

+EXPIRED_CERT

The certificate provided during authentication is expired.

OBJECTIVE-C

+ (SDLResult *)INVALID_CERT;

SWIFT

class func invalid_CERT() -> SDLResult!

OBJECTIVE-C

+ (SDLResult *)EXPIRED_CERT;

SWIFT

class func expired_CERT() -> SDLResult!

Page 794: Documentation iOS SDLAbstractProtocol Class Reference

+RESUME_FAILED

The provided hash ID does not match the hash of the current set of registered

data or the core could not resume the previous data.

SDLSamplingRate Class Reference

Section Contents

• +valueOf:• +values• +_8KHZ• +_16KHZ• +_22KHZ• +_44KHZ

OBJECTIVE-C

+ (SDLResult *)RESUME_FAILED;

SWIFT

class func resume_FAILED() -> SDLResult!

Page 795: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Describes different sampling rates for PerformAudioPassThru

@since SDL 2.0

+valueOf:

@abstract get SDLSamplingRate according value string

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLSamplingRate *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLSamplingRate!

PARAMETERS

Page 796: Documentation iOS SDLAbstractProtocol Class Reference

SDLSamplingRate object

+values

@abstract declare an array to store all possible SDLSamplingRate values

the array

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 797: Documentation iOS SDLAbstractProtocol Class Reference

+_8KHZ

@abstract Sampling rate of 8 kHz

SamplingRate of 8KHZ

+_16KHZ

@abstract Sampling rate of 16 kHz

OBJECTIVE-C

+ (SDLSamplingRate *)_8KHZ;

SWIFT

class func _8KHZ() -> SDLSamplingRate!

RETURN VALUE

Page 798: Documentation iOS SDLAbstractProtocol Class Reference

SamplingRate of 16KHZ

+_22KHZ

@abstract Sampling rate of 22 kHz

OBJECTIVE-C

+ (SDLSamplingRate *)_16KHZ;

SWIFT

class func _16KHZ() -> SDLSamplingRate!

RETURN VALUE

OBJECTIVE-C

+ (SDLSamplingRate *)_22KHZ;

Page 799: Documentation iOS SDLAbstractProtocol Class Reference

SamplingRate of 22KHZ

+_44KHZ

@abstract Sampling rate of 44 kHz

SWIFT

class func _22KHZ() -> SDLSamplingRate!

RETURN VALUE

OBJECTIVE-C

+ (SDLSamplingRate *)_44KHZ;

SWIFT

class func _44KHZ() -> SDLSamplingRate!

Page 800: Documentation iOS SDLAbstractProtocol Class Reference

SamplingRate of 44KHZ

SDLScreenParams Class Reference

Section Contents

• -init• -initWithDictionary:• resolution• touchEventAvailable

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

resolution

Undocumented

RETURN VALUE

Page 801: Documentation iOS SDLAbstractProtocol Class Reference

touchEventAvailable

Undocumented

SDLScrollableMessage Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithMessage:• -initWithMessage:timeout:softButtons:• scrollableMessageBody• timeout• softButtons

Overview

Creates a full screen overlay containing a large block of formatted text that can

be scrolled with up to 8 SoftButtons defined

Function Group: ScrollableMessage

HMILevel needs to be FULL

-init

@abstract Constructs a new SDLScrollableMessage object

Page 802: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLScrollableMessage object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 803: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithMessage:

Undocumented

-initWithMessage:timeout:softButtons:

Undocumented

PARAMETERS

OBJECTIVE-C

@interface SDLScrollableMessage : SDLRPCRequest

OBJECTIVE-C

@interface SDLScrollableMessage : SDLRPCRequest

Page 804: Documentation iOS SDLAbstractProtocol Class Reference

scrollableMessageBody

@abstract A Body of text that can include newlines and tabs @discussion A

String value representing the Body of text that can include newlines and tabs

Notes: Maxlength=500

timeout

@abstract Gets/Sets an App defined timeout. Indicates how long of a timeout in

milliseconds from the last action @discussion An Integer value representing an

App defined timeout in milliseconds

Notes:Minval=0; Maxval=65535;Default=30000

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *scrollableMessageBody;

SWIFT

var scrollableMessageBody: String! { get set }

Page 805: Documentation iOS SDLAbstractProtocol Class Reference

softButtons

@abstract Gets/Sets App defined SoftButtons.If omitted on supported displays,

only the system defined “Close” SoftButton will be displayed @discussion A

Vector value representing App defined SoftButtons

Notes: Minsize=0, Maxsize=8

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *timeout;

SWIFT

var timeout: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *softButtons;

Page 806: Documentation iOS SDLAbstractProtocol Class Reference

SDLScrollableMessageResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Scrollable Message Response is sent, when SDLScrollableMessage has been

called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLScrollableMessageResponse object

SWIFT

var softButtons: NSMutableArray! { get set }

Page 807: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLScrollableMessageResponse object indicated

by the NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 808: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLSendLocation Class Reference

Section Contents

• -

initWithLongitude:latitude:locationName:locationDescription:address:phoneNumber:image:• -

initWithLongitude:latitude:locationName:locationDescription:displayAddressLines:phoneNumber:image:deliv• longitudeDegrees• latitudeDegrees• locationName• locationDescription• addressLines• phoneNumber• locationImage• deliveryMode• timeStamp• address

Overview

Undocumented

PARAMETERS

Page 809: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithLongitude:latitude:locationName:locationDescription:address:phoneNum

Undocumented

-

initWithLongitude:latitude:locationName:locationDescription:displayAddressLin

Undocumented

longitudeDegrees

The longitudinal coordinate of the location.

Float, Required, -180.0 - 180.0

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLFloat> *longitudeDegrees;

SWIFT

@NSCopying var longitudeDegrees: NSNumber! { get set }

Page 810: Documentation iOS SDLAbstractProtocol Class Reference

latitudeDegrees

The latitudinal coordinate of the location.

Float, Required, -90.0 - 90.0

locationName

Name / title of intended location

Optional, Maxlength = 500 char

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSNumber<SDLFloat> *latitudeDegrees;

SWIFT

@NSCopying var latitudeDegrees: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *locationName;

Page 811: Documentation iOS SDLAbstractProtocol Class Reference

locationDescription

Description of the intended location / establishment

Optional, MaxLength = 500 char

addressLines

Location address for display purposes only

Contains String, Optional, Max Array Length = 4, Max String Length = 500

SWIFT

var locationName: String! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *locationDescription;

SWIFT

var locationDescription: String! { get set }

Page 812: Documentation iOS SDLAbstractProtocol Class Reference

phoneNumber

Phone number of intended location / establishment

Optional, Max Length = 500

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSArray<NSString *> *addressLines;

SWIFT

var addressLines: [String]! { get set }

OBJECTIVE-C

@property (readwrite, copy, nonatomic) NSString *phoneNumber;

Page 813: Documentation iOS SDLAbstractProtocol Class Reference

locationImage

Image / icon of intended location

Optional

deliveryMode

Mode in which the sendLocation request is sent

Optional

SWIFT

var phoneNumber: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLImage *locationImage;

SWIFT

var locationImage: SDLImage! { get set }

Page 814: Documentation iOS SDLAbstractProtocol Class Reference

timeStamp

Arrival time of Location. If multiple SendLocations are sent, this will be used for

sorting as well.

Optional

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLDeliveryMode *deliveryMode;

SWIFT

var deliveryMode: SDLDeliveryMode! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLDateTime *timeStamp;

Page 815: Documentation iOS SDLAbstractProtocol Class Reference

address

Address to be used for setting destination

Optional

SWIFT

var timeStamp: SDLDateTime! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic) SDLOasisAddress *address;

SWIFT

var address: SDLOasisAddress! { get set }

Page 816: Documentation iOS SDLAbstractProtocol Class Reference

SDLSendLocationResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

SDLSetAppIcon Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithFileName:• syncFileName

Page 817: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Used to set existing local file on SDL as the app’s icon. Not supported on first

generation SDL modules.

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLSetAppIcon object

-initWithDictionary:

@abstract Constructs a new SDLSetAppIcon object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 818: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithFileName:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLSetAppIcon : SDLRPCRequest

Page 819: Documentation iOS SDLAbstractProtocol Class Reference

syncFileName

@abstract A file reference name @discussion A String value representing a file

reference name

Notes: Maxlength=500

SDLSetAppIconResponse ClassReference

Section Contents

• -init• -initWithDictionary:

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *syncFileName;

SWIFT

var syncFileName: String! { get set }

Page 820: Documentation iOS SDLAbstractProtocol Class Reference

Overview

SDLSetAppIconResponse is sent, when SDLSetAppIcon has been called. * Since

SmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLSetAppIconResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSetAppIconResponse : SDLRPCResponse

Page 821: Documentation iOS SDLAbstractProtocol Class Reference

SDLSetDisplayLayout Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithPredefinedLayout:• -initWithLayout:• displayLayout

Overview

Used to set an alternate display layout. If not sent, default screen for given

platform will be shown

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLSetDisplayLayout object

OBJECTIVE-C

- (instancetype)init;

Page 822: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSetDisplayLayout object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 823: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-initWithPredefinedLayout:

Undocumented

-initWithLayout:

Undocumented

displayLayout

@abstract A display layout. Predefined or dynamically created screen layout.

Currently only predefined screen layouts are defined. Predefined layouts

include: “ONSCREEN_PRESETS” Custom screen containing app-defined

onscreen presets. Currently defined for GEN2

OBJECTIVE-C

@interface SDLSetDisplayLayout : SDLRPCRequest

OBJECTIVE-C

@interface SDLSetDisplayLayout : SDLRPCRequest

Page 824: Documentation iOS SDLAbstractProtocol Class Reference

SDLSetDisplayLayoutResponse ClassReference

Section Contents

• -init• -initWithDictionary:• displayCapabilities• buttonCapabilities• softButtonCapabilities

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *displayLayout;

SWIFT

var displayLayout: String! { get set }

Page 825: Documentation iOS SDLAbstractProtocol Class Reference

• presetBankCapabilities

Overview

Set Display Layout Response is sent, when SetDisplayLayout has been called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLSetDisplayLayoutResponse object

-initWithDictionary:

Undocumented

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 826: Documentation iOS SDLAbstractProtocol Class Reference

displayCapabilities

Undocumented

buttonCapabilities

Undocumented

OBJECTIVE-C

@interface SDLSetDisplayLayoutResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSetDisplayLayoutResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSetDisplayLayoutResponse : SDLRPCResponse

Page 827: Documentation iOS SDLAbstractProtocol Class Reference

softButtonCapabilities

Undocumented

presetBankCapabilities

Undocumented

SDLSetGlobalProperties ClassReference

Section Contents

• -init

OBJECTIVE-C

@interface SDLSetDisplayLayoutResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSetDisplayLayoutResponse : SDLRPCResponse

Page 828: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -initWithHelpText:timeoutText:• -initWithHelpText:timeoutText:vrHelpTitle:vrHelp:• -

initWithHelpText:timeoutText:vrHelpTitle:vrHelp:menuTitle:menuIcon:keyboardProperties:• helpPrompt• timeoutPrompt• vrHelpTitle• vrHelp• menuTitle• menuIcon• keyboardProperties

Overview

Sets value(s) for the specified global property(ies)

Function Group: Base

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 1.0 See SDLResetGlobalProperties

-init

@abstract Constructs a new SDLSetGlobalProperties object

OBJECTIVE-C

- (instancetype)init;

Page 829: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSetGlobalProperties object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 830: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-initWithHelpText:timeoutText:

Undocumented

-initWithHelpText:timeoutText:vrHelpTitle:vrHelp:

Undocumented

-

initWithHelpText:timeoutText:vrHelpTitle:vrHelp:menuTitle:menuIcon:keyboard

Undocumented

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

Page 831: Documentation iOS SDLAbstractProtocol Class Reference

helpPrompt

@abstract Sets a Vector for Help Prompt that Array of one or more TTSChunk

elements specifying the help prompt used in an interaction started by PTT

@discussion helpPrompt a Vector of one or more TTSChunk elements

Notes:

• Array must have at least one element• Only optional it timeoutPrompt has been specified

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *helpPrompt;

SWIFT

var helpPrompt: NSMutableArray! { get set }

Page 832: Documentation iOS SDLAbstractProtocol Class Reference

timeoutPrompt

@abstract A Vector for Timeout Prompt representing Array of one or more

TTSChunk elements specifying the help prompt used in an interaction started

by PTT

vrHelpTitle

@abstract Sets a voice recognition Help Title

@discussion A String value representing a voice recognition Help Title

Notes:

• If omitted on supported displays, the default SDL help title will be used• If omitted and one or more vrHelp items are provided, the request will be

rejected.• String Maxlength = 500

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *timeoutPrompt;

SWIFT

var timeoutPrompt: NSMutableArray! { get set }

Page 833: Documentation iOS SDLAbstractProtocol Class Reference

vrHelp

@abstract Sets the items listed in the VR help screen used in an interaction

started by PTT

@discussion A Vector value representing items listed in the VR help screen

used in an interaction started by PTT

Notes:

• If omitted on supported displays, the default SmartDeviceLink VR help /

What Can I Say? screen will be used• If the list of VR Help Items contains nonsequential positions (e.g. [1,2,4]),

the RPC will be rejected• If omitted and a vrHelpTitle is provided, the request will be rejected• Array Minsize: = 1• Array Maxsize = 100

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *vrHelpTitle;

SWIFT

var vrHelpTitle: String! { get set }

Page 834: Documentation iOS SDLAbstractProtocol Class Reference

menuTitle

Undocumented

menuIcon

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *vrHelp;

SWIFT

var vrHelp: NSMutableArray! { get set }

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

Page 835: Documentation iOS SDLAbstractProtocol Class Reference

keyboardProperties

Undocumented

SDLSetGlobalPropertiesResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

OBJECTIVE-C

@interface SDLSetGlobalProperties : SDLRPCRequest

Page 836: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

Set Global Properties Response is sent, when SDLSetGlobalProperties has been

called

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLSetGlobalPropertiesResponse object

-initWithDictionary:

@abstract Constructs a new SDLSetGlobalPropertiesResponse object indicated

by the NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 837: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLSetMediaClockTimer ClassReference

Section Contents

• -init

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 838: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -initWithUpdateMode:hours:minutes:seconds:• -initWithUpdateMode:• startTime• endTime• updateMode

Overview

Sets the media clock/timer value and the update method (e.g.count-up, count-

down, etc.)

Function Group: Base

HMILevel needs to be FULL, LIMITIED or BACKGROUND

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLSetMediaClockTimer object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 839: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSetMediaClockTimer object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

The dictionary to use

-initWithUpdateMode:hours:minutes:seconds:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 840: Documentation iOS SDLAbstractProtocol Class Reference

-initWithUpdateMode:

Undocumented

startTime

@abstract A Start Time with specifying hour, minute, second values

@discussion A startTime object with specifying hour, minute, second values

Notes:

• If “updateMode” is COUNTUP or COUNTDOWN, this parameter must be

provided• Will be ignored for PAUSE/RESUME and CLEAR

OBJECTIVE-C

@interface SDLSetMediaClockTimer : SDLRPCRequest

OBJECTIVE-C

@interface SDLSetMediaClockTimer : SDLRPCRequest

Page 841: Documentation iOS SDLAbstractProtocol Class Reference

endTime

@abstract An END time of type SDLStartTime, specifying hour, minute, second

values

@discussion An SDLStartTime object with specifying hour, minute, second

values

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLStartTime *startTime;

SWIFT

var startTime: SDLStartTime! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLStartTime *endTime;

Page 842: Documentation iOS SDLAbstractProtocol Class Reference

updateMode

@abstract The media clock/timer update mode (COUNTUP/COUNTDOWN/

PAUSE/RESUME)

@discussion a Enumeration value (COUNTUP/COUNTDOWN/PAUSE/RESUME)

Notes:

• When updateMode is PAUSE, RESUME or CLEAR, the start time value is

ignored• When updateMode is RESUME, the timer resumes counting from the

timer’s value when it was paused

SWIFT

var endTime: SDLStartTime! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLUpdateMode *updateMode;

SWIFT

var updateMode: SDLUpdateMode! { get set }

Page 843: Documentation iOS SDLAbstractProtocol Class Reference

SDLSetMediaClockTimerResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Set Media Clock Timer Response is sent, when SDLSetMediaClockTimer has

been called

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLSetMediaClockTimerResponse object

OBJECTIVE-C

- (instancetype)init;

Page 844: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSetMediaClockTimerResponse object indicated

by the NSMutableDictionary parameter

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 845: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

SDLShow Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithMainField1:mainField2:alignment:• -initWithMainField1:mainField2:mainField3:mainField4:alignment:• -

initWithMainField1:mainField2:alignment:statusBar:mediaClock:mediaTrack:• -

initWithMainField1:mainField2:mainField3:mainField4:alignment:statusBar:mediaClock:mediaTrack:graphic:s• mainField1• mainField2• mainField3• mainField4• alignment• statusBar• mediaClock• mediaTrack• graphic• secondaryGraphic• softButtons• customPresets

Overview

Updates the application’s display text area, regardless of whether or not this

text area is visible to the user at the time of the request. The application’s

display text area remains unchanged until updated by subsequent calls to Show

Page 846: Documentation iOS SDLAbstractProtocol Class Reference

The content of the application’s display text area is visible to the user when the

application is FULL or LIMITED, and the SDLSystemContext=MAIN and no

SDLAlert is in progress

The Show operation cannot be used to create an animated scrolling screen. To

avoid distracting the driver, Show commands cannot be issued more than once

every 4 seconds. Requests made more frequently than this will be rejected

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 1.0 See SDLAlert SDLSetMediaClockTimer

-init

@abstract Constructs a new SDLShow object

-initWithDictionary:

@abstract Constructs a new SDLShow object indicated by the dictionary

parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 847: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithMainField1:mainField2:alignment:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLShow : SDLRPCRequest

Page 848: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithMainField1:mainField2:mainField3:mainField4:alignment:

Undocumented

-

initWithMainField1:mainField2:alignment:statusBar:mediaClock:mediaTrack:

Undocumented

-

initWithMainField1:mainField2:mainField3:mainField4:alignment:statusBar:med

Undocumented

OBJECTIVE-C

@interface SDLShow : SDLRPCRequest

OBJECTIVE-C

@interface SDLShow : SDLRPCRequest

Page 849: Documentation iOS SDLAbstractProtocol Class Reference

mainField1

@abstract The text displayed in a single-line display, or in the upper display

line in a two-line display @discussion The String value representing the text

displayed in a single-line display, or in the upper display line in a two-line

display

Notes:

• If this parameter is omitted, the text of mainField1 does not change• If this parameter is an empty string, the field will be cleared

OBJECTIVE-C

@interface SDLShow : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mainField1;

SWIFT

var mainField1: String! { get set }

Page 850: Documentation iOS SDLAbstractProtocol Class Reference

mainField2

@abstract The text displayed on the second display line of a two-line display

@discussion The String value representing the text displayed on the second

display line of a two-line display

Notes:

• If this parameter is omitted, the text of mainField2 does not change• If this parameter is an empty string, the field will be cleared• If provided and the display is a single-line display, the parameter is

ignored• Maxlength = 500

mainField3

@abstract The text displayed on the first display line of the second page

@discussion The String value representing the text displayed on the first

display line of the second page

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mainField2;

SWIFT

var mainField2: String! { get set }

Page 851: Documentation iOS SDLAbstractProtocol Class Reference

Notes:

• If this parameter is omitted, the text of mainField3 does not change• If this parameter is an empty string, the field will be cleared• If provided and the display is a single-line display, the parameter is

ignored• Maxlength = 500

@since SmartDeviceLink 2.0

mainField4

@abstract The text displayed on the second display line of the second page

@discussion The String value representing the text displayed on the second

display line of the second page

Notes:

• If this parameter is omitted, the text of mainField4 does not change• If this parameter is an empty string, the field will be cleared• If provided and the display is a single-line display, the parameter is

ignored

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mainField3;

SWIFT

var mainField3: String! { get set }

Page 852: Documentation iOS SDLAbstractProtocol Class Reference

• Maxlength = 500

@since SmartDeviceLink 2.0

alignment

@abstract The alignment that Specifies how mainField1 and mainField2 text

should be aligned on display

@discussion An Enumeration value

Notes:

• Applies only to mainField1 and mainField2 provided on this call, not to

what is already showing in display• If this parameter is omitted, text in both mainField1 and mainField2 will be

centered• Has no effect with navigation display

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mainField4;

SWIFT

var mainField4: String! { get set }

Page 853: Documentation iOS SDLAbstractProtocol Class Reference

statusBar

@abstract Text in the Status Bar

@discussion A String representing the text you want to add in the Status Bar

Notes: The status bar only exists on navigation displays

• If this parameter is omitted, the status bar text will remain unchanged• If this parameter is an empty string, the field will be cleared• If provided and the display has no status bar, this parameter is ignored

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTextAlignment *alignment;

SWIFT

var alignment: SDLTextAlignment! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *statusBar;

Page 854: Documentation iOS SDLAbstractProtocol Class Reference

mediaClock

@abstract This property is deprecated use SetMediaClockTimer instead.

The value for the MediaClock field using a format described in the

MediaClockFormat enumeration

@discussion A String value for the MediaClock

Notes:

• Must be properly formatted as described in the MediaClockFormat

enumeration• If a value of five spaces is provided, this will clear that field on the display

(i.e. the media clock timer field will not display anything)

SWIFT

var statusBar: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mediaClock;

Page 855: Documentation iOS SDLAbstractProtocol Class Reference

mediaTrack

@abstract The text in the track field

@discussion A String value disaplayed in the track field

Notes:

• If parameter is omitted, the track field remains unchanged• If an empty string is provided, the field will be cleared• This field is only valid for media applications on navigation displays

SWIFT

var mediaClock: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *mediaTrack;

SWIFT

var mediaTrack: String! { get set }

Page 856: Documentation iOS SDLAbstractProtocol Class Reference

graphic

@abstract An image to be shown on supported displays

@discussion The value representing the image shown on supported displays

Notes: If omitted on supported displays, the displayed graphic shall not

change

@since SmartDeviceLink 2.0

secondaryGraphic

@abstract An image to be shown on supported displays

@discussion The value representing the image shown on supported displays

Notes: If omitted on supported displays, the displayed graphic shall not

change

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLImage *graphic;

SWIFT

var graphic: SDLImage! { get set }

Page 857: Documentation iOS SDLAbstractProtocol Class Reference

softButtons

@abstract The the Soft buttons defined by the App

@discussion A Vector value represemting the Soft buttons defined by the App

Notes:

• If omitted on supported displays, the currently displayed SoftButton

values will not change• Array Minsize: 0• Array Maxsize: 8

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLImage *secondaryGraphic;

SWIFT

var secondaryGraphic: SDLImage! { get set }

Page 858: Documentation iOS SDLAbstractProtocol Class Reference

customPresets

@abstract The Custom Presets defined by the App

@discussion A Vector value representing the Custom Presets defined by the

App

• If omitted on supported displays, the presets will be shown as not defined• Array Minsize: 0• Array Maxsize: 6

@since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *softButtons;

SWIFT

var softButtons: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *customPresets;

Page 859: Documentation iOS SDLAbstractProtocol Class Reference

SDLShowConstantTBT Class Reference

Section Contents

• -init• -initWithDictionary:• -

initWithNavigationText1:navigationText2:eta:timeToDestination:totalDistance:turnIcon:nextTurnIcon:distance• navigationText1• navigationText2• eta• timeToDestination• totalDistance• turnIcon• nextTurnIcon• distanceToManeuver• distanceToManeuverScale• maneuverComplete

SWIFT

var customPresets: NSMutableArray! { get set }

Page 860: Documentation iOS SDLAbstractProtocol Class Reference

• softButtons

Overview

This RPC is used to update the user with navigation information

* for the constantly shown screen (base screen),but also for the

* alert type screen. *

* @since SmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 861: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithNavigationText1:navigationText2:eta:timeToDestination:totalDistance:tu

Undocumented

navigationText1

Undocumented

navigationText2

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 862: Documentation iOS SDLAbstractProtocol Class Reference

eta

Undocumented

timeToDestination

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 863: Documentation iOS SDLAbstractProtocol Class Reference

totalDistance

Undocumented

turnIcon

Undocumented

nextTurnIcon

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 864: Documentation iOS SDLAbstractProtocol Class Reference

distanceToManeuver

Undocumented

distanceToManeuverScale

Undocumented

maneuverComplete

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 865: Documentation iOS SDLAbstractProtocol Class Reference

softButtons

Undocumented

SDLShowConstantTBTResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SDLShowConstantTBTResponse is sent, when SDLShowConstantTBT has been

called. * SinceSmartDeviceLink 2.0

-init

Undocumented

OBJECTIVE-C

@interface SDLShowConstantTBT : SDLRPCRequest

Page 866: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

Undocumented

SDLShowResponse Class Reference

Section Contents

• -init• -initWithDictionary:

Overview

Show Response is sent, when Show has been called

OBJECTIVE-C

@interface SDLShowConstantTBTResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLShowConstantTBTResponse : SDLRPCResponse

Page 867: Documentation iOS SDLAbstractProtocol Class Reference

Since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLShowResponse object

-initWithDictionary:

@abstract Constructs a new SDLShowResponse object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 868: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLSingleTireStatus Class Reference

Section Contents

• -init• -initWithDictionary:• status

Overview

Tire pressure status of a single tire.

@since SmartDeviceLink 2.0

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 869: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a newly allocated SDLSingleTireStatus object

-initWithDictionary:

@abstract Constructs a newly allocated SDLSingleTireStatus object indicated by

the dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 870: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

status

@abstract The volume status of a single tire

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLComponentVolumeStatus *status;

SWIFT

var status: SDLComponentVolumeStatus! { get set }

Page 871: Documentation iOS SDLAbstractProtocol Class Reference

SDLSiphonServer Class Reference

Section Contents

• +enableSiphonDebug• +disableSiphonDebug• +_siphonRawTransportDataFromApp:msgBytesLength:• +_siphonRawTransportDataFromSDL:msgBytesLength:• +_siphonNSLogData:• +_siphonFormattedTraceData:• +_siphonIsActive• +init• +dealloc

Overview

Undocumented

+enableSiphonDebug

Undocumented

+disableSiphonDebug

Undocumented

+_siphonRawTransportDataFromApp:msgBytesLength:

Undocumented

Page 872: Documentation iOS SDLAbstractProtocol Class Reference

+_siphonRawTransportDataFromSDL:msgBytesLength:

Undocumented

+_siphonNSLogData:

Undocumented

+_siphonFormattedTraceData:

Undocumented

+_siphonIsActive

Undocumented

+init

Undocumented

+dealloc

Undocumented

SDLSlider Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithNumTicks:position:

Page 873: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithNumTicks:position:sliderHeader:sliderFooter:timeout:• -initWithNumTicks:position:sliderHeader:sliderFooters:timeout:• numTicks• position• sliderHeader• sliderFooter• timeout

Overview

Creates a full screen or pop-up overlay (depending on platform) with a single

user controlled slider

HMILevel needs to be FULL

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLSlider object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 874: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSlider object indicated by the dictionary

parameter - parameter: dict The dictionary to use

dict

The dictionary to use

-initWithNumTicks:position:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 875: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithNumTicks:position:sliderHeader:sliderFooter:timeout:

Undocumented

-

initWithNumTicks:position:sliderHeader:sliderFooters:timeout:

Undocumented

OBJECTIVE-C

@interface SDLSlider : SDLRPCRequest

OBJECTIVE-C

@interface SDLSlider : SDLRPCRequest

OBJECTIVE-C

@interface SDLSlider : SDLRPCRequest

Page 876: Documentation iOS SDLAbstractProtocol Class Reference

numTicks

@abstract Represents a number of selectable items on a horizontal axis

Required, Integer, 2 - 26

position

@abstract An Initial position of slider control

Required, Integer, 1 - 26

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *numTicks;

SWIFT

var numTicks: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *position;

Page 877: Documentation iOS SDLAbstractProtocol Class Reference

sliderHeader

@abstract A text header to display

Rquired, Max length 500 chars

sliderFooter

@abstract A text footer to display

SWIFT

var position: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *sliderHeader;

SWIFT

var sliderHeader: String! { get set }

Page 878: Documentation iOS SDLAbstractProtocol Class Reference

@discussion For a static text footer, only one footer string shall be provided in

the array.

For a dynamic text footer, the number of footer text string in the array must

match the numTicks value.

For a dynamic text footer, text array string should correlate with potential slider

position index.

If omitted on supported displays, no footer text shall be displayed.

Optional, Array of Strings, Array length 1 - 26, Max string length 500 chars

timeout

@abstract An App defined timeout

@discussion Indicates how long of a timeout from the last action (i.e. sliding

control resets timeout).

If omitted, the value is set to 10000.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *sliderFooter;

SWIFT

var sliderFooter: NSMutableArray! { get set }

Page 879: Documentation iOS SDLAbstractProtocol Class Reference

Optional, Integer, 1000 - 65535

SDLSliderResponse Class Reference

Section Contents

• -init• -initWithDictionary:• sliderPosition

Overview

Slider Response is sent, when Slider has been called

Since SmartDeviceLink 2.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *timeout;

SWIFT

var timeout: NSNumber! { get set }

Page 880: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLSliderResponse object

-initWithDictionary:

@abstract Constructs a new SDLSliderResponse object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 881: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

sliderPosition

@abstract The selected position of the slider.

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *sliderPosition;

SWIFT

var sliderPosition: NSNumber! { get set }

Page 882: Documentation iOS SDLAbstractProtocol Class Reference

SDLSoftButton Class Reference

Section Contents

• -init• -initWithHandler:• -initWithDictionary:• -initWithType:text:image:highlighted:buttonId:systemAction:handler:• handler• type• text• image• isHighlighted• softButtonID• systemAction

Overview

Undocumented

-init

Undocumented

-initWithHandler:

Undocumented

-initWithDictionary:

Undocumented

Page 883: Documentation iOS SDLAbstractProtocol Class Reference

-

initWithType:text:image:highlighted:buttonId:systemAction:handler:

Undocumented

handler

Undocumented

type

Undocumented

text

Undocumented

image

Undocumented

isHighlighted

Undocumented

softButtonID

Undocumented

systemAction

Undocumented

Page 884: Documentation iOS SDLAbstractProtocol Class Reference

SDLSoftButtonCapabilities ClassReference

Section Contents

• -init• -initWithDictionary:• shortPressAvailable• longPressAvailable• upDownAvailable• imageSupported

Overview

Contains information about a SoftButton’s capabilities.

@since SDL 2.0

-init

@abstract Constructs a newly allocated SDLSoftButtonCapabilities object

OBJECTIVE-C

- (instancetype)init;

Page 885: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLSoftButtonCapabilities object

indicated by the dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 886: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

shortPressAvailable

@abstract The button supports a short press.

@discussion Whenever the button is pressed short, onButtonPressed(SHORT)

will be invoked.

Required, Boolean

longPressAvailable

@abstract The button supports a LONG press.

@discussion Whenever the button is pressed long, onButtonPressed(LONG) will

be invoked.

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *shortPressAvailable;

SWIFT

var shortPressAvailable: NSNumber! { get set }

Page 887: Documentation iOS SDLAbstractProtocol Class Reference

upDownAvailable

@abstract The button supports “button down” and “button up”.

@discussion Whenever the button is pressed, onButtonEvent(DOWN) will be

invoked. Whenever the button is released, onButtonEvent(UP) will be invoked.

Required, Boolean

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *longPressAvailable;

SWIFT

var longPressAvailable: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *upDownAvailable;

Page 888: Documentation iOS SDLAbstractProtocol Class Reference

imageSupported

@abstract The button supports referencing a static or dynamic image.

Required, Boolean

SWIFT

var upDownAvailable: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *imageSupported;

SWIFT

var imageSupported: NSNumber! { get set }

Page 889: Documentation iOS SDLAbstractProtocol Class Reference

SDLSoftButtonType Class Reference

Section Contents

• +valueOf:• +values• +TEXT• +IMAGE• +BOTH

Overview

SoftButtonType (TEXT / IMAGE / BOTH)

+valueOf:

@abstract get SDLSoftButtonType according value string - parameter: value

NSString - returns: SDLSoftButtonType object

OBJECTIVE-C

+ (SDLSoftButtonType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLSoftButtonType!

Page 890: Documentation iOS SDLAbstractProtocol Class Reference

value

NSString

SDLSoftButtonType object

+values

@abstract declare an array to store all possible SDLSoftButtonType values -

returns: the array

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 891: Documentation iOS SDLAbstractProtocol Class Reference

the array

+TEXT

@abstract Text kind Softbutton - returns: SDLSoftButtonType object with string

value TEXT

SDLSoftButtonType object with string value TEXT

RETURN VALUE

OBJECTIVE-C

+ (SDLSoftButtonType *)TEXT;

SWIFT

class func text() -> SDLSoftButtonType!

RETURN VALUE

Page 892: Documentation iOS SDLAbstractProtocol Class Reference

+IMAGE

@abstract Image kind Softbutton - returns: SDLSoftButtonType object with

string value IMAGE

SDLSoftButtonType object with string value IMAGE

+BOTH

@abstract Both (Text & Image) kind Softbutton - returns: SDLSoftButtonType

object with string value BOTH

OBJECTIVE-C

+ (SDLSoftButtonType *)IMAGE;

SWIFT

class func image() -> SDLSoftButtonType!

RETURN VALUE

Page 893: Documentation iOS SDLAbstractProtocol Class Reference

SDLSoftButtonType object with string value BOTH

SDLSpeak Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithTTS:• -initWithTTSChunks:• ttsChunks

OBJECTIVE-C

+ (SDLSoftButtonType *)BOTH;

SWIFT

class func both() -> SDLSoftButtonType!

RETURN VALUE

Page 894: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Speaks a phrase over the vehicle audio system using SDL’s TTS (text-to-

speech) engine. The provided text to be spoken can be simply a text phrase, or

it can consist of phoneme specifications to direct SDL’s TTS engine to speak a “

speech-sculpted” phrase.

Receipt of the Response indicates the completion of the Speak operation,

regardless of how the Speak operation may have completed (i.e. successfully,

interrupted, terminated, etc.).

Requesting a new Speak operation while the application has another Speak

operation already in progress (i.e. no corresponding Response for that in-

progress Speak operation has been received yet) will terminate the in-progress

Speak operation (causing its corresponding Response to be sent by SDL) and

begin the requested Speak operation

Requesting a new Speak operation while the application has an SDLAlert

operation already in progress (i.e. no corresponding Response for that in-

progress SDLAlert operation has been received yet) will result in the Speak

operation request being rejected (indicated in the Response to the Request)

Requesting a new SDLAlert operation while the application has a Speak

operation already in progress (i.e. no corresponding Response for that in-

progress Speak operation has been received yet) will terminate the in-progress

Speak operation (causing its corresponding Response to be sent by SDL) and

begin the requested SDLAlert operation

Requesting a new Speak operation while the application has a

SDLPerformInteraction operation already in progress (i.e. no corresponding

Response for that in-progress SDLPerformInteraction operation has been

received yet) will result in the Speak operation request being rejected

(indicated in the Response to the Request)

Requesting a SDLPerformInteraction operation while the application has a

Speak operation already in progress (i.e. no corresponding Response for that in-

progress Speak operation has been received yet) will terminate the in-progress

Speak operation (causing its corresponding Response to be sent by SDL) and

begin the requested SDLPerformInteraction operation

Page 895: Documentation iOS SDLAbstractProtocol Class Reference

HMI Status Requirements: • HMILevel: FULL, Limited• AudioStreamingState: Any• SystemContext: MAIN, MENU, VR

Notes: • When SDLAlert is issued with MENU in effect, SDLAlert is queued and “played”

when MENU interaction is completed (i.e. SystemContext reverts to MAIN).When SDLAlert is issued with VR in effect, SDLAlert is queued and “played”when VR interaction is completed (i.e. SystemContext reverts to MAIN)

• When both SDLAlert and Speak are queued during MENU or VR, they are “played” back in the order in which they were queued, with all existing rules for “collisions” still in effect

Additional Notes: • Total character limit depends on platform.• Chunks are limited to 500 characters; however you can have multiple TTS

chunks.• On old systems there is a total character limit of 500 characters across all

chunks. This could vary according to the VCA.

@since SmartDeviceLink 1.0 - see: SDLAlert

-init

@abstract Constructs a new SDLSpeak object

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 896: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSpeak object indicated by the dictionary

parameter - parameter: dict The dictionary to use

dict

The dictionary to use

-initWithTTS:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 897: Documentation iOS SDLAbstractProtocol Class Reference

-initWithTTSChunks:

Undocumented

ttsChunks

@abstract An array of TTSChunk structs which, taken together, specify the

phrase to be spoken

@discussion The total length of the phrase composed from the ttsChunks

provided must be less than 500 characters or the request will be rejected

Required, Array of SDLTTSChunk, Array size 1 - 100

See

OBJECTIVE-C

@interface SDLSpeak : SDLRPCRequest

OBJECTIVE-C

@interface SDLSpeak : SDLRPCRequest

Page 898: Documentation iOS SDLAbstractProtocol Class Reference

SDLTTSChunk

SDLSpeakResponse Class Reference

Section Contents

• -init• -initWithDictionary:

Overview

Speak Response is sent, when Speak has been called

Since SmartDeviceLink 1.0

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *ttsChunks;

SWIFT

var ttsChunks: NSMutableArray! { get set }

Page 899: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLSpeakResponse object

-initWithDictionary:

@abstract Constructs a new SDLSpeakResponse object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 900: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLSpeechCapabilities Class Reference

Section Contents

• +valueOf:• +values• +TEXT• +SAPI_PHONEMES• +LHPLUS_PHONEMES• +PRE_RECORDED• +SILENCE

Overview

Undocumented

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 901: Documentation iOS SDLAbstractProtocol Class Reference

+valueOf:

@abstract get SDLSpeechCapabilities according value string

value

The value of the string to get an object for

SDLSpeechCapabilities object

OBJECTIVE-C

+ (SDLSpeechCapabilities *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLSpeechCapabilities!

PARAMETERS

RETURN VALUE

Page 902: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract declare an array to store all possible SDLSpeechCapabilities values

the array of all possible values

+TEXT

@abstract The SDL platform can speak text phrases.

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 903: Documentation iOS SDLAbstractProtocol Class Reference

SDLSpeechCapabilities of value: TEXT

+SAPI_PHONEMES

Undocumented

+LHPLUS_PHONEMES

Undocumented

+PRE_RECORDED

Undocumented

OBJECTIVE-C

+ (SDLSpeechCapabilities *)TEXT;

SWIFT

class func text() -> SDLSpeechCapabilities!

RETURN VALUE

Page 904: Documentation iOS SDLAbstractProtocol Class Reference

+SILENCE

Undocumented

SDLStartTime Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithHours:minutes:seconds:• hours• minutes• seconds

Overview

Describes the hour, minute and second values used to set the media clock.

@since SDL 1.0

-init

@abstract Constructs a newly allocated SDLStartTime object

OBJECTIVE-C

- (instancetype)init;

Page 905: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLStartTime object indicated by the

dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 906: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

-initWithHours:minutes:seconds:

Undocumented

hours

@abstract The hour of the media clock

@discussion Some display types only support a max value of 19. If out of

range, it will be rejected.

Required, Integer, 0 - 59

OBJECTIVE-C

@interface SDLStartTime : SDLRPCStruct

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *hours;

Page 907: Documentation iOS SDLAbstractProtocol Class Reference

minutes

@abstract The minute of the media clock

Required, Integer, 0 - 59

seconds

@abstract The second of the media clock

Required, Integer, 0 - 59

SWIFT

var hours: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *minutes;

SWIFT

var minutes: NSNumber! { get set }

Page 908: Documentation iOS SDLAbstractProtocol Class Reference

SDLStreamingMediaManager ClassReference

Section Contents

• videoSessionConnected• audioSessionConnected• videoSessionEncrypted• audioSessionEncrypted• touchManager• videoEncoderSettings• displayCapabilties• defaultVideoEncoderSettings• screenSize• pixelBufferPool• -initWithProtocol:

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *seconds;

SWIFT

var seconds: NSNumber! { get set }

Page 909: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithProtocol:displayCapabilities:• -startVideoSessionWithStartBlock:• -startVideoSessionWithTLS:startBlock:• -stopVideoSession• -sendVideoData:• -startAudioSessionWithStartBlock:• -startAudioSessionWithTLS:startBlock:• -stopAudioSession• -sendAudioData:

Overview

Undocumented

videoSessionConnected

Undocumented

audioSessionConnected

Undocumented

videoSessionEncrypted

Undocumented

audioSessionEncrypted

Undocumented

touchManager

Touch Manager responsible for providing touch event notifications.

Page 910: Documentation iOS SDLAbstractProtocol Class Reference

videoEncoderSettings

The settings used in a VTCompressionSessionRef encoder. These will be verified

when the video stream is started. Acceptable properties for this are located in

VTCompressionProperties. If set to nil, the defaultVideoEncoderSettings will be

used.

WarningVideo streaming must not be connected to update the encoder properties. If itis running, issue a stopVideoSession before updating.

OBJECTIVE-C

@property (readonly, strong, nonatomic) SDLTouchManager *_Nonnull touchManager;

SWIFT

var touchManager: SDLTouchManager { get }

OBJECTIVE-C

@property (readwrite, strong, nonatomic, null_resettable) NSDictionary *videoEncoderSettings;

Page 911: Documentation iOS SDLAbstractProtocol Class Reference

displayCapabilties

Display capabilties that will set the screenSize property. If set to nil, the

SDLDefaultScreenSize will be used.

WarningVideo streaming must not be connected to update the encoder properties. If itis running, issue a stopVideoSession before updating.

defaultVideoEncoderSettings

Provides default video encoder settings used.

SWIFT

var videoEncoderSettings: [AnyHashable : Any]! { get set }

OBJECTIVE-C

@property (readwrite, strong, nonatomic, null_resettable) SDLDisplayCapabilities *displayCapabilties;

SWIFT

var displayCapabilties: SDLDisplayCapabilities! { get set }

Page 912: Documentation iOS SDLAbstractProtocol Class Reference

screenSize

This is the current screen size of a connected display. This will be the size the

video encoder uses to encode the raw image data.

OBJECTIVE-C

@property (readonly, strong, nonatomic) NSDictionary *_Nonnull defaultVideoEncoderSettings;

SWIFT

var defaultVideoEncoderSettings: [AnyHashable : Any] { get }

OBJECTIVE-C

@property (readonly, assign, nonatomic) CGSize screenSize;

SWIFT

var screenSize: CGSize { get }

Page 913: Documentation iOS SDLAbstractProtocol Class Reference

pixelBufferPool

The pixel buffer pool reference returned back from an active

VTCompressionSessionRef encoder.

WarningThis will only return a valid pixel buffer pool after the encoder has beeninitialized (when the video session has started). @discussion Clients may callthis once and retain the resulting pool, this call is cheap enough that it’s OK tocall it once per frame.

-initWithProtocol:

Undocumented

-initWithProtocol:displayCapabilities:

Undocumented

OBJECTIVE-C

@property (readonly, assign, nonatomic, nullable) CVPixelBufferPoolRef pixelBufferPool;

SWIFT

unowned(unsafe) var pixelBufferPool: CVPixelBufferPool? { get }

Page 914: Documentation iOS SDLAbstractProtocol Class Reference

-startVideoSessionWithStartBlock:

This method will attempt to start a streaming video session. It will set up iOS’s

video encoder, and call out to the head unit asking if it will start a video

session. This will not use encryption.

Warning

If this method is called on an 8.0 device, it will assert (in debug), or return a

failure immediately to your block (in release).

startBlock

A block that will be called with the result of attempting to start a video

session

OBJECTIVE-C

- (void)startVideoSessionWithStartBlock: (nonnull SDLStreamingStartBlock)startBlock;

SWIFT

func startVideoSession(start startBlock: @escaping SDLStreamingStartBlock)

PARAMETERS

Page 915: Documentation iOS SDLAbstractProtocol Class Reference

-startVideoSessionWithTLS:startBlock:

Start a video session either with with no encryption (the default), with

authentication but no encryption (this will attempt a TLS authentication with

the other side, but will not physically encrypt the data after that), or

authentication and encryption, which will encrypt all video data being sent.

encryptionFlag

Whether and how much security to apply to the video session.

OBJECTIVE-C

- (void)startVideoSessionWithTLS:(SDLEncryptionFlag)encryptionFlag startBlock: (nonnull SDLStreamingEncryptionStartBlock)startBlock;

SWIFT

func startVideoSession(withTLS encryptionFlag: SDLEncryptionFlag, start startBlock: @escaping SDLStreamingEncryptionStartBlock)

PARAMETERS

Page 916: Documentation iOS SDLAbstractProtocol Class Reference

startBlock

A block that will be called with the result of attempting to start a video

session

-stopVideoSession

This method will stop a running video session if there is one running.

-sendVideoData:

This method receives raw image data and will run iOS8+’s hardware video

encoder to turn the data into a video stream, which will then be passed to the

connected head unit.

OBJECTIVE-C

- (void)stopVideoSession;

SWIFT

func stopVideoSession()

Page 917: Documentation iOS SDLAbstractProtocol Class Reference

imageBuffer

A CVImageBufferRef to be encoded by Video Toolbox

Whether or not the data was successfully encoded and sent.

-startAudioSessionWithStartBlock:

This method will attempt to start an audio session

OBJECTIVE-C

- (BOOL)sendVideoData:(nonnull CVImageBufferRef)imageBuffer;

SWIFT

func sendVideoData(_ imageBuffer: CVImageBuffer) -> Bool

PARAMETERS

RETURN VALUE

Page 918: Documentation iOS SDLAbstractProtocol Class Reference

startBlock

A block that will be called with the result of attempting to start an

audio session

-startAudioSessionWithTLS:startBlock:

Undocumented

-stopAudioSession

This method will stop a running audio session if there is one running.

OBJECTIVE-C

- (void)startAudioSessionWithStartBlock: (nonnull SDLStreamingStartBlock)startBlock;

SWIFT

func startAudioSession(start startBlock: @escaping SDLStreamingStartBlock)

PARAMETERS

Page 919: Documentation iOS SDLAbstractProtocol Class Reference

-sendAudioData:

This method receives PCM audio data and will attempt to send that data across

to the head unit for immediate playback

OBJECTIVE-C

- (void)stopAudioSession;

SWIFT

func stopAudioSession()

OBJECTIVE-C

- (BOOL)sendAudioData:(nonnull NSData *)pcmAudioData;

SWIFT

func sendAudioData(_ pcmAudioData: Data) -> Bool

Page 920: Documentation iOS SDLAbstractProtocol Class Reference

pcmAudioData

The data in PCM audio format, to be played

Whether or not the data was successfully sent.

SDLSubscribeButton Class Reference

Section Contents

• -init• -initWithHandler:• -initWithDictionary:• -initWithButtonName:handler:• handler• buttonName

Overview

Establishes a subscription to button notifications for HMI buttons. Buttons are

not necessarily physical buttons, but can also be “soft” buttons on a touch

screen, depending on the display in the vehicle. Once subscribed to a particular

button, an application will receive both SDLOnButtonEvent and

PARAMETERS

RETURN VALUE

Page 921: Documentation iOS SDLAbstractProtocol Class Reference

SDLOnButtonPress notifications whenever that button is pressed. The

application may also unsubscribe from notifications for a button by invoking the

SDLUnsubscribeButton operation

When a button is depressed, an SDLOnButtonEvent notification is sent to the

application with a ButtonEventMode of BUTTONDOWN. When that same button

is released, an SDLOnButtonEvent notification is sent to the application with a

ButtonEventMode of BUTTONUP

When the duration of a button depression (that is, time between depression

and release) is less than two seconds, an SDLOnButtonPress notification is sent

to the application (at the moment the button is released) with a

ButtonPressMode of SHORT. When the duration is two or more seconds, an

SDLOnButtonPress notification is sent to the application (at the moment the

two seconds have elapsed) with a ButtonPressMode of LONG

The purpose of SDLOnButtonPress notifications is to allow for programmatic

detection of long button presses similar to those used to store presets while

listening to the radio, for example

When a button is depressed and released, the sequence in which notifications

will be sent to the application is as follows:

For short presses:

• OnButtonEvent (ButtonEventMode = BUTTONDOWN)• OnButtonEvent (ButtonEventMode = BUTTONUP)• OnButtonPress (ButtonPressMode = SHORT)

For long presses:

• OnButtonEvent (ButtonEventMode = BUTTONDOWN)• OnButtonEvent (ButtonEventMode = BUTTONUP)• OnButtonPress (ButtonPressMode = LONG)

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 1.0

See SDLUnsubscribeButton

Page 922: Documentation iOS SDLAbstractProtocol Class Reference

-init

Construct an SDLSubscribeButton

An SDLSubscribeButton object

-initWithHandler:

Construct a SDLSubscribeButton with a handler callback when an event occurs.

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

RETURN VALUE

Page 923: Documentation iOS SDLAbstractProtocol Class Reference

handler

A callback that will be called when a button event occurs for the

subscribed button.

An SDLSubscribeButton object

OBJECTIVE-C

- (instancetype)initWithHandler:(SDLRPCNotificationHandler)handler;

SWIFT

init!(handler: SDLRPCNotificationHandler!)

PARAMETERS

RETURN VALUE

Page 924: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSubscribeButton object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

dict

The dictionary to use

-initWithButtonName:handler:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 925: Documentation iOS SDLAbstractProtocol Class Reference

handler

A handler that will let you know when the button you subscribed to is selected.

WarningThis will only work if you use SDLManager.

buttonName

@abstract The name of the button to subscribe to @discussion An enum value,

see SDLButtonName

OBJECTIVE-C

@interface SDLSubscribeButton : SDLRPCRequest <SDLRequestHandler>

OBJECTIVE-C

@property (readwrite, copy, nonatomic) SDLRPCNotificationHandler handler;

SWIFT

var handler: SDLRPCNotificationHandler! { get set }

Page 926: Documentation iOS SDLAbstractProtocol Class Reference

SDLSubscribeButtonResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

SubscribeButton Response is sent, when SDLSubscribeButton has been called

Since SmartDeviceLink 1.0

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonName *buttonName;

SWIFT

var buttonName: SDLButtonName! { get set }

Page 927: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLSubscribeButtonResponse object

-initWithDictionary:

@abstract Constructs a new SDLSubscribeButtonResponse object indicated by

the NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 928: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLSubscribeVehicleData ClassReference

Section Contents

• -init• -initWithDictionary:• -

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clusterModeStatus:deviceStatus:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 929: Documentation iOS SDLAbstractProtocol Class Reference

• externalTemperature• prndl• tirePressure• odometer• beltStatus• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModeStatus• myKey

Overview

Subscribes for specific published vehicle data items. The data will be only sent,

if it has changed. The application will be notified by the onVehicleData

notification whenever new data is available. The update rate is very much

dependent on sensors, vehicle architecture and vehicle type. Be also prepared

for the situation that a signal is not available on a vehicle

Function Group: Location, VehicleInfo and DrivingChara

HMILevel needs to be FULL, LIMITED or BACKGROUND

Since SmartDeviceLink 2.0

See SDLUnsubscribeVehicleData SDLGetVehicleData

-init

@abstract Constructs a new SDLSubscribeVehicleData object

Page 930: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLSubscribeVehicleData object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 931: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clu

Undocumented

gps

@abstract A boolean value. If true, subscribes Gps data

PARAMETERS

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *gps;

Page 932: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract A boolean value. If true, subscribes speed data

rpm

@abstract A boolean value. If true, subscribes rpm data

SWIFT

var gps: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

SWIFT

var speed: NSNumber! { get set }

Page 933: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel

@abstract A boolean value. If true, subscribes FuelLevel data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rpm;

SWIFT

var rpm: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel;

SWIFT

var fuelLevel: NSNumber! { get set }

Page 934: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel_State

@abstract A boolean value. If true, subscribes fuelLevel_State data

instantFuelConsumption

@abstract A boolean value. If true, subscribes instantFuelConsumption data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel_State;

SWIFT

var fuelLevel_State: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *instantFuelConsumption;

Page 935: Documentation iOS SDLAbstractProtocol Class Reference

externalTemperature

@abstract A boolean value. If true, subscribes externalTemperature data

prndl

@abstract A boolean value. If true, subscribes Currently selected gear data

SWIFT

var instantFuelConsumption: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *externalTemperature;

SWIFT

var externalTemperature: NSNumber! { get set }

Page 936: Documentation iOS SDLAbstractProtocol Class Reference

tirePressure

@abstract A boolean value. If true, subscribes tire pressure status data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *prndl;

SWIFT

var prndl: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *tirePressure;

SWIFT

var tirePressure: NSNumber! { get set }

Page 937: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract A boolean value. If true, subscribes odometer data

beltStatus

@abstract A boolean value. If true, subscribes belt Status data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *odometer;

SWIFT

var odometer: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *beltStatus;

Page 938: Documentation iOS SDLAbstractProtocol Class Reference

bodyInformation

@abstract A boolean value. If true, subscribes body Information data

deviceStatus

@abstract A boolean value. If true, subscribes device Status data

SWIFT

var beltStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *bodyInformation;

SWIFT

var bodyInformation: NSNumber! { get set }

Page 939: Documentation iOS SDLAbstractProtocol Class Reference

driverBraking

@abstract A boolean value. If true, subscribes driver Braking data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *deviceStatus;

SWIFT

var deviceStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *driverBraking;

SWIFT

var driverBraking: NSNumber! { get set }

Page 940: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A boolean value. If true, subscribes wiper Status data

headLampStatus

@abstract A boolean value. If true, subscribes Head Lamp Status data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *wiperStatus;

SWIFT

var wiperStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *headLampStatus;

Page 941: Documentation iOS SDLAbstractProtocol Class Reference

engineTorque

@abstract A boolean value. If true, subscribes Engine Torque data

accPedalPosition

@abstract A boolean value. If true, means the accPedalPosition data has been

subscribed.

SWIFT

var headLampStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *engineTorque;

SWIFT

var engineTorque: NSNumber! { get set }

Page 942: Documentation iOS SDLAbstractProtocol Class Reference

steeringWheelAngle

@abstract A boolean value. If true, means the steeringWheelAngle data has

been subscribed.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *accPedalPosition;

SWIFT

var accPedalPosition: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *steeringWheelAngle;

Page 943: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

SWIFT

var steeringWheelAngle: NSNumber! { get set }

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

Page 944: Documentation iOS SDLAbstractProtocol Class Reference

emergencyEvent

Undocumented

clusterModeStatus

Undocumented

myKey

Undocumented

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLSubscribeVehicleData : SDLRPCRequest

Page 945: Documentation iOS SDLAbstractProtocol Class Reference

SDLSubscribeVehicleDataResponseClass Reference

Section Contents

• -init• -initWithDictionary:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• prndl• tirePressure• odometer• beltStatus• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModes

Page 946: Documentation iOS SDLAbstractProtocol Class Reference

• myKey

Overview

Subscribe Vehicle Data Response is sent, when SDLSubscribeVehicleData has

been called

Since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLSubscribeVehicleDataResponse object

-initWithDictionary:

@abstract Constructs a new SDLSubscribeVehicleDataResponse object

indicated by the NSMutableDictionary parameter - parameter: dict The

dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 947: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

gps

@abstract A SDLVehicleDataResult* value. See GPSData.

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 948: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract A SDLVehicleDataResult* value. The vehicle speed in kilometers per

hour.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *gps;

SWIFT

var gps: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *speed;

Page 949: Documentation iOS SDLAbstractProtocol Class Reference

rpm

@abstract A SDLVehicleDataResult* value. The number of revolutions per

minute of the engine.

fuelLevel

@abstract A SDLVehicleDataResult* value. The fuel level in the tank

(percentage)

SWIFT

var speed: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *rpm;

SWIFT

var rpm: SDLVehicleDataResult! { get set }

Page 950: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel_State

@abstract A SDLVehicleDataResult* value. The fuel level state.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *fuelLevel;

SWIFT

var fuelLevel: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *fuelLevel_State;

SWIFT

var fuelLevel_State: SDLVehicleDataResult! { get set }

Page 951: Documentation iOS SDLAbstractProtocol Class Reference

instantFuelConsumption

@abstract A SDLVehicleDataResult* value. The instantaneous fuel consumption

in microlitres.

externalTemperature

@abstract A SDLVehicleDataResult* value. The external temperature in degrees

celsius.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *instantFuelConsumption;

SWIFT

var instantFuelConsumption: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *externalTemperature;

Page 952: Documentation iOS SDLAbstractProtocol Class Reference

prndl

@abstract A SDLVehicleDataResult* value. See PRNDL.

tirePressure

@abstract A SDLVehicleDataResult* value. See TireStatus.

SWIFT

var externalTemperature: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *prndl;

SWIFT

var prndl: SDLVehicleDataResult! { get set }

Page 953: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract A SDLVehicleDataResult* value. Odometer in km.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *tirePressure;

SWIFT

var tirePressure: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *odometer;

SWIFT

var odometer: SDLVehicleDataResult! { get set }

Page 954: Documentation iOS SDLAbstractProtocol Class Reference

beltStatus

@abstract A SDLVehicleDataResult* value. The status of the seat belts.

bodyInformation

@abstract A SDLVehicleDataResult* value. The body information including

power modes.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *beltStatus;

SWIFT

var beltStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *bodyInformation;

Page 955: Documentation iOS SDLAbstractProtocol Class Reference

deviceStatus

@abstract A SDLVehicleDataResult* value. The device status including signal

and battery strength.

driverBraking

@abstract A SDLVehicleDataResult* value. The status of the brake pedal.

SWIFT

var bodyInformation: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *deviceStatus;

SWIFT

var deviceStatus: SDLVehicleDataResult! { get set }

Page 956: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A SDLVehicleDataResult* value. The status of the wipers.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *driverBraking;

SWIFT

var driverBraking: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *wiperStatus;

SWIFT

var wiperStatus: SDLVehicleDataResult! { get set }

Page 957: Documentation iOS SDLAbstractProtocol Class Reference

headLampStatus

@abstract A SDLVehicleDataResult* value. Status of the head lamps.

engineTorque

@abstract A SDLVehicleDataResult* value. Torque value for engine (in Nm) on

non-diesel variants.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *headLampStatus;

SWIFT

var headLampStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *engineTorque;

Page 958: Documentation iOS SDLAbstractProtocol Class Reference

accPedalPosition

@abstract A SDLVehicleDataResult* value. Accelerator pedal position

(percentage depressed)

steeringWheelAngle

@abstract A SDLVehicleDataResult* value. Current angle of the steering wheel

(in deg)

SWIFT

var engineTorque: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *accPedalPosition;

SWIFT

var accPedalPosition: SDLVehicleDataResult! { get set }

Page 959: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *steeringWheelAngle;

SWIFT

var steeringWheelAngle: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@interface SDLSubscribeVehicleDataResponse : SDLRPCResponse

Page 960: Documentation iOS SDLAbstractProtocol Class Reference

emergencyEvent

Undocumented

clusterModes

Undocumented

OBJECTIVE-C

@interface SDLSubscribeVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSubscribeVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLSubscribeVehicleDataResponse : SDLRPCResponse

Page 961: Documentation iOS SDLAbstractProtocol Class Reference

myKey

Undocumented

SDLSyncMsgVersion Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithMajorVersion:minorVersion:• majorVersion• minorVersion

Overview

Specifies the version number of the SDL V4 interface. This is used by both the

application and SDL to declare what interface version each is using.

@since SDL 1.0

OBJECTIVE-C

@interface SDLSubscribeVehicleDataResponse : SDLRPCResponse

Page 962: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a newly allocated SDLSyncMsgVersion object

-initWithDictionary:

@abstract Constructs a newly allocated SDLSyncMsgVersion object indicated by

the dictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 963: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithMajorVersion:minorVersion:

Undocumented

majorVersion

@abstract The major version indicates versions that is not-compatible to

previous versions

Required, Integer, 1 - 10

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLSyncMsgVersion : SDLRPCStruct

Page 964: Documentation iOS SDLAbstractProtocol Class Reference

minorVersion

@abstract The minor version indicates a change to a previous version that

should still allow to be run on an older version (with limited functionality)

Required, Integer, 0 - 1000

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *majorVersion;

SWIFT

var majorVersion: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *minorVersion;

Page 965: Documentation iOS SDLAbstractProtocol Class Reference

SDLSyncPData Class Reference

Section Contents

• -init• -initWithDictionary:

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

SWIFT

var minorVersion: NSNumber! { get set }

Page 966: Documentation iOS SDLAbstractProtocol Class Reference

SDLSyncPDataResponse ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

SDLSystemAction Class Reference

Section Contents

• +valueOf:• +values• +DEFAULT_ACTION• +STEAL_FOCUS• +KEEP_CONTEXT

Page 967: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Enumeration that describes system actions that can be triggered.

+valueOf:

Convert String to SDLSystemAction - parameter: value String - returns:

SDLSystemAction

value

String

OBJECTIVE-C

+ (SDLSystemAction *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLSystemAction!

PARAMETERS

Page 968: Documentation iOS SDLAbstractProtocol Class Reference

SDLSystemAction

+values

@abstract Store the enumeration of all possible SDLSystemAction - returns: an

array that store all possible SDLSystemAction

an array that store all possible SDLSystemAction

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 969: Documentation iOS SDLAbstractProtocol Class Reference

+DEFAULT_ACTION

@abstract Default_Action

+STEAL_FOCUS

@abstract Steal_Focus

OBJECTIVE-C

+ (SDLSystemAction *)DEFAULT_ACTION;

SWIFT

class func default_() -> SDLSystemAction!

OBJECTIVE-C

+ (SDLSystemAction *)STEAL_FOCUS;

Page 970: Documentation iOS SDLAbstractProtocol Class Reference

+KEEP_CONTEXT

@abstract Keep_Context

SWIFT

class func steal_FOCUS() -> SDLSystemAction!

OBJECTIVE-C

+ (SDLSystemAction *)KEEP_CONTEXT;

SWIFT

class func keep_CONTEXT() -> SDLSystemAction!

Page 971: Documentation iOS SDLAbstractProtocol Class Reference

SDLSystemContext Class Reference

Section Contents

• +valueOf:• +values• +MAIN• +VRSESSION• +MENU• +HMI_OBSCURED• +ALERT

Overview

Indicates whether or not a user-initiated interaction is in progress, and if so, in

what mode (i.e. MENU or VR).

@since SDL 1.0

+valueOf:

Convert String to SDLSystemContext

OBJECTIVE-C

+ (SDLSystemContext *)valueOf:(NSString *)value;

Page 972: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object for

SDLSystemContext

+values

@abstract Store the enumeration of all possible SDLSystemContext

SWIFT

class func value(of value: String!) -> SDLSystemContext!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 973: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLSystemContext

+MAIN

@abstract No user interaction (user-initiated or app-initiated) is in progress.

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLSystemContext *)MAIN;

SWIFT

class func main() -> SDLSystemContext!

Page 974: Documentation iOS SDLAbstractProtocol Class Reference

SDLSystemContext object of value MAIN

+VRSESSION

@abstract VR-oriented, user-initiated or app-initiated interaction is in-progress.

SDLSystemContext object of value VRSESSION

RETURN VALUE

OBJECTIVE-C

+ (SDLSystemContext *)VRSESSION;

SWIFT

class func vrsession() -> SDLSystemContext!

RETURN VALUE

Page 975: Documentation iOS SDLAbstractProtocol Class Reference

+MENU

@abstract Menu-oriented, user-initiated or app-initiated interaction is in-

progress.

SDLSystemContext object of value MENU

+HMI_OBSCURED

@abstract The app’s display HMI is currently being obscured by either a system

or other app’s overlay.

@since SDL 2.0

OBJECTIVE-C

+ (SDLSystemContext *)MENU;

SWIFT

class func menu() -> SDLSystemContext!

RETURN VALUE

Page 976: Documentation iOS SDLAbstractProtocol Class Reference

SDLSystemContext object of value HMI_OBSCURED

+ALERT

@abstract Broadcast only to whichever app has an alert currently being

displayed.

@since SDL 2.0

OBJECTIVE-C

+ (SDLSystemContext *)HMI_OBSCURED;

SWIFT

class func hmi_OBSCURED() -> SDLSystemContext!

RETURN VALUE

OBJECTIVE-C

+ (SDLSystemContext *)ALERT;

Page 977: Documentation iOS SDLAbstractProtocol Class Reference

SDLSystemContext object of value ALERT

SDLTBTState Class Reference

Section Contents

• +valueOf:• +values• +ROUTE_UPDATE_REQUEST• +ROUTE_ACCEPTED• +ROUTE_REFUSED• +ROUTE_CANCELLED• +ETA_REQUEST• +NEXT_TURN_REQUEST• +ROUTE_STATUS_REQUEST• +ROUTE_SUMMARY_REQUEST• +TRIP_STATUS_REQUEST

SWIFT

class func alert() -> SDLSystemContext!

RETURN VALUE

Page 978: Documentation iOS SDLAbstractProtocol Class Reference

• +ROUTE_UPDATE_REQUEST_TIMEOUT

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+ROUTE_UPDATE_REQUEST

Undocumented

+ROUTE_ACCEPTED

Undocumented

+ROUTE_REFUSED

Undocumented

+ROUTE_CANCELLED

Undocumented

+ETA_REQUEST

Undocumented

Page 979: Documentation iOS SDLAbstractProtocol Class Reference

+NEXT_TURN_REQUEST

Undocumented

+ROUTE_STATUS_REQUEST

Undocumented

+ROUTE_SUMMARY_REQUEST

Undocumented

+TRIP_STATUS_REQUEST

Undocumented

+ROUTE_UPDATE_REQUEST_TIMEOUT

Undocumented

SDLTCPTransport Class Reference

Section Contents

• socket• hostName• portNumber

Overview

Undocumented

Page 980: Documentation iOS SDLAbstractProtocol Class Reference

socket

Undocumented

hostName

Undocumented

portNumber

Undocumented

SDLTTSChunk Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithText:type:• +textChunksFromString:• +sapiChunksFromString:• +lhPlusChunksFromString:• +prerecordedChunksFromString:• +silenceChunks• text• type

Overview

Specifies what is to be spoken. This can be simply a text phrase, which SDL will

speak according to its own rules. It can also be phonemes from either the

Microsoft SAPI phoneme set, or from the LHPLUS phoneme set. It can also be a

Page 981: Documentation iOS SDLAbstractProtocol Class Reference

pre-recorded sound in WAV format (either developer-defined, or provided by the

SDL platform).

In SDL, words, and therefore sentences, can be built up from phonemes and are

used to explicitly provide the proper pronounciation to the TTS engine. For

example, to have SDL pronounce the word “read” as “red”, rather than as when

it is pronounced like “reed”, the developer would use phonemes to express this

desired pronounciation.

For more information about phonemes, see http://en.wikipedia.org/wiki/

Phoneme.

Parameter List

Name Type DescriptionSmartDeviceLink Ver.Available

@since SmartDeviceLink 1.0

-init

@abstract Constructs a newly allocated SDLTTSChunk object

text String

Text to be spoken,or a phonemespecification, orthe name of apre-recordedsound. Thecontents of thisfield are indicatedby the “type”field.

SmartDeviceLink 1.0

type SpeechCapabilities

Indicates the typeof information inthe “text” field(e.g. phrase to bespoken, phonemespecification,name of pre-recorded sound).

SmartDeviceLink 1.0

Page 982: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLTTSChunk object indicated by the

dictionary parameter

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 983: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithText:type:

Undocumented

+textChunksFromString:

Undocumented

PARAMETERS

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

Page 984: Documentation iOS SDLAbstractProtocol Class Reference

+sapiChunksFromString:

Undocumented

+lhPlusChunksFromString:

Undocumented

+prerecordedChunksFromString:

Undocumented

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

Page 985: Documentation iOS SDLAbstractProtocol Class Reference

+silenceChunks

Undocumented

text

@abstract Text to be spoken, or a phoneme specification, or the name of a pre-

recorded sound. The contents of this field are indicated by the “type” field.

Required, Max length 500

OBJECTIVE-C

@interface SDLTTSChunk : SDLRPCStruct

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *text;

SWIFT

var text: String! { get set }

Page 986: Documentation iOS SDLAbstractProtocol Class Reference

type

@abstract The type of information in the “text” field (e.g. phrase to be spoken,

phoneme specification, name of pre-recorded sound).

Required

SDLTTSChunkFactory Class Reference

Section Contents

• +buildTTSChunkForString:type:

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLSpeechCapabilities *type;

SWIFT

var type: SDLSpeechCapabilities! { get set }

Page 987: Documentation iOS SDLAbstractProtocol Class Reference

• +buildTTSChunksFromSimple:

Overview

Undocumented

+buildTTSChunkForString:type:

Undocumented

+buildTTSChunksFromSimple:

Undocumented

SDLTextAlignment Class Reference

Section Contents

• +valueOf:• +values• +LEFT_ALIGNED• +RIGHT_ALIGNED• +CENTERED

Overview

The list of possible alignments of text in a field. May only work on some display

types.

@since SDL 1.0

Page 988: Documentation iOS SDLAbstractProtocol Class Reference

+valueOf:

Convert String to SDLTextAlignment

value

The value of the string to get an object for

SDLTextAlignment

OBJECTIVE-C

+ (SDLTextAlignment *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLTextAlignment!

PARAMETERS

RETURN VALUE

Page 989: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract Store the enumeration of all possible SDLTextAlignment

an array that store all possible SDLTextAlignment

+LEFT_ALIGNED

@abstract Text aligned left.

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 990: Documentation iOS SDLAbstractProtocol Class Reference

A SDLTextAlignment object with value of LEFT_ALIGNED

+RIGHT_ALIGNED

@abstract Text aligned right.

OBJECTIVE-C

+ (SDLTextAlignment *)LEFT_ALIGNED;

SWIFT

class func left_ALIGNED() -> SDLTextAlignment!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextAlignment *)RIGHT_ALIGNED;

Page 991: Documentation iOS SDLAbstractProtocol Class Reference

A SDLTextAlignment object with value of RIGHT_ALIGNED

+CENTERED

@abstract Text aligned centered.

SWIFT

class func right_ALIGNED() -> SDLTextAlignment!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextAlignment *)CENTERED;

SWIFT

class func centered() -> SDLTextAlignment!

Page 992: Documentation iOS SDLAbstractProtocol Class Reference

A SDLTextAlignment object with value of CENTERED

SDLTextField Class Reference

Section Contents

• -init• -initWithDictionary:• name• characterSet• width• rows

Overview

Struct defining the characteristics of a displayed field on the HMI.

Parameter List

RETURN VALUE

Page 993: Documentation iOS SDLAbstractProtocol Class Reference

Name Type DescriptionSmartDeviceLink Ver.Available

@since SDL 1.0

-init

@abstract Constructs a newly allocated SDLTextField object

name TextFieldNameEnumerationidentifying thefield.

SDL 1.0

characterSet CharacterSetThe character setthat is supportedin this field.

SDL 1.0

width Int16

The number ofcharacters in onerow of this field.

• Minvalue

=“1”• maxvalu

e=“500”

SDL 1.0

rows Int16

The number ofrows for this textfield.

• Minvalue

=“1”• maxvalu

e=“3”

SDL 1.0

OBJECTIVE-C

- (instancetype)init;

Page 994: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLTextField object indicated by the

dictionary parameter

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 995: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use to construct the object

name

@abstract The enumeration identifying the field.

SeeSDLTextFieldName Required

characterSet

@abstract The character set that is supported in this field.

SeeSDLCharacterSet Required

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLTextFieldName *name;

SWIFT

var name: SDLTextFieldName! { get set }

Page 996: Documentation iOS SDLAbstractProtocol Class Reference

width

@abstract The number of characters in one row of this field.

Required, Integer 1 - 500

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLCharacterSet *characterSet;

SWIFT

var characterSet: SDLCharacterSet! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *width;

Page 997: Documentation iOS SDLAbstractProtocol Class Reference

rows

@abstract The number of rows for this text field.

Required, Integer 1 - 8

SWIFT

var width: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rows;

SWIFT

var rows: NSNumber! { get set }

Page 998: Documentation iOS SDLAbstractProtocol Class Reference

SDLTextFieldName Class Reference

Section Contents

• +valueOf:• +values• +mainField1• +mainField2• +mainField3• +mainField4• +statusBar• +mediaClock• +mediaTrack• +alertText1• +alertText2• +alertText3• +scrollableMessageBody• +initialInteractionText• +navigationText1• +navigationText2• +ETA• +totalDistance• +audioPassThruDisplayText1• +audioPassThruDisplayText2• +sliderHeader• +sliderFooter• +menuName• +secondaryText• +tertiaryText• +menuTitle• +locationName• +locationDescription• +addressLines• +phoneNumber

Page 999: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Names of the text fields that can appear on a SDL display.

@since SDL 1.0

+valueOf:

Convert String to SDLTextFieldName

value

String value to retrieve the object for

OBJECTIVE-C

+ (SDLTextFieldName *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLTextFieldName!

PARAMETERS

Page 1000: Documentation iOS SDLAbstractProtocol Class Reference

SDLTextFieldName

+values

@abstract Store the enumeration of all possible SDLTextFieldName

an array that store all possible SDLTextFieldName

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 1001: Documentation iOS SDLAbstractProtocol Class Reference

+mainField1

@abstract The first line of the first set of main fields of the persistent display.

Applies to SDLShow.

a SDLTextFieldName with value of mainField1

+mainField2

@abstract The second line of the first set of main fields of the persistent

display. Applies to SDLShow.

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)mainField1;

SWIFT

class func mainField1() -> SDLTextFieldName!

RETURN VALUE

Page 1002: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of mainField2

+mainField3

@abstract The first line of the second set of main fields of the persistent

display. Applies to SDLShow.

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)mainField2;

SWIFT

class func mainField2() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)mainField3;

Page 1003: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of mainField3

+mainField4

@abstract The second line of the second set of main fields of the persistent

display. Applies to SDLShow.

SWIFT

class func mainField3() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)mainField4;

SWIFT

class func mainField4() -> SDLTextFieldName!

Page 1004: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of mainField4

+statusBar

@abstract The status bar on the NGN display. Applies to SDLShow.

a SDLTextFieldName with value of statusBar

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)statusBar;

SWIFT

class func statusBar() -> SDLTextFieldName!

RETURN VALUE

Page 1005: Documentation iOS SDLAbstractProtocol Class Reference

+mediaClock

@abstract Text value for MediaClock field. Must be properly formatted

according to MediaClockFormat. Applies to SDLShow.

@discussion This field is commonly used to show elapsed or remaining time in

an audio track or audio capture.

a SDLTextFieldName with value of mediaClock

+mediaTrack

@abstract The track field of NGN type ACMs. This field is only available for

media applications on a NGN display. Applies to SDLShow.

OBJECTIVE-C

+ (SDLTextFieldName *)mediaClock;

SWIFT

class func mediaClock() -> SDLTextFieldName!

RETURN VALUE

Page 1006: Documentation iOS SDLAbstractProtocol Class Reference

@discussion This field is commonly used to show the current track number

a SDLTextFieldName with value of mediaTrack

+alertText1

@abstract The first line of the alert text field. Applies to SDLAlert.

OBJECTIVE-C

+ (SDLTextFieldName *)mediaTrack;

SWIFT

class func mediaTrack() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)alertText1;

Page 1007: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of alertText1

+alertText2

@abstract The second line of the alert text field. Applies to SDLAlert.

@since SDL 2.0

SWIFT

class func alertText1() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)alertText2;

SWIFT

class func alertText2() -> SDLTextFieldName!

Page 1008: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of alertText2

+alertText3

@abstract The third line of the alert text field. Applies to SDLAlert.

@since SDL 2.0

a SDLTextFieldName with value of alertText3

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)alertText3;

SWIFT

class func alertText3() -> SDLTextFieldName!

RETURN VALUE

Page 1009: Documentation iOS SDLAbstractProtocol Class Reference

+scrollableMessageBody

@abstract Long form body of text that can include newlines and tabs. Applies

to SDLScrollableMessage.

@since SDL 2.0

a SDLTextFieldName with value of scrollableMessageBody

+initialInteractionText

@abstract First line suggestion for a user response (in the case of VR enabled

interaction).

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)scrollableMessageBody;

SWIFT

class func scrollableMessageBody() -> SDLTextFieldName!

RETURN VALUE

Page 1010: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of initialInteractionText

+navigationText1

@abstract First line of navigation text.

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)initialInteractionText;

SWIFT

class func initialInteractionText() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)navigationText1;

Page 1011: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of navigationText1

+navigationText2

@abstract Second line of navigation text.

@since SDL 2.0

SWIFT

class func navigationText1() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)navigationText2;

SWIFT

class func navigationText2() -> SDLTextFieldName!

Page 1012: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of navigationText2

+ETA

@abstract Estimated Time of Arrival time for navigation.

@since SDL 2.0

a SDLTextFieldName with value of ETA

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)ETA;

SWIFT

class func eta() -> SDLTextFieldName!

RETURN VALUE

Page 1013: Documentation iOS SDLAbstractProtocol Class Reference

+totalDistance

@abstract Total distance to destination for navigation.

@since SDL 2.0

a SDLTextFieldName with value of totalDistance

+audioPassThruDisplayText1

@abstract First line of text for audio pass thru.

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)totalDistance;

SWIFT

class func totalDistance() -> SDLTextFieldName!

RETURN VALUE

Page 1014: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of audioPassThruDisplayText1

+audioPassThruDisplayText2

@abstract Second line of text for audio pass thru.

@since SDL 2.0

OBJECTIVE-C

+ (SDLTextFieldName *)audioPassThruDisplayText1;

SWIFT

class func audioPassThruDisplayText1() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)audioPassThruDisplayText2;

Page 1015: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of audioPassThruDisplayText2

+sliderHeader

@abstract Header text for slider.

@since SDL 2.0

SWIFT

class func audioPassThruDisplayText2() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)sliderHeader;

SWIFT

class func sliderHeader() -> SDLTextFieldName!

Page 1016: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of sliderHeader

+sliderFooter

@abstract Footer text for slider

@since SDL 2.0

a SDLTextFieldName with value of sliderFooter

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)sliderFooter;

SWIFT

class func sliderFooter() -> SDLTextFieldName!

RETURN VALUE

Page 1017: Documentation iOS SDLAbstractProtocol Class Reference

+menuName

Primary text for SDLChoice

a SDLTextFieldName with value of menuName

+secondaryText

Secondary text for SDLChoice

OBJECTIVE-C

+ (SDLTextFieldName *)menuName;

SWIFT

class func menu() -> SDLTextFieldName!

RETURN VALUE

Page 1018: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of secondaryText

+tertiaryText

Tertiary text for SDLChoice

OBJECTIVE-C

+ (SDLTextFieldName *)secondaryText;

SWIFT

class func secondaryText() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)tertiaryText;

Page 1019: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of tertiaryText

+menuTitle

Optional text to label an app menu button (for certain touchscreen platforms)

SWIFT

class func tertiaryText() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)menuTitle;

SWIFT

class func menuTitle() -> SDLTextFieldName!

Page 1020: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of menuTitle

+locationName

Optional name / title of intended location for SDLSendLocation

@since SDL 4.0

a SDLTextFieldName with value of locationName

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)locationName;

SWIFT

class func location() -> SDLTextFieldName!

RETURN VALUE

Page 1021: Documentation iOS SDLAbstractProtocol Class Reference

+locationDescription

Optional description of intended location / establishment (if applicable) for

SDLSendLocation

@since SDL 4.0

a SDLTextFieldName with value of locationDescription

+addressLines

Optional location address (if applicable) for SDLSendLocation

@since SDL 4.0

OBJECTIVE-C

+ (SDLTextFieldName *)locationDescription;

SWIFT

class func locationDescription() -> SDLTextFieldName!

RETURN VALUE

Page 1022: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of addressLines

+phoneNumber

Optional hone number of intended location / establishment (if applicable) for

SDLSendLocation

@since SDL 4.0

OBJECTIVE-C

+ (SDLTextFieldName *)addressLines;

SWIFT

class func addressLines() -> SDLTextFieldName!

RETURN VALUE

OBJECTIVE-C

+ (SDLTextFieldName *)phoneNumber;

Page 1023: Documentation iOS SDLAbstractProtocol Class Reference

a SDLTextFieldName with value of phoneNumber

SDLTimerMode Class Reference

Section Contents

• +valueOf:• +values• +UP• +DOWN• +NONE

Overview

Undocumented

+valueOf:

Undocumented

SWIFT

class func phoneNumber() -> SDLTextFieldName!

RETURN VALUE

Page 1024: Documentation iOS SDLAbstractProtocol Class Reference

+values

Undocumented

+UP

Undocumented

+DOWN

Undocumented

+NONE

Undocumented

SDLTireStatus Class Reference

Section Contents

• -init• -initWithDictionary:• pressureTelltale• leftFront• rightFront• leftRear• rightRear• innerLeftRear

Page 1025: Documentation iOS SDLAbstractProtocol Class Reference

• innerRightRear

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

pressureTelltale

Undocumented

leftFront

Undocumented

rightFront

Undocumented

leftRear

Undocumented

rightRear

Undocumented

Page 1026: Documentation iOS SDLAbstractProtocol Class Reference

innerLeftRear

Undocumented

innerRightRear

Undocumented

SDLTouchCoord Class Reference

Section Contents

• -init• -initWithDictionary:• x• y

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

Page 1027: Documentation iOS SDLAbstractProtocol Class Reference

x

Undocumented

y

Undocumented

SDLTouchEvent Class Reference

Section Contents

• -init• -initWithDictionary:• touchEventId• timeStamp• coord

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

Page 1028: Documentation iOS SDLAbstractProtocol Class Reference

touchEventId

A touch’s unique identifier. The application can track the current touch events

by id. If a touch event has type begin, the id should be added to the set of

touches. If a touch event has type end, the id should be removed from the set

of touches.

Mandatory, 0-9

timeStamp

The time that the touch was recorded. This number can the time since the

beginning of the session or something else as long as the units are in

milliseconds.

The timestamp is used to determined the rate of change of position of a touch.

The application also uses the time to verify whether two touches, with different

ids, are part of a single action by the user.

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *touchEventId;

SWIFT

var touchEventId: NSNumber! { get set }

Page 1029: Documentation iOS SDLAbstractProtocol Class Reference

If there is only a single timestamp in this array, it is the same for every

coordinate in the coordinates array.

Mandatory, array size 1-1000, contains size 0-5000000000

coord

Mandatory, array size 1-1000, contains SDLTouchCoord

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *timeStamp;

SWIFT

var timeStamp: NSMutableArray! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *coord;

Page 1030: Documentation iOS SDLAbstractProtocol Class Reference

SDLTouchEventCapabilities ClassReference

Section Contents

• -init• -initWithDictionary:• pressAvailable• multiTouchAvailable• doublePressAvailable

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

SWIFT

var coord: NSMutableArray! { get set }

Page 1031: Documentation iOS SDLAbstractProtocol Class Reference

pressAvailable

Undocumented

multiTouchAvailable

Undocumented

doublePressAvailable

Undocumented

SDLTouchManager Class Reference

Section Contents

• touchEventDelegate• tapDistanceThreshold• tapTimeThreshold• movementTimeThreshold• touchEnabled• -cancelPendingTouches

Overview

Undocumented

touchEventDelegate

Undocumented

Page 1032: Documentation iOS SDLAbstractProtocol Class Reference

tapDistanceThreshold

@abstract Distance between two taps on the screen, in the head unit’s

coordinate system, used for registering double-tap callbacks. @remark Default

is 50 pixels.

tapTimeThreshold

@abstract Time (in seconds) between tap events to register a double-tap

callback. @remark Default is 0.4 seconds.

movementTimeThreshold

@abstract Time (in seconds) between movement events to register panning or

pinching callbacks. @remark Default is 0.05 seconds.

OBJECTIVE-C

@property (assign, readwrite, nonatomic) CGFloat tapDistanceThreshold;

OBJECTIVE-C

@property (assign, readwrite, nonatomic) CGFloat tapTimeThreshold;

Page 1033: Documentation iOS SDLAbstractProtocol Class Reference

touchEnabled

@abstract Boolean denoting whether or not the touch manager should deliver

touch event callbacks. @remark Default is true.

-cancelPendingTouches

@abstract Cancels pending touch event timers that may be in progress.

@remark Currently only impacts the timer used to register single taps.

OBJECTIVE-C

@property (assign, readwrite, nonatomic) CGFloat movementTimeThreshold;

OBJECTIVE-C

@property (getter=isTouchEnabled, assign, readwrite, nonatomic) BOOL touchEnabled;

OBJECTIVE-C

- (void)cancelPendingTouches;

Page 1034: Documentation iOS SDLAbstractProtocol Class Reference

SDLTouchType Class Reference

Section Contents

• +valueOf:• +values• +BEGIN• +MOVE• +END

Overview

Undocumented

+valueOf:

Undocumented

+values

Undocumented

+BEGIN

Undocumented

+MOVE

Undocumented

Page 1035: Documentation iOS SDLAbstractProtocol Class Reference

+END

Undocumented

SDLTriggerSource Class Reference

Section Contents

• +valueOf:• +values• +MENU• +VR• +KEYBOARD

Overview

Indicates whether choice/command was selected via VR or via a menu selection

(using SEEKRIGHT/SEEKLEFT, TUNEUP, TUNEDOWN, OK buttons)

@since SDL 1.0

+valueOf:

Convert String to SDLTriggerSource - parameter: value The value of the string to

get an object for - returns: SDLTriggerSource

OBJECTIVE-C

+ (SDLTriggerSource *)valueOf:(NSString *)value;

Page 1036: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLTriggerSource

+values

@abstract Store the enumeration of all possible SDLTriggerSource - returns: an

array that store all possible SDLTriggerSource

SWIFT

class func value(of value: String!) -> SDLTriggerSource!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1037: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLTriggerSource

+MENU

@abstract Selection made via menu - returns: SDLTriggerSource with value of

MENU

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLTriggerSource *)MENU;

SWIFT

class func menu() -> SDLTriggerSource!

Page 1038: Documentation iOS SDLAbstractProtocol Class Reference

SDLTriggerSource with value of MENU

+VR

@abstract Selection made via Voice session - returns: SDLTriggerSource with

value of VR

SDLTriggerSource with value of VR

RETURN VALUE

OBJECTIVE-C

+ (SDLTriggerSource *)VR;

SWIFT

class func vr() -> SDLTriggerSource!

RETURN VALUE

Page 1039: Documentation iOS SDLAbstractProtocol Class Reference

+KEYBOARD

@abstract Selection made via Keyboard - returns: SDLTriggerSource with value

of KEYBOARD

SDLTriggerSource with value of KEYBOARD

OBJECTIVE-C

+ (SDLTriggerSource *)KEYBOARD;

SWIFT

class func keyboard() -> SDLTriggerSource!

RETURN VALUE

Page 1040: Documentation iOS SDLAbstractProtocol Class Reference

SDLTurn Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithNavigationText:turnIcon:• navigationText• turnIcon

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

-initWithNavigationText:turnIcon:

Undocumented

navigationText

Undocumented

Page 1041: Documentation iOS SDLAbstractProtocol Class Reference

turnIcon

Undocumented

SDLUnregisterAppInterface ClassReference

Section Contents

• -init• -initWithDictionary:

Overview

Terminates an application’s interface registration. This causes SDL® to dispose

of all resources associated with the application’s interface registration (e.g.

Command Menu items, Choice Sets, button subscriptions, etc.)

After the UnregisterAppInterface operation is performed, no other operations

can be performed until a new app interface registration is established by calling

{@linkplain RegisterAppInterface}

HMILevel can be FULL, LIMITED, BACKGROUND or NONE

See SDLRegisterAppInterface SDLOnAppInterfaceUnregistered

-init

@abstract Constructs a new SDLUnregisterAppInterface object

Page 1042: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLUnregisterAppInterface object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

Page 1043: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLUnregisterAppInterfaceResponseClass Reference

Section Contents

• -init• -initWithDictionary:

Overview

Unregister AppInterface Response is sent, when SDLUnregisterAppInterface has

been called

@since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLUnregisterAppInterfaceResponse object

PARAMETERS

Page 1044: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLUnregisterAppInterfaceResponse object

indicated by the NSMutableDictionary parameter - parameter: dict The

dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 1045: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLUnsubscribeButton Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithButtonName:• buttonName

Overview

Deletes a subscription to button notifications for the specified button. For more

information about button subscriptions, see SDLSubscribeButton

Application can unsubscribe from a button that is currently being pressed (i.e.

has not yet been released), but app will not get button event

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 1046: Documentation iOS SDLAbstractProtocol Class Reference

HMILevel needs to be FULL, LIMITED or BACKGROUND

@since SmartDeviceLink 1.0

See SDLSubscribeButton

-init

@abstract Constructs a new SDLUnsubscribeButton object

-initWithDictionary:

@abstract Constructs a new SDLUnsubscribeButton object indicated by the

NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 1047: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-initWithButtonName:

Undocumented

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLUnsubscribeButton : SDLRPCRequest

Page 1048: Documentation iOS SDLAbstractProtocol Class Reference

buttonName

@abstract A name of the button to unsubscribe from @discussion An

Enumeration value, see SDLButtonName

SDLUnsubscribeButtonResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLButtonName *buttonName;

SWIFT

var buttonName: SDLButtonName! { get set }

Page 1049: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

Unsubscribe Button Response is sent, when SDLUnsubscribeButton has been

called

@since SmartDeviceLink 1.0

-init

@abstract Constructs a new SDLUnsubscribeButtonResponse object

-initWithDictionary:

@abstract Constructs a new SDLUnsubscribeButtonResponse object indicated

by the NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

Page 1050: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

SDLUnsubscribeVehicleData ClassReference

Section Contents

• -init

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 1051: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• -

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clusterModeStatus:deviceStatus:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• prndl• tirePressure• odometer• beltStatus• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModeStatus• myKey

Overview

This function is used to unsubscribe the notifications from the

subscribeVehicleData function

Function Group: Location, VehicleInfo and DrivingChara

HMILevel needs to be FULL, LIMITED or BACKGROUND

@since SmartDeviceLink 2.0

See SDLSubscribeVehicleData SDLGetVehicleData

Page 1052: Documentation iOS SDLAbstractProtocol Class Reference

-init

@abstract Constructs a new SDLUnsubscribeVehicleData object

-initWithDictionary:

@abstract Constructs a new SDLUnsubscribeVehicleData object indicated by

the NSMutableDictionary parameter - parameter: dict The dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 1053: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

-

initWithAccelerationPedalPosition:airbagStatus:beltStatus:bodyInformation:clu

Undocumented

gps

@abstract A boolean value. If true, unsubscribes Gps data

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

Page 1054: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract A boolean value. If true, unsubscribes speed data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *gps;

SWIFT

var gps: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *speed;

SWIFT

var speed: NSNumber! { get set }

Page 1055: Documentation iOS SDLAbstractProtocol Class Reference

rpm

@abstract A boolean value. If true, unsubscribe data

fuelLevel

@abstract A boolean value. If true, unsubscribes FuelLevel data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *rpm;

SWIFT

var rpm: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel;

Page 1056: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel_State

@abstract A boolean value. If true, unsubscribes fuelLevel_State data

instantFuelConsumption

@abstract A boolean value. If true, unsubscribes instantFuelConsumption data

SWIFT

var fuelLevel: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *fuelLevel_State;

SWIFT

var fuelLevel_State: NSNumber! { get set }

Page 1057: Documentation iOS SDLAbstractProtocol Class Reference

externalTemperature

@abstract A boolean value. If true, unsubscribes externalTemperature data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *instantFuelConsumption;

SWIFT

var instantFuelConsumption: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *externalTemperature;

SWIFT

var externalTemperature: NSNumber! { get set }

Page 1058: Documentation iOS SDLAbstractProtocol Class Reference

prndl

@abstract A boolean value. If true, unsubscribes Currently selected gear data

tirePressure

@abstract A boolean value. If true, unsubscribes tire pressure status data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *prndl;

SWIFT

var prndl: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *tirePressure;

Page 1059: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract A boolean value. If true, unsubscribes odometer data

beltStatus

@abstract A boolean value. If true, unsubscribes belt Status data

SWIFT

var tirePressure: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *odometer;

SWIFT

var odometer: NSNumber! { get set }

Page 1060: Documentation iOS SDLAbstractProtocol Class Reference

bodyInformation

@abstract A boolean value. If true, unsubscribes body Information data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *beltStatus;

SWIFT

var beltStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *bodyInformation;

SWIFT

var bodyInformation: NSNumber! { get set }

Page 1061: Documentation iOS SDLAbstractProtocol Class Reference

deviceStatus

@abstract A boolean value. If true, unsubscribes device Status data

driverBraking

@abstract A boolean value. If true, unsubscribes driver Braking data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *deviceStatus;

SWIFT

var deviceStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *driverBraking;

Page 1062: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A boolean value. If true, unsubscribes wiper Status data

headLampStatus

@abstract A boolean value. If true, unsubscribes Head Lamp Status data

SWIFT

var driverBraking: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *wiperStatus;

SWIFT

var wiperStatus: NSNumber! { get set }

Page 1063: Documentation iOS SDLAbstractProtocol Class Reference

engineTorque

@abstract A boolean value. If true, unsubscribes Engine Torque data

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *headLampStatus;

SWIFT

var headLampStatus: NSNumber! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *engineTorque;

SWIFT

var engineTorque: NSNumber! { get set }

Page 1064: Documentation iOS SDLAbstractProtocol Class Reference

accPedalPosition

@abstract A boolean value. If true, unsubscribes accPedalPosition data

steeringWheelAngle

Undocumented

OBJECTIVE-C

@property (readwrite, strong, atomic) NSNumber *accPedalPosition;

SWIFT

var accPedalPosition: NSNumber! { get set }

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

Page 1065: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

emergencyEvent

Undocumented

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

Page 1066: Documentation iOS SDLAbstractProtocol Class Reference

clusterModeStatus

Undocumented

myKey

Undocumented

SDLUnsubscribeVehicleDataResponseClass Reference

Section Contents

• -init

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

OBJECTIVE-C

@interface SDLUnsubscribeVehicleData : SDLRPCRequest

Page 1067: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:• gps• speed• rpm• fuelLevel• fuelLevel_State• instantFuelConsumption• externalTemperature• prndl• tirePressure• odometer• beltStatus• bodyInformation• deviceStatus• driverBraking• wiperStatus• headLampStatus• engineTorque• accPedalPosition• steeringWheelAngle• eCallInfo• airbagStatus• emergencyEvent• clusterModes• myKey

Overview

Unsubscribe Vehicle Data Response is sent, when UnsubscribeVehicleData has

been called

@since SmartDeviceLink 2.0

-init

@abstract Constructs a new SDLUnsubscribeVehicleDataResponse object

Page 1068: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a new SDLUnsubscribeVehicleDataResponse object

indicated by the NSMutableDictionary parameter - parameter: dict The

dictionary to use

OBJECTIVE-C

- (instancetype)init;

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

Page 1069: Documentation iOS SDLAbstractProtocol Class Reference

dict

The dictionary to use

gps

@abstract A SDLVehicleDataResult* value. See GPSData.

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *gps;

SWIFT

var gps: SDLVehicleDataResult! { get set }

Page 1070: Documentation iOS SDLAbstractProtocol Class Reference

speed

@abstract A SDLVehicleDataResult* value. The vehicle speed in kilometers per

hour.

rpm

@abstract A SDLVehicleDataResult* value. The number of revolutions per

minute of the engine.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *speed;

SWIFT

var speed: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *rpm;

Page 1071: Documentation iOS SDLAbstractProtocol Class Reference

fuelLevel

@abstract A SDLVehicleDataResult* value. The fuel level in the tank

(percentage)

fuelLevel_State

@abstract A SDLVehicleDataResult* value. The fuel level state.

SWIFT

var rpm: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *fuelLevel;

SWIFT

var fuelLevel: SDLVehicleDataResult! { get set }

Page 1072: Documentation iOS SDLAbstractProtocol Class Reference

instantFuelConsumption

@abstract A SDLVehicleDataResult* value. The instantaneous fuel consumption

in microlitres.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *fuelLevel_State;

SWIFT

var fuelLevel_State: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *instantFuelConsumption;

Page 1073: Documentation iOS SDLAbstractProtocol Class Reference

externalTemperature

@abstract A SDLVehicleDataResult* value. The external temperature in degrees

celsius.

prndl

@abstract A SDLVehicleDataResult* value. See PRNDL.

SWIFT

var instantFuelConsumption: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *externalTemperature;

SWIFT

var externalTemperature: SDLVehicleDataResult! { get set }

Page 1074: Documentation iOS SDLAbstractProtocol Class Reference

tirePressure

@abstract A SDLVehicleDataResult* value. See TireStatus.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *prndl;

SWIFT

var prndl: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *tirePressure;

SWIFT

var tirePressure: SDLVehicleDataResult! { get set }

Page 1075: Documentation iOS SDLAbstractProtocol Class Reference

odometer

@abstract A SDLVehicleDataResult* value. Odometer in km.

beltStatus

@abstract A SDLVehicleDataResult* value. The status of the seat belts.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *odometer;

SWIFT

var odometer: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *beltStatus;

Page 1076: Documentation iOS SDLAbstractProtocol Class Reference

bodyInformation

@abstract A SDLVehicleDataResult* value. The body information including

power modes.

deviceStatus

@abstract A SDLVehicleDataResult* value. The device status including signal

and battery strength.

SWIFT

var beltStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *bodyInformation;

SWIFT

var bodyInformation: SDLVehicleDataResult! { get set }

Page 1077: Documentation iOS SDLAbstractProtocol Class Reference

driverBraking

@abstract A SDLVehicleDataResult* value. The status of the brake pedal.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *deviceStatus;

SWIFT

var deviceStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *driverBraking;

SWIFT

var driverBraking: SDLVehicleDataResult! { get set }

Page 1078: Documentation iOS SDLAbstractProtocol Class Reference

wiperStatus

@abstract A SDLVehicleDataResult* value. The status of the wipers.

headLampStatus

@abstract A SDLVehicleDataResult* value. Status of the head lamps.

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *wiperStatus;

SWIFT

var wiperStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *headLampStatus;

Page 1079: Documentation iOS SDLAbstractProtocol Class Reference

engineTorque

@abstract A SDLVehicleDataResult* value. Torque value for engine (in Nm) on

non-diesel variants.

accPedalPosition

@abstract A SDLVehicleDataResult* value. Accelerator pedal position

(percentage depressed)

SWIFT

var headLampStatus: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *engineTorque;

SWIFT

var engineTorque: SDLVehicleDataResult! { get set }

Page 1080: Documentation iOS SDLAbstractProtocol Class Reference

steeringWheelAngle

@abstract A SDLVehicleDataResult* value. Current angle of the steering wheel

(in deg)

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *accPedalPosition;

SWIFT

var accPedalPosition: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) SDLVehicleDataResult *steeringWheelAngle;

Page 1081: Documentation iOS SDLAbstractProtocol Class Reference

eCallInfo

Undocumented

airbagStatus

Undocumented

SWIFT

var steeringWheelAngle: SDLVehicleDataResult! { get set }

OBJECTIVE-C

@interface SDLUnsubscribeVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLUnsubscribeVehicleDataResponse : SDLRPCResponse

Page 1082: Documentation iOS SDLAbstractProtocol Class Reference

emergencyEvent

Undocumented

clusterModes

Undocumented

myKey

Undocumented

OBJECTIVE-C

@interface SDLUnsubscribeVehicleDataResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLUnsubscribeVehicleDataResponse : SDLRPCResponse

Page 1083: Documentation iOS SDLAbstractProtocol Class Reference

SDLUpdateMode Class Reference

Section Contents

• +valueOf:• +values• +COUNTUP• +COUNTDOWN• +PAUSE• +RESUME• +CLEAR

Overview

Specifies what function should be performed on the media clock/counter

@since SDL 1.0

+valueOf:

Convert String to SDLUpdateMode - parameter: value The value of the string to

get an object for - returns: SDLUpdateMode

OBJECTIVE-C

@interface SDLUnsubscribeVehicleDataResponse : SDLRPCResponse

Page 1084: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLUpdateMode

OBJECTIVE-C

+ (SDLUpdateMode *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLUpdateMode!

PARAMETERS

RETURN VALUE

Page 1085: Documentation iOS SDLAbstractProtocol Class Reference

+values

@abstract Store the enumeration of all possible SDLUpdateMode - returns: an

array that store all possible SDLUpdateMode

an array that store all possible SDLUpdateMode

+COUNTUP

@abstract Starts the media clock timer counting upward, in increments of 1

second. - returns: SDLUpdateMode with value of COUNTUP

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 1086: Documentation iOS SDLAbstractProtocol Class Reference

SDLUpdateMode with value of COUNTUP

+COUNTDOWN

@abstract Starts the media clock timer counting downward, in increments of 1

second. - returns: SDLUpdateMode with value of COUNTDOWN

OBJECTIVE-C

+ (SDLUpdateMode *)COUNTUP;

SWIFT

class func countup() -> SDLUpdateMode!

RETURN VALUE

OBJECTIVE-C

+ (SDLUpdateMode *)COUNTDOWN;

Page 1087: Documentation iOS SDLAbstractProtocol Class Reference

SDLUpdateMode with value of COUNTDOWN

+PAUSE

@abstract Pauses the media clock timer. - returns: SDLUpdateMode with value

of PAUSE

SWIFT

class func countdown() -> SDLUpdateMode!

RETURN VALUE

OBJECTIVE-C

+ (SDLUpdateMode *)PAUSE;

SWIFT

class func pause() -> SDLUpdateMode!

Page 1088: Documentation iOS SDLAbstractProtocol Class Reference

SDLUpdateMode with value of PAUSE

+RESUME

@abstract Resumes the media clock timer. The timer resumes counting in

whatever mode was in effect before pausing (i.e. COUNTUP or COUNTDOWN). -

returns: SDLUpdateMode with value of RESUME

SDLUpdateMode with value of RESUME

RETURN VALUE

OBJECTIVE-C

+ (SDLUpdateMode *)RESUME;

SWIFT

class func resume() -> SDLUpdateMode!

RETURN VALUE

Page 1089: Documentation iOS SDLAbstractProtocol Class Reference

+CLEAR

@abstract Clear the media clock timer.

SDLUpdateTurnList Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithTurnList:softButtons:• turnList

OBJECTIVE-C

+ (SDLUpdateMode *)CLEAR;

SWIFT

class func clear() -> SDLUpdateMode!

Page 1090: Documentation iOS SDLAbstractProtocol Class Reference

• softButtons

Overview

Updates the list of next maneuvers, which can be requested by the user

pressing the softbutton

* “Turns” on the Navigation base screen. Three softbuttons are predefined by

the system: Up, Down, Close. *

* @since SmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLUpdateTurnList : SDLRPCRequest

OBJECTIVE-C

@interface SDLUpdateTurnList : SDLRPCRequest

Page 1091: Documentation iOS SDLAbstractProtocol Class Reference

-initWithTurnList:softButtons:

Undocumented

turnList

Optional, SDLTurn, 1 - 100 entries

OBJECTIVE-C

@interface SDLUpdateTurnList : SDLRPCRequest

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *turnList;

SWIFT

var turnList: NSMutableArray! { get set }

Page 1092: Documentation iOS SDLAbstractProtocol Class Reference

softButtons

Required, SDLSoftButton, 0 - 1 Entries

SDLUpdateTurnListResponse ClassReference

Section Contents

• -init

OBJECTIVE-C

@property (readwrite, strong, atomic) NSMutableArray *softButtons;

SWIFT

var softButtons: NSMutableArray! { get set }

Page 1093: Documentation iOS SDLAbstractProtocol Class Reference

• -initWithDictionary:

Overview

SDLUpdateTurnListResponse is sent, when SDLUpdateTurnList has been called. *

SinceSmartDeviceLink 2.0

-init

Undocumented

-initWithDictionary:

Undocumented

OBJECTIVE-C

@interface SDLUpdateTurnListResponse : SDLRPCResponse

OBJECTIVE-C

@interface SDLUpdateTurnListResponse : SDLRPCResponse

Page 1094: Documentation iOS SDLAbstractProtocol Class Reference

SDLVRCapabilities Class Reference

Section Contents

• +valueOf:• +values• +TEXT

Overview

The VR capabilities of the connected SDL platform.

@since SDL 1.0

+valueOf:

Convert String to SDLVRCapabilities - parameter: value The value of the string

to get an object for - returns: SDLVRCapabilities

OBJECTIVE-C

+ (SDLVRCapabilities *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLVRCapabilities!

Page 1095: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLVRCapabilities

+values

@abstract Store the enumeration of all possible SDLVRCapabilities - returns: an

array that store all possible SDLVRCapabilities

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 1096: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVRCapabilities

+TEXT

@abstract The SDL platform is capable of recognizing spoken text in the current

language. - returns: an SDLVRCapabilities instance pointer with value of TEXT

an SDLVRCapabilities instance pointer with value of TEXT

RETURN VALUE

OBJECTIVE-C

+ (SDLVRCapabilities *)TEXT;

SWIFT

class func text() -> SDLVRCapabilities!

RETURN VALUE

Page 1097: Documentation iOS SDLAbstractProtocol Class Reference

SDLVRHelpItem Class Reference

Section Contents

• -init• -initWithDictionary:• -initWithText:image:• -initWithText:image:position:• text• image• position

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

-initWithText:image:

Undocumented

-initWithText:image:position:

Undocumented

Page 1098: Documentation iOS SDLAbstractProtocol Class Reference

text

Undocumented

image

Undocumented

position

Undocumented

SDLVehicleDataActiveStatus ClassReference

Section Contents

• +valueOf:• +values• +INACTIVE_NOT_CONFIRMED• +INACTIVE_CONFIRMED• +ACTIVE_NOT_CONFIRMED• +ACTIVE_CONFIRMED• +FAULT

Overview

Vehicle Data Activity Status

Page 1099: Documentation iOS SDLAbstractProtocol Class Reference

+valueOf:

@abstract Convert String to SDLVehicleDataActiveStatus - parameter: value

NSString - returns: SDLVehicleDataActiveStatus

value

NSString

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLVehicleDataActiveStatus!

PARAMETERS

Page 1100: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataActiveStatus

+values

@abstract return the array that store all possible SDLVehicleDataActiveStatus

values

+INACTIVE_NOT_CONFIRMED

@abstract SDLVehicleDataActiveStatus : Inactive not confirmed

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

Page 1101: Documentation iOS SDLAbstractProtocol Class Reference

+INACTIVE_CONFIRMED

@abstract SDLVehicleDataActiveStatus : Inactive confirmed

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)INACTIVE_NOT_CONFIRMED;

SWIFT

class func inactive_NOT_CONFIRMED() -> SDLVehicleDataActiveStatus!

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)INACTIVE_CONFIRMED;

SWIFT

class func inactive_CONFIRMED() -> SDLVehicleDataActiveStatus!

Page 1102: Documentation iOS SDLAbstractProtocol Class Reference

+ACTIVE_NOT_CONFIRMED

@abstract SDLVehicleDataActiveStatus : Active not confirmed

+ACTIVE_CONFIRMED

@abstract SDLVehicleDataActiveStatus : Active confirmed

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)ACTIVE_NOT_CONFIRMED;

SWIFT

class func active_NOT_CONFIRMED() -> SDLVehicleDataActiveStatus!

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)ACTIVE_CONFIRMED;

Page 1103: Documentation iOS SDLAbstractProtocol Class Reference

+FAULT

@abstract SDLVehicleDataActiveStatus : Fault

SWIFT

class func active_CONFIRMED() -> SDLVehicleDataActiveStatus!

OBJECTIVE-C

+ (SDLVehicleDataActiveStatus *)FAULT;

SWIFT

class func fault() -> SDLVehicleDataActiveStatus!

Page 1104: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataEventStatus ClassReference

Section Contents

• +valueOf:• +values• +NO_EVENT• +_NO• +_YES• +NOT_SUPPORTED• +FAULT

Overview

Reflects the status of a vehicle data event; e.g. a seat belt event status.

@since SDL 2.0

+valueOf:

Convert String to SDLVehicleDataEventStatus

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)valueOf:(NSString *)value;

Page 1105: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLVehicleDataEventStatus

+values

@abstract Store the enumeration of all possible SDLVehicleDataEventStatus

SWIFT

class func value(of value: String!) -> SDLVehicleDataEventStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1106: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVehicleDataEventStatus

+NO_EVENT

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)NO_EVENT;

SWIFT

class func no_EVENT() -> SDLVehicleDataEventStatus!

Page 1107: Documentation iOS SDLAbstractProtocol Class Reference

The SDLVehicleDataEventStatus instance with value of NO_EVENT

+_NO

The SDLVehicleDataEventStatus instance with value of NO

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)_NO;

SWIFT

class func _NO() -> SDLVehicleDataEventStatus!

RETURN VALUE

Page 1108: Documentation iOS SDLAbstractProtocol Class Reference

+_YES

The SDLVehicleDataEventStatus instance with value of YES

+NOT_SUPPORTED

@abstract Vehicle data event is not supported

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)_YES;

SWIFT

class func _YES() -> SDLVehicleDataEventStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)NOT_SUPPORTED;

Page 1109: Documentation iOS SDLAbstractProtocol Class Reference

the SDLVehicleDataEventStatus instance with value of NOT_SUPPORTED

+FAULT

@abstract The SDLVehicleDataEventStatus instance with value of FAULT

SWIFT

class func not_SUPPORTED() -> SDLVehicleDataEventStatus!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataEventStatus *)FAULT;

SWIFT

class func fault() -> SDLVehicleDataEventStatus!

Page 1110: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataNotificationStatus ClassReference

Section Contents

• +valueOf:• +values• +NOT_SUPPORTED• +NORMAL• +ACTIVE• +NOT_USED

Overview

Reflects the status of a vehicle data notification.

@since SDL 2.0

+valueOf:

Convert String to SDLVehicleDataNotificationStatus - parameter: value The

value of the string to get an object for - returns:

SDLVehicleDataNotificationStatus

OBJECTIVE-C

+ (SDLVehicleDataNotificationStatus *)valueOf:(NSString *)value;

Page 1111: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLVehicleDataNotificationStatus

+values

@abstract Store the enumeration of all possible

SDLVehicleDataNotificationStatus - returns: an array that store all possible

SDLVehicleDataNotificationStatus

SWIFT

class func value(of value: String!) -> SDLVehicleDataNotificationStatus!

PARAMETERS

RETURN VALUE

Page 1112: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVehicleDataNotificationStatus

+NOT_SUPPORTED

@abstract SDLVehicleDataNotificationStatus: NOT_SUPPORTED

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataNotificationStatus *)NOT_SUPPORTED;

Page 1113: Documentation iOS SDLAbstractProtocol Class Reference

+NORMAL

@abstract SDLVehicleDataNotificationStatus: NORMAL

+ACTIVE

@abstract SDLVehicleDataNotificationStatus: ACTIVE

SWIFT

class func not_SUPPORTED() -> SDLVehicleDataNotificationStatus!

OBJECTIVE-C

+ (SDLVehicleDataNotificationStatus *)NORMAL;

SWIFT

class func normal() -> SDLVehicleDataNotificationStatus!

Page 1114: Documentation iOS SDLAbstractProtocol Class Reference

+NOT_USED

@abstract SDLVehicleDataNotificationStatus: NOT_USED

OBJECTIVE-C

+ (SDLVehicleDataNotificationStatus *)ACTIVE;

SWIFT

class func active() -> SDLVehicleDataNotificationStatus!

OBJECTIVE-C

+ (SDLVehicleDataNotificationStatus *)NOT_USED;

SWIFT

class func not_USED() -> SDLVehicleDataNotificationStatus!

Page 1115: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataResult Class Reference

Section Contents

• -init• -initWithDictionary:• dataType• resultCode

Overview

Undocumented

-init

Undocumented

-initWithDictionary:

Undocumented

dataType

Undocumented

resultCode

Undocumented

Page 1116: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataResultCode ClassReference

Section Contents

• +valueOf:• +values• +SUCCESS• +TRUNCATED_DATA• +DISALLOWED• +USER_DISALLOWED• +INVALID_ID• +VEHICLE_DATA_NOT_AVAILABLE• +DATA_ALREADY_SUBSCRIBED• +DATA_NOT_SUBSCRIBED• +IGNORED

Overview

Vehicle Data Result Code

+valueOf:

Convert String to SDLVehicleDataResultCode - parameter: value String - returns:

SDLVehicleDataResultCode

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)valueOf:(NSString *)value;

Page 1117: Documentation iOS SDLAbstractProtocol Class Reference

value

String

SDLVehicleDataResultCode

+values

@abstract Store the enumeration of all possible SDLVehicleDataResultCode -

returns: an array that store all possible SDLVehicleDataResultCode

SWIFT

class func value(of value: String!) -> SDLVehicleDataResultCode!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1118: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVehicleDataResultCode

+SUCCESS

Individual vehicle data item / DTC / DID request or subscription successful

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)SUCCESS;

SWIFT

class func success() -> SDLVehicleDataResultCode!

Page 1119: Documentation iOS SDLAbstractProtocol Class Reference

+TRUNCATED_DATA

DTC / DID request successful, however, not all active DTCs or full contents of

DID location available

+DISALLOWED

This vehicle data item is not allowed for this app by SDL

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)TRUNCATED_DATA;

SWIFT

class func truncated_DATA() -> SDLVehicleDataResultCode!

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)DISALLOWED;

Page 1120: Documentation iOS SDLAbstractProtocol Class Reference

+USER_DISALLOWED

The user has not granted access to this type of vehicle data item at this time

+INVALID_ID

The ECU ID referenced is not a valid ID on the bus / system

SWIFT

class func disallowed() -> SDLVehicleDataResultCode!

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)USER_DISALLOWED;

SWIFT

class func user_DISALLOWED() -> SDLVehicleDataResultCode!

Page 1121: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLE_DATA_NOT_AVAILABLE

The requested vehicle data item / DTC / DID is not currently available or

responding on the bus / system

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)INVALID_ID;

SWIFT

class func invalid_ID() -> SDLVehicleDataResultCode!

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)VEHICLE_DATA_NOT_AVAILABLE;

SWIFT

class func vehicle_DATA_NOT_AVAILABLE() -> SDLVehicleDataResultCode!

Page 1122: Documentation iOS SDLAbstractProtocol Class Reference

+DATA_ALREADY_SUBSCRIBED

The vehicle data item is already subscribed

+DATA_NOT_SUBSCRIBED

The vehicle data item cannot be unsubscribed because it is not currently

subscribed

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)DATA_ALREADY_SUBSCRIBED;

SWIFT

class func data_ALREADY_SUBSCRIBED() -> SDLVehicleDataResultCode!

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)DATA_NOT_SUBSCRIBED;

Page 1123: Documentation iOS SDLAbstractProtocol Class Reference

+IGNORED

The request for this item is ignored because it is already in progress

SWIFT

class func data_NOT_SUBSCRIBED() -> SDLVehicleDataResultCode!

OBJECTIVE-C

+ (SDLVehicleDataResultCode *)IGNORED;

SWIFT

class func ignored() -> SDLVehicleDataResultCode!

Page 1124: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataStatus Class Reference

Section Contents

• +valueOf:• +values• +NO_DATA_EXISTS• +OFF• +ON

Overview

Reflects the status of a binary vehicle data item.

@since SDL 2.0

+valueOf:

Convert String to SDLVehicleDataStatus - parameter: value The value of the

string to get an object for - returns: SDLVehicleDataStatus

OBJECTIVE-C

+ (SDLVehicleDataStatus *)valueOf:(NSString *)value;

Page 1125: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLVehicleDataStatus

+values

@abstract Store the enumeration of all possible SDLVehicleDataStatus - returns:

an array that store all possible SDLVehicleDataStatus

SWIFT

class func value(of value: String!) -> SDLVehicleDataStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1126: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVehicleDataStatus

+NO_DATA_EXISTS

@abstract No data avaliable - returns: SDLVehicleDataStatus: NO_DATA_EXISTS

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataStatus *)NO_DATA_EXISTS;

SWIFT

class func no_DATA_EXISTS() -> SDLVehicleDataStatus!

Page 1127: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataStatus: NO_DATA_EXISTS

+OFF

@abstract return SDLVehicleDataStatus: OFF

+ON

@abstract return SDLVehicleDataStatus: ON

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataStatus *)OFF;

SWIFT

class func off() -> SDLVehicleDataStatus!

Page 1128: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleDataType Class Reference

Section Contents

• +valueOf:• +values• +VEHICLEDATA_GPS• +VEHICLEDATA_SPEED• +VEHICLEDATA_RPM• +VEHICLEDATA_FUELLEVEL• +VEHICLEDATA_FUELLEVEL_STATE• +VEHICLEDATA_FUELCONSUMPTION• +VEHICLEDATA_EXTERNTEMP• +VEHICLEDATA_VIN• +VEHICLEDATA_PRNDL• +VEHICLEDATA_TIREPRESSURE

OBJECTIVE-C

+ (SDLVehicleDataStatus *)ON;

SWIFT

class func on() -> SDLVehicleDataStatus!

Page 1129: Documentation iOS SDLAbstractProtocol Class Reference

• +VEHICLEDATA_ODOMETER• +VEHICLEDATA_BELTSTATUS• +VEHICLEDATA_BODYINFO• +VEHICLEDATA_DEVICESTATUS• +VEHICLEDATA_ECALLINFO• +VEHICLEDATA_AIRBAGSTATUS• +VEHICLEDATA_EMERGENCYEVENT• +VEHICLEDATA_CLUSTERMODESTATUS• +VEHICLEDATA_MYKEY• +VEHICLEDATA_BRAKING• +VEHICLEDATA_WIPERSTATUS• +VEHICLEDATA_HEADLAMPSTATUS• +VEHICLEDATA_BATTVOLTAGE• +VEHICLEDATA_ENGINETORQUE• +VEHICLEDATA_ACCPEDAL• +VEHICLEDATA_STEERINGWHEEL

Overview

Defines the vehicle data types that can be published and/or subscribed to using

SDLSubscribeVehicleData

+valueOf:

Convert String to SDLVehicleDataType

OBJECTIVE-C

+ (SDLVehicleDataType *)valueOf:(NSString *)value;

Page 1130: Documentation iOS SDLAbstractProtocol Class Reference

value

String value to retrieve the object for

SDLVehicleDataType

+values

@abstract Store the enumeration of all possible SDLVehicleDataType

SWIFT

class func value(of value: String!) -> SDLVehicleDataType!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1131: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLVehicleDataType

+VEHICLEDATA_GPS

@abstract SDLVehicleDataType: VEHICLEDATA_GPS

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_GPS;

SWIFT

class func vehicledata_GPS() -> SDLVehicleDataType!

Page 1132: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_SPEED

@abstract SDLVehicleDataType: VEHICLEDATA_SPEED

+VEHICLEDATA_RPM

@abstract SDLVehicleDataType: VEHICLEDATA_RPM

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_SPEED;

SWIFT

class func vehicledata_SPEED() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_RPM;

Page 1133: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_FUELLEVEL

@abstract SDLVehicleDataType: VEHICLEDATA_FUELLEVEL

+VEHICLEDATA_FUELLEVEL_STATE

@abstract SDLVehicleDataType: VEHICLEDATA_FUELLEVEL_STATE

SWIFT

class func vehicledata_RPM() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_FUELLEVEL;

SWIFT

class func vehicledata_FUELLEVEL() -> SDLVehicleDataType!

Page 1134: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_FUELCONSUMPTION

@abstract SDLVehicleDataType: VEHICLEDATA_FUELCONSUMPTION

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_FUELLEVEL_STATE;

SWIFT

class func vehicledata_FUELLEVEL_STATE() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_FUELCONSUMPTION;

SWIFT

class func vehicledata_FUELCONSUMPTION() -> SDLVehicleDataType!

Page 1135: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_EXTERNTEMP

@abstract SDLVehicleDataType: VEHICLEDATA_EXTERNTEMP

+VEHICLEDATA_VIN

@abstract SDLVehicleDataType: VEHICLEDATA_VIN

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_EXTERNTEMP;

SWIFT

class func vehicledata_EXTERNTEMP() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_VIN;

Page 1136: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_PRNDL

@abstract SDLVehicleDataType: VEHICLEDATA_PRNDL

+VEHICLEDATA_TIREPRESSURE

@abstract SDLVehicleDataType: VEHICLEDATA_TIREPRESSURE

SWIFT

class func vehicledata_VIN() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_PRNDL;

SWIFT

class func vehicledata_PRNDL() -> SDLVehicleDataType!

Page 1137: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_ODOMETER

@abstract SDLVehicleDataType: VEHICLEDATA_ODOMETER

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_TIREPRESSURE;

SWIFT

class func vehicledata_TIREPRESSURE() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_ODOMETER;

SWIFT

class func vehicledata_ODOMETER() -> SDLVehicleDataType!

Page 1138: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_BELTSTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_BELTSTATUS

+VEHICLEDATA_BODYINFO

@abstract SDLVehicleDataType: VEHICLEDATA_BODYINFO

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_BELTSTATUS;

SWIFT

class func vehicledata_BELTSTATUS() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_BODYINFO;

Page 1139: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_DEVICESTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_DEVICESTATUS

+VEHICLEDATA_ECALLINFO

@abstract SDLVehicleDataType: VEHICLEDATA_ECALLINFO

SWIFT

class func vehicledata_BODYINFO() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_DEVICESTATUS;

SWIFT

class func vehicledata_DEVICESTATUS() -> SDLVehicleDataType!

Page 1140: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_AIRBAGSTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_AIRBAGSTATUS

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_ECALLINFO;

SWIFT

class func vehicledata_ECALLINFO() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_AIRBAGSTATUS;

SWIFT

class func vehicledata_AIRBAGSTATUS() -> SDLVehicleDataType!

Page 1141: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_EMERGENCYEVENT

@abstract SDLVehicleDataType: VEHICLEDATA_EMERGENCYEVENT

+VEHICLEDATA_CLUSTERMODESTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_CLUSTERMODESTATUS

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_EMERGENCYEVENT;

SWIFT

class func vehicledata_EMERGENCYEVENT() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_CLUSTERMODESTATUS;

Page 1142: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_MYKEY

@abstract SDLVehicleDataType: VEHICLEDATA_MYKEY

+VEHICLEDATA_BRAKING

@abstract SDLVehicleDataType: VEHICLEDATA_BRAKING

SWIFT

class func vehicledata_CLUSTERMODESTATUS() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_MYKEY;

SWIFT

class func vehicledata_MYKEY() -> SDLVehicleDataType!

Page 1143: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_WIPERSTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_WIPERSTATUS

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_BRAKING;

SWIFT

class func vehicledata_BRAKING() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_WIPERSTATUS;

SWIFT

class func vehicledata_WIPERSTATUS() -> SDLVehicleDataType!

Page 1144: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_HEADLAMPSTATUS

@abstract SDLVehicleDataType: VEHICLEDATA_HEADLAMPSTATUS

+VEHICLEDATA_BATTVOLTAGE

@abstract SDLVehicleDataType: VEHICLEDATA_BATTVOLTAGE

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_HEADLAMPSTATUS;

SWIFT

class func vehicledata_HEADLAMPSTATUS() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_BATTVOLTAGE;

Page 1145: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_ENGINETORQUE

@abstract SDLVehicleDataType: VEHICLEDATA_ENGINETORQUE

+VEHICLEDATA_ACCPEDAL

@abstract SDLVehicleDataType: VEHICLEDATA_ACCPEDAL

SWIFT

class func vehicledata_BATTVOLTAGE() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_ENGINETORQUE;

SWIFT

class func vehicledata_ENGINETORQUE() -> SDLVehicleDataType!

Page 1146: Documentation iOS SDLAbstractProtocol Class Reference

+VEHICLEDATA_STEERINGWHEEL

@abstract SDLVehicleDataType: VEHICLEDATA_STEERINGWHEEL

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_ACCPEDAL;

SWIFT

class func vehicledata_ACCPEDAL() -> SDLVehicleDataType!

OBJECTIVE-C

+ (SDLVehicleDataType *)VEHICLEDATA_STEERINGWHEEL;

SWIFT

class func vehicledata_STEERINGWHEEL() -> SDLVehicleDataType!

Page 1147: Documentation iOS SDLAbstractProtocol Class Reference

SDLVehicleType Class Reference

Section Contents

• -init• -initWithDictionary:• make• model• modelYear• trim

Overview

Describes the type of vehicle the mobile phone is connected with.

@since SDL 2.0

-init

@abstract Constructs a newly allocated SDLVehicleType object

OBJECTIVE-C

- (instancetype)init;

Page 1148: Documentation iOS SDLAbstractProtocol Class Reference

-initWithDictionary:

@abstract Constructs a newly allocated SDLVehicleType object indicated by the

dictionary parameter - parameter: dict The dictionary to use

dict

SWIFT

init!()

OBJECTIVE-C

- (instancetype)initWithDictionary:(NSMutableDictionary *)dict;

SWIFT

init!(dictionary dict: NSMutableDictionary!)

PARAMETERS

Page 1149: Documentation iOS SDLAbstractProtocol Class Reference

The dictionary to use

make

@abstract The make of the vehicle

@discussion For example, “Ford”, “Lincoln”, etc.

Optional, Max String length 500 chars

model

@abstract The model of the vehicle

@discussion For example, “Fiesta”, “Focus”, etc.

Optional, Max String length 500 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *make;

SWIFT

var make: String! { get set }

Page 1150: Documentation iOS SDLAbstractProtocol Class Reference

modelYear

@abstract The model year of the vehicle

@discussion For example, “2013”

Optional, Max String length 500 chars

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *model;

SWIFT

var model: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *modelYear;

Page 1151: Documentation iOS SDLAbstractProtocol Class Reference

trim

@abstract The trim of the vehicle

@discussion For example, “SE”, “SEL”

Optional, Max String length 500 chars

SWIFT

var modelYear: String! { get set }

OBJECTIVE-C

@property (readwrite, strong, atomic) NSString *trim;

SWIFT

var trim: String! { get set }

Page 1152: Documentation iOS SDLAbstractProtocol Class Reference

SDLWarningLightStatus Class Reference

Section Contents

• +valueOf:• +values• +OFF• +ON• +FLASH• +NOT_USED

Overview

Reflects the status of a cluster instrument warning light.

@since SDL 2.0

+valueOf:

Convert String to SDLWarningLightStatus - parameter: value The value of the

string to get an object for - returns: SDLWarningLightStatus

OBJECTIVE-C

+ (SDLWarningLightStatus *)valueOf:(NSString *)value;

Page 1153: Documentation iOS SDLAbstractProtocol Class Reference

value

The value of the string to get an object for

SDLWarningLightStatus

+values

@abstract Store the enumeration of all possible SDLWarningLightStatus -

returns: an array that store all possible SDLWarningLightStatus

SWIFT

class func value(of value: String!) -> SDLWarningLightStatus!

PARAMETERS

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

Page 1154: Documentation iOS SDLAbstractProtocol Class Reference

an array that store all possible SDLWarningLightStatus

+OFF

@abstract Warninglight Off - returns: SDLWarningLightStatus instance with

value of OFF

SWIFT

class func values() -> [Any]!

RETURN VALUE

OBJECTIVE-C

+ (SDLWarningLightStatus *)OFF;

SWIFT

class func off() -> SDLWarningLightStatus!

Page 1155: Documentation iOS SDLAbstractProtocol Class Reference

SDLWarningLightStatus instance with value of OFF

+ON

@abstract Warninglight On - returns: SDLWarningLightStatus instance with

value of ON

SDLWarningLightStatus instance with value of ON

RETURN VALUE

OBJECTIVE-C

+ (SDLWarningLightStatus *)ON;

SWIFT

class func on() -> SDLWarningLightStatus!

RETURN VALUE

Page 1156: Documentation iOS SDLAbstractProtocol Class Reference

+FLASH

@abstract Warninglight is flashing - returns: SDLWarningLightStatus instance

with value of FLASH

SDLWarningLightStatus instance with value of FLASH

+NOT_USED

@abstract Not used - returns: SDLWarningLightStatus instance with value of

NOT_USED

OBJECTIVE-C

+ (SDLWarningLightStatus *)FLASH;

SWIFT

class func flash() -> SDLWarningLightStatus!

RETURN VALUE

Page 1157: Documentation iOS SDLAbstractProtocol Class Reference

SDLWarningLightStatus instance with value of NOT_USED

SDLWaypointType Class Reference

Section Contents

• +valueOf:• +values• +ALL

OBJECTIVE-C

+ (SDLWarningLightStatus *)NOT_USED;

SWIFT

class func not_USED() -> SDLWarningLightStatus!

RETURN VALUE

Page 1158: Documentation iOS SDLAbstractProtocol Class Reference

• +DESTINATION

Overview

Undocumented

+valueOf:

@abstract Convert String to SDLWayPointType

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLWaypointType *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLWaypointType!

PARAMETERS

Page 1159: Documentation iOS SDLAbstractProtocol Class Reference

SDLWayPointType

+values

@abstract Store the enumeration of all possible SDLWayPointType

an array that store all possible SDLWayPointType

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 1160: Documentation iOS SDLAbstractProtocol Class Reference

+ALL

a SDLWayPointType with value of PROMPT

+DESTINATION

OBJECTIVE-C

+ (SDLWaypointType *)ALL;

SWIFT

class func all() -> SDLWaypointType!

RETURN VALUE

OBJECTIVE-C

+ (SDLWaypointType *)DESTINATION;

Page 1161: Documentation iOS SDLAbstractProtocol Class Reference

a SDLWayPointType with value of DESTINATION

SDLWiperStatus Class Reference

Section Contents

• +valueOf:• +values• +OFF• +AUTO_OFF• +OFF_MOVING• +MAN_INT_OFF• +MAN_INT_ON• +MAN_LOW• +MAN_HIGH• +MAN_FLICK• +WASH• +AUTO_LOW• +AUTO_HIGH• +COURTESYWIPE

SWIFT

class func destination() -> SDLWaypointType!

RETURN VALUE

Page 1162: Documentation iOS SDLAbstractProtocol Class Reference

• +AUTO_ADJUST• +STALLED• +NO_DATA_EXISTS

Overview

Wiper Status

+valueOf:

Convert String to SDLWiperStatus - parameter: value The value of the string to

get an object for - returns: SDLWiperStatus

value

The value of the string to get an object for

OBJECTIVE-C

+ (SDLWiperStatus *)valueOf:(NSString *)value;

SWIFT

class func value(of value: String!) -> SDLWiperStatus!

PARAMETERS

Page 1163: Documentation iOS SDLAbstractProtocol Class Reference

SDLWiperStatus

+values

@abstract Store the enumeration of all possible SDLWiperStatus - returns: An

array that store all possible SDLWiperStatus

An array that store all possible SDLWiperStatus

RETURN VALUE

OBJECTIVE-C

+ (NSArray *)values;

SWIFT

class func values() -> [Any]!

RETURN VALUE

Page 1164: Documentation iOS SDLAbstractProtocol Class Reference

+OFF

@abstract SDLWiperStatus: OFF

+AUTO_OFF

@abstract SDLWiperStatus: AUTO_OFF

OBJECTIVE-C

+ (SDLWiperStatus *)OFF;

SWIFT

class func off() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)AUTO_OFF;

Page 1165: Documentation iOS SDLAbstractProtocol Class Reference

+OFF_MOVING

@abstract SDLWiperStatus: OFF_MOVING

+MAN_INT_OFF

@abstract SDLWiperStatus: MAN_INT_OFF

SWIFT

class func auto_OFF() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)OFF_MOVING;

SWIFT

class func off_MOVING() -> SDLWiperStatus!

Page 1166: Documentation iOS SDLAbstractProtocol Class Reference

+MAN_INT_ON

@abstract SDLWiperStatus: MAN_INT_ON

OBJECTIVE-C

+ (SDLWiperStatus *)MAN_INT_OFF;

SWIFT

class func man_INT_OFF() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)MAN_INT_ON;

SWIFT

class func man_INT_ON() -> SDLWiperStatus!

Page 1167: Documentation iOS SDLAbstractProtocol Class Reference

+MAN_LOW

@abstract SDLWiperStatus: MAN_LOW

+MAN_HIGH

@abstract SDLWiperStatus: MAN_HIGH

OBJECTIVE-C

+ (SDLWiperStatus *)MAN_LOW;

SWIFT

class func man_LOW() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)MAN_HIGH;

Page 1168: Documentation iOS SDLAbstractProtocol Class Reference

+MAN_FLICK

@abstract SDLWiperStatus: MAN_FLICK

+WASH

@abstract SDLWiperStatus: WASH

SWIFT

class func man_HIGH() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)MAN_FLICK;

SWIFT

class func man_FLICK() -> SDLWiperStatus!

Page 1169: Documentation iOS SDLAbstractProtocol Class Reference

+AUTO_LOW

@abstract SDLWiperStatus: AUTO_LOW

OBJECTIVE-C

+ (SDLWiperStatus *)WASH;

SWIFT

class func wash() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)AUTO_LOW;

SWIFT

class func auto_LOW() -> SDLWiperStatus!

Page 1170: Documentation iOS SDLAbstractProtocol Class Reference

+AUTO_HIGH

@abstract SDLWiperStatus: AUTO_HIGH

+COURTESYWIPE

@abstract SDLWiperStatus: COURTESYWIPE

OBJECTIVE-C

+ (SDLWiperStatus *)AUTO_HIGH;

SWIFT

class func auto_HIGH() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)COURTESYWIPE;

Page 1171: Documentation iOS SDLAbstractProtocol Class Reference

+AUTO_ADJUST

@abstract SDLWiperStatus: AUTO_ADJUST

+STALLED

@abstract SDLWiperStatus: STALLED

SWIFT

class func courtesywipe() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)AUTO_ADJUST;

SWIFT

class func auto_ADJUST() -> SDLWiperStatus!

Page 1172: Documentation iOS SDLAbstractProtocol Class Reference

+NO_DATA_EXISTS

@abstract SDLWiperStatus: NO_DATA_EXISTS

OBJECTIVE-C

+ (SDLWiperStatus *)STALLED;

SWIFT

class func stalled() -> SDLWiperStatus!

OBJECTIVE-C

+ (SDLWiperStatus *)NO_DATA_EXISTS;

SWIFT

class func no_DATA_EXISTS() -> SDLWiperStatus!

Page 1173: Documentation iOS SDLAbstractProtocol Class Reference

SDLArtworkImageFormat EnumReference

Section Contents

• SDLArtworkImageFormatPNG• SDLArtworkImageFormatJPG

Overview

Undocumented

SDLArtworkImageFormatPNG

Undocumented

SDLArtworkImageFormatJPG

Undocumented

SDLDebugOutput Enum Reference

Section Contents

• SDLDebugOutput_All• SDLDebugOutput_DeviceConsole• SDLDebugOutput_DebugToolConsole• SDLDebugOutput_File

Page 1174: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

SDLDebugOutput_All

Undocumented

SDLDebugOutput_DeviceConsole

Undocumented

SDLDebugOutput_DebugToolConsole

Undocumented

SDLDebugOutput_File

Undocumented

SDLDebugType Enum Reference

Section Contents

• SDLDebugType_Debug• SDLDebugType_Transport_iAP• SDLDebugType_Transport_TCP• SDLDebugType_Protocol• SDLDebugType_RPC• SDLDebugType_APP

Page 1175: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

SDLDebugType_Debug

Undocumented

SDLDebugType_Transport_iAP

Undocumented

SDLDebugType_Transport_TCP

Undocumented

SDLDebugType_Protocol

Undocumented

SDLDebugType_RPC

Undocumented

SDLDebugType_APP

Undocumented

Page 1176: Documentation iOS SDLAbstractProtocol Class Reference

SDLEncryptionFlag Enum Reference

Section Contents

• SDLEncryptionFlagNone• SDLEncryptionFlagAuthenticateOnly• SDLEncryptionFlagAuthenticateAndEncrypt

Overview

Undocumented

SDLEncryptionFlagNone

Undocumented

SDLEncryptionFlagAuthenticateOnly

Undocumented

SDLEncryptionFlagAuthenticateAndEncrypt

Undocumented

SDLFileManagerError Enum Reference

Section Contents

• SDLFileManagerErrorCannotOverwrite

Page 1177: Documentation iOS SDLAbstractProtocol Class Reference

• SDLFileManagerErrorNoKnownFile• SDLFileManagerErrorUnableToStart• SDLFileManagerErrorUnableToUpload

Overview

Errors associated with the SDLFileManager class.

SDLFileManagerErrorCannotOverwrite

A file attempted to send, but a file with that name already exists on the remote

head unit, and the file was not configured to overwrite.

SDLFileManagerErrorNoKnownFile

A file was attempted to be accessed but it does not exist.

OBJECTIVE-C

SDLFileManagerErrorCannotOverwrite = -1

SWIFT

case cannotOverwrite = -1

Page 1178: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileManagerErrorUnableToStart

The file manager attempted to start but encountered an error.

OBJECTIVE-C

SDLFileManagerErrorNoKnownFile = -2

SWIFT

case noKnownFile = -2

OBJECTIVE-C

SDLFileManagerErrorUnableToStart = -3

SWIFT

case unableToStart = -3

Page 1179: Documentation iOS SDLAbstractProtocol Class Reference

SDLFileManagerErrorUnableToUpload

The file manager was unable to send this file.

SDLFrameData Enum Reference

Section Contents

• SDLFrameData_Heartbeat• SDLFrameData_StartSession• SDLFrameData_StartSessionACK• SDLFrameData_StartSessionNACK• SDLFrameData_EndSession• SDLFrameData_EndSessionACK• SDLFrameData_EndSessionNACK• SDLFrameData_ServiceDataACK

OBJECTIVE-C

SDLFileManagerErrorUnableToUpload = -4

SWIFT

case unableToUpload = -4

Page 1180: Documentation iOS SDLAbstractProtocol Class Reference

• SDLFrameData_HeartbeatACK• SDLFrameData_SingleFrame• SDLFrameData_FirstFrame• SDLFrameData_ConsecutiveLastFrame

Overview

Undocumented

SDLFrameData_Heartbeat

Undocumented

SDLFrameData_StartSession

Undocumented

SDLFrameData_StartSessionACK

Undocumented

SDLFrameData_StartSessionNACK

Undocumented

SDLFrameData_EndSession

Undocumented

SDLFrameData_EndSessionACK

Undocumented

Page 1181: Documentation iOS SDLAbstractProtocol Class Reference

SDLFrameData_EndSessionNACK

Undocumented

SDLFrameData_ServiceDataACK

Undocumented

SDLFrameData_HeartbeatACK

Undocumented

SDLFrameData_SingleFrame

Undocumented

SDLFrameData_FirstFrame

Undocumented

SDLFrameData_ConsecutiveLastFrame

Undocumented

SDLFrameType Enum Reference

Section Contents

• SDLFrameType_Control• SDLFrameType_Single• SDLFrameType_First

Page 1182: Documentation iOS SDLAbstractProtocol Class Reference

• SDLFrameType_Consecutive

Overview

Undocumented

SDLFrameType_Control

Undocumented

SDLFrameType_Single

Undocumented

SDLFrameType_First

Undocumented

SDLFrameType_Consecutive

Undocumented

SDLLogOutput Enum Reference

Section Contents

• SDLLogOutputNone• SDLLogOutputConsole• SDLLogOutputFile

Page 1183: Documentation iOS SDLAbstractProtocol Class Reference

• SDLLogOutputSiphon

Overview

Undocumented

SDLLogOutputNone

Undocumented

SDLLogOutputConsole

Undocumented

SDLLogOutputFile

Undocumented

SDLLogOutputSiphon

Undocumented

SDLManagerError Enum Reference

Section Contents

• SDLManagerErrorRPCRequestFailed• SDLManagerErrorNotConnected• SDLManagerErrorNotReady• SDLManagerErrorUnknownRemoteError• SDLManagerErrorManagersFailedToStart• SDLManagerErrorRegistrationFailed

Page 1184: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Errors associated with the SDLManager class.

SDLManagerErrorRPCRequestFailed

An RPC request failed to send.

SDLManagerErrorNotConnected

Some action was attempted that requires a connection to the remote head unit.

OBJECTIVE-C

SDLManagerErrorRPCRequestFailed = -1

SWIFT

case rpcRequestFailed = -1

OBJECTIVE-C

SDLManagerErrorNotConnected = -2

Page 1185: Documentation iOS SDLAbstractProtocol Class Reference

SDLManagerErrorNotReady

Some action was attempted before the ready state was reached.

SDLManagerErrorUnknownRemoteError

The remote system encountered an unknown error.

SWIFT

case notConnected = -2

OBJECTIVE-C

SDLManagerErrorNotReady = -3

SWIFT

case notReady = -3

Page 1186: Documentation iOS SDLAbstractProtocol Class Reference

SDLManagerErrorManagersFailedToStart

One or more of the sub-managers failed to start.

OBJECTIVE-C

SDLManagerErrorUnknownRemoteError = -4

SWIFT

case unknownRemoteError = -4

OBJECTIVE-C

SDLManagerErrorManagersFailedToStart = -5

SWIFT

case managersFailedToStart = -5

Page 1187: Documentation iOS SDLAbstractProtocol Class Reference

SDLManagerErrorRegistrationFailed

Registering with the remote system failed.

SDLPermissionGroupStatus EnumReference

Section Contents

• SDLPermissionGroupStatusAllowed• SDLPermissionGroupStatusDisallowed• SDLPermissionGroupStatusMixed

OBJECTIVE-C

SDLManagerErrorRegistrationFailed = -6

SWIFT

case registrationFailed = -6

Page 1188: Documentation iOS SDLAbstractProtocol Class Reference

• SDLPermissionGroupStatusUnknown

Overview

The status of the group of RPCs permissions.

SDLPermissionGroupStatusAllowed

Every RPC in the group is currently allowed.

SDLPermissionGroupStatusDisallowed

Every RPC in the group is currently disallowed.

OBJECTIVE-C

SDLPermissionGroupStatusAllowed

SWIFT

case allowed = 0

OBJECTIVE-C

SDLPermissionGroupStatusDisallowed

Page 1189: Documentation iOS SDLAbstractProtocol Class Reference

SDLPermissionGroupStatusMixed

Some RPCs in the group are allowed and some disallowed.

SDLPermissionGroupStatusUnknown

The current status of the group is unknown.

SWIFT

case disallowed = 1

OBJECTIVE-C

SDLPermissionGroupStatusMixed

SWIFT

case mixed = 2

Page 1190: Documentation iOS SDLAbstractProtocol Class Reference

SDLPermissionGroupType EnumReference

Section Contents

• SDLPermissionGroupTypeAllAllowed• SDLPermissionGroupTypeAny

Overview

A permission group type which will be used to tell the system what type of

changes you want to be notified about for the group.

OBJECTIVE-C

SDLPermissionGroupStatusUnknown

SWIFT

case unknown = 3

Page 1191: Documentation iOS SDLAbstractProtocol Class Reference

SDLPermissionGroupTypeAllAllowed

Be notified when all of the RPC in the group are allowed, or, when they all stop

being allowed in some sense, that is, when they were all allowed, and now they

are not.

SDLPermissionGroupTypeAny

Be notified when any change in availability occurs among the group.

OBJECTIVE-C

SDLPermissionGroupTypeAllAllowed

SWIFT

case allAllowed = 0

OBJECTIVE-C

SDLPermissionGroupTypeAny

Page 1192: Documentation iOS SDLAbstractProtocol Class Reference

SDLProtocolError Enum Reference

Section Contents

• SDLProtocolErrorNoSecurityManager

Overview

Undocumented

SDLProtocolErrorNoSecurityManager

Undocumented

SDLRPCMessageType Enum Reference

Section Contents

• SDLRPCMessageTypeRequest• SDLRPCMessageTypeResponse

SWIFT

case any = 1

Page 1193: Documentation iOS SDLAbstractProtocol Class Reference

• SDLRPCMessageTypeNotification

Overview

Undocumented

SDLRPCMessageTypeRequest

Undocumented

SDLRPCMessageTypeResponse

Undocumented

SDLRPCMessageTypeNotification

Undocumented

SDLServiceType Enum Reference

Section Contents

• SDLServiceType_Control• SDLServiceType_RPC• SDLServiceType_Audio• SDLServiceType_Video• SDLServiceType_BulkData

Overview

Undocumented

Page 1194: Documentation iOS SDLAbstractProtocol Class Reference

SDLServiceType_Control

Undocumented

SDLServiceType_RPC

Undocumented

SDLServiceType_Audio

Undocumented

SDLServiceType_Video

Undocumented

SDLServiceType_BulkData

Undocumented

SDLStreamingAudioError EnumReference

Section Contents

• SDLStreamingAudioErrorHeadUnitNACK

Overview

Undocumented

Page 1195: Documentation iOS SDLAbstractProtocol Class Reference

SDLStreamingAudioErrorHeadUnitNACK

Undocumented

SDLStreamingVideoError EnumReference

Section Contents

• SDLStreamingVideoErrorHeadUnitNACK• SDLSTreamingVideoErrorInvalidOperatingSystemVersion• SDLStreamingVideoErrorInvalidOperatingSystemVersion• SDLStreamingVideoErrorConfigurationCompressionSessionCreationFailure• SDLStreamingVideoErrorConfigurationAllocationFailure• SDLStreamingVideoErrorConfigurationCompressionSessionSetPropertyFailure

Overview

Undocumented

SDLStreamingVideoErrorHeadUnitNACK

Undocumented

SDLSTreamingVideoErrorInvalidOperatingSystemVersion

Undocumented

SDLStreamingVideoErrorInvalidOperatingSystemVersion

Undocumented

Page 1196: Documentation iOS SDLAbstractProtocol Class Reference

SDLStreamingVideoErrorConfigurationCompressionSessionCreationFailure

Undocumented

SDLStreamingVideoErrorConfigurationAllocationFailure

Undocumented

SDLStreamingVideoErrorConfigurationCompressionSessionSetPropertyFailure

Undocumented

SDLDebugToolConsole ProtocolReference

Section Contents

• -logInfo:

Overview

Undocumented

-logInfo:

Undocumented

Page 1197: Documentation iOS SDLAbstractProtocol Class Reference

SDLIAPSessionDelegate ProtocolReference

Section Contents

• -onSessionInitializationCompleteForSession:• -onSessionStreamsEnded:

Overview

Undocumented

-onSessionInitializationCompleteForSession:

Undocumented

-onSessionStreamsEnded:

Undocumented

SDLManagerDelegate ProtocolReference

Section Contents

• -managerDidDisconnect• -hmiLevel:didChangeToLevel:

Page 1198: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

-managerDidDisconnect

Called upon a disconnection from the remote system.

-hmiLevel:didChangeToLevel:

Called when the HMI level state of this application changes on the remote

system. This is equivalent to the application’s state changes in iOS such as

foreground, background, or closed.

OBJECTIVE-C

- (void)managerDidDisconnect;

SWIFT

func managerDidDisconnect()

Page 1199: Documentation iOS SDLAbstractProtocol Class Reference

oldLevel

The previous level which has now been left.

newLevel

The current level.

OBJECTIVE-C

- (void)hmiLevel:(nonnull SDLHMILevel *)oldLevel didChangeToLevel:(nonnull SDLHMILevel *)newLevel;

SWIFT

func hmiLevel(_ oldLevel: SDLHMILevel, didChangeTo newLevel: SDLHMILevel)

PARAMETERS

Page 1200: Documentation iOS SDLAbstractProtocol Class Reference

SDLProtocolListener Protocol Reference

Section Contents

• -handleProtocolStartSessionACK:sessionID:version:• -handleProtocolStartSessionACK:• -handleProtocolStartSessionNACK:• -handleProtocolEndSessionACK:• -handleProtocolEndSessionNACK:• -handleHeartbeatForSession:• -handleHeartbeatACK• -onProtocolMessageReceived:• -onProtocolOpened• -onProtocolClosed• -onError:exception:

Overview

Undocumented

-handleProtocolStartSessionACK:sessionID:version:

Undocumented

-handleProtocolStartSessionACK:

Undocumented

-handleProtocolStartSessionNACK:

Undocumented

Page 1201: Documentation iOS SDLAbstractProtocol Class Reference

-handleProtocolEndSessionACK:

Undocumented

-handleProtocolEndSessionNACK:

Undocumented

-handleHeartbeatForSession:

Undocumented

-handleHeartbeatACK

Undocumented

-onProtocolMessageReceived:

Undocumented

-onProtocolOpened

Undocumented

-onProtocolClosed

Undocumented

-onError:exception:

Undocumented

Page 1202: Documentation iOS SDLAbstractProtocol Class Reference

SDLProxyListener Protocol Reference

Section Contents

• -onOnDriverDistraction:• -onOnHMIStatus:• -onProxyClosed• -onProxyOpened• -onAddCommandResponse:• -onAddSubMenuResponse:• -onAlertManeuverResponse:• -onAlertResponse:• -onChangeRegistrationResponse:• -onCreateInteractionChoiceSetResponse:• -onDeleteCommandResponse:• -onDeleteFileResponse:• -onDeleteInteractionChoiceSetResponse:• -onDeleteSubMenuResponse:• -onDiagnosticMessageResponse:• -onDialNumberResponse:• -onEncodedSyncPDataResponse:• -onEndAudioPassThruResponse:• -onError:• -onGenericResponse:• -onGetDTCsResponse:• -onGetVehicleDataResponse:• -onGetWayPointsResponse:• -onListFilesResponse:• -onReceivedLockScreenIcon:• -onOnAppInterfaceUnregistered:• -onOnAudioPassThru:• -onOnButtonEvent:• -onOnButtonPress:• -onOnCommand:• -onOnEncodedSyncPData:

Page 1203: Documentation iOS SDLAbstractProtocol Class Reference

• -onOnHashChange:• -onOnKeyboardInput:• -onOnLanguageChange:• -onOnLockScreenNotification:• -onOnPermissionsChange:• -onOnSyncPData:• -onOnSystemRequest:• -onOnTBTClientState:• -onOnTouchEvent:• -onOnVehicleData:• -onOnWayPointChange:• -onPerformAudioPassThruResponse:• -onPerformInteractionResponse:• -onPutFileResponse:• -onReadDIDResponse:• -onRegisterAppInterfaceResponse:• -onResetGlobalPropertiesResponse:• -onScrollableMessageResponse:• -onSendLocationResponse:• -onSetAppIconResponse:• -onSetDisplayLayoutResponse:• -onSetGlobalPropertiesResponse:• -onSetMediaClockTimerResponse:• -onShowConstantTBTResponse:• -onShowResponse:• -onSliderResponse:• -onSpeakResponse:• -onSubscribeButtonResponse:• -onSubscribeVehicleDataResponse:• -onSubscribeWayPointsResponse:• -onSyncPDataResponse:• -onUpdateTurnListResponse:• -onUnregisterAppInterfaceResponse:• -onUnsubscribeButtonResponse:• -onUnsubscribeVehicleDataResponse:

Page 1204: Documentation iOS SDLAbstractProtocol Class Reference

• -onUnsubscribeWayPointsResponse:

Overview

Undocumented

-onOnDriverDistraction:

Undocumented

-onOnHMIStatus:

Undocumented

-onProxyClosed

Undocumented

-onProxyOpened

Undocumented

-onAddCommandResponse:

Undocumented

-onAddSubMenuResponse:

Undocumented

-onAlertManeuverResponse:

Undocumented

Page 1205: Documentation iOS SDLAbstractProtocol Class Reference

-onAlertResponse:

Undocumented

-onChangeRegistrationResponse:

Undocumented

-onCreateInteractionChoiceSetResponse:

Undocumented

-onDeleteCommandResponse:

Undocumented

-onDeleteFileResponse:

Undocumented

-onDeleteInteractionChoiceSetResponse:

Undocumented

-onDeleteSubMenuResponse:

Undocumented

-onDiagnosticMessageResponse:

Undocumented

Page 1206: Documentation iOS SDLAbstractProtocol Class Reference

-onDialNumberResponse:

Undocumented

-onEncodedSyncPDataResponse:

Undocumented

-onEndAudioPassThruResponse:

Undocumented

-onError:

Undocumented

-onGenericResponse:

Undocumented

-onGetDTCsResponse:

Undocumented

-onGetVehicleDataResponse:

Undocumented

-onGetWayPointsResponse:

Undocumented

Page 1207: Documentation iOS SDLAbstractProtocol Class Reference

-onListFilesResponse:

Undocumented

-onReceivedLockScreenIcon:

Undocumented

-onOnAppInterfaceUnregistered:

Undocumented

-onOnAudioPassThru:

Undocumented

-onOnButtonEvent:

Undocumented

-onOnButtonPress:

Undocumented

-onOnCommand:

Undocumented

-onOnEncodedSyncPData:

Undocumented

Page 1208: Documentation iOS SDLAbstractProtocol Class Reference

-onOnHashChange:

Undocumented

-onOnKeyboardInput:

Undocumented

-onOnLanguageChange:

Undocumented

-onOnLockScreenNotification:

Undocumented

-onOnPermissionsChange:

Undocumented

-onOnSyncPData:

Undocumented

-onOnSystemRequest:

Undocumented

-onOnTBTClientState:

Undocumented

Page 1209: Documentation iOS SDLAbstractProtocol Class Reference

-onOnTouchEvent:

Undocumented

-onOnVehicleData:

Undocumented

-onOnWayPointChange:

Undocumented

-onPerformAudioPassThruResponse:

Undocumented

-onPerformInteractionResponse:

Undocumented

-onPutFileResponse:

Undocumented

-onReadDIDResponse:

Undocumented

-onRegisterAppInterfaceResponse:

Undocumented

Page 1210: Documentation iOS SDLAbstractProtocol Class Reference

-onResetGlobalPropertiesResponse:

Undocumented

-onScrollableMessageResponse:

Undocumented

-onSendLocationResponse:

Undocumented

-onSetAppIconResponse:

Undocumented

-onSetDisplayLayoutResponse:

Undocumented

-onSetGlobalPropertiesResponse:

Undocumented

-onSetMediaClockTimerResponse:

Undocumented

-onShowConstantTBTResponse:

Undocumented

Page 1211: Documentation iOS SDLAbstractProtocol Class Reference

-onShowResponse:

Undocumented

-onSliderResponse:

Undocumented

-onSpeakResponse:

Undocumented

-onSubscribeButtonResponse:

Undocumented

-onSubscribeVehicleDataResponse:

Undocumented

-onSubscribeWayPointsResponse:

Undocumented

-onSyncPDataResponse:

Undocumented

-onUpdateTurnListResponse:

Undocumented

Page 1212: Documentation iOS SDLAbstractProtocol Class Reference

-onUnregisterAppInterfaceResponse:

Undocumented

-onUnsubscribeButtonResponse:

Undocumented

-onUnsubscribeVehicleDataResponse:

Undocumented

-onUnsubscribeWayPointsResponse:

Undocumented

SDLRequestHandler Protocol Reference

Section Contents

• handler• -initWithHandler:

Overview

Undocumented

handler

The handler that is added to any RPC implementing this protocol.

Page 1213: Documentation iOS SDLAbstractProtocol Class Reference

-initWithHandler:

A special init function on any RPC implementing this protocol.

OBJECTIVE-C

@property (readwrite, copy, nonatomic) SDLRPCNotificationHandler _Nonnull handler;

SWIFT

var handler: SDLRPCNotificationHandler { get set }

OBJECTIVE-C

- (nonnull instancetype)initWithHandler: (nonnull SDLRPCNotificationHandler)handler;

SWIFT

init(handler: @escaping SDLRPCNotificationHandler)

Page 1214: Documentation iOS SDLAbstractProtocol Class Reference

handler

The handler to be called at specified times, such as events for buttons.

An instance of the class implementing this protocol.

SDLSecurityType Protocol Reference

Section Contents

• appId• -initializeWithAppId:completionHandler:• -stop• -runHandshakeWithClientData:error:• -encryptData:withError:• -decryptData:withError:• +availableMakes

Overview

Undocumented

PARAMETERS

RETURN VALUE

Page 1215: Documentation iOS SDLAbstractProtocol Class Reference

appId

Undocumented

-initializeWithAppId:completionHandler:

Undocumented

-stop

Undocumented

-runHandshakeWithClientData:error:

Undocumented

-encryptData:withError:

Undocumented

-decryptData:withError:

Undocumented

+availableMakes

Undocumented

Page 1216: Documentation iOS SDLAbstractProtocol Class Reference

SDLTouchManagerDelegate ProtocolReference

Section Contents

• -touchManager:didReceiveSingleTapAtPoint:• -touchManager:didReceiveDoubleTapAtPoint:• -touchManager:panningDidStartAtPoint:• -touchManager:didReceivePanningFromPoint:toPoint:• -touchManager:panningDidEndAtPoint:• -touchManager:pinchDidStartAtCenterPoint:• -touchManager:didReceivePinchAtCenterPoint:withScale:• -touchManager:pinchDidEndAtCenterPoint:

Overview

Undocumented

-touchManager:didReceiveSingleTapAtPoint:

@abstract Single tap was received. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Location of the single

tap in the head unit’s coordinate system.

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager didReceiveSingleTapAtPoint:(CGPoint)point;

Page 1217: Documentation iOS SDLAbstractProtocol Class Reference

manager

Current initalized SDLTouchManager issuing the callback.

point

Location of the single tap in the head unit’s coordinate system.

-touchManager:didReceiveDoubleTapAtPoint:

@abstract Double tap was received. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Location of the

double tap in the head unit’s coordinate system. This is the average of the first

and second tap.

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, didReceiveSingleTapAtPoint point: Any!)

PARAMETERS

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager didReceiveDoubleTapAtPoint:(CGPoint)point;

Page 1218: Documentation iOS SDLAbstractProtocol Class Reference

manager

Current initalized SDLTouchManager issuing the callback.

point

Location of the double tap in the head unit’s coordinate system. This is

the average of the first and second tap.

-touchManager:panningDidStartAtPoint:

@abstract Panning did start. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Location of the

panning start point in the head unit’s coordinate system.

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, didReceiveDoubleTapAtPoint point: Any!)

PARAMETERS

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager panningDidStartAtPoint:(CGPoint)point;

Page 1219: Documentation iOS SDLAbstractProtocol Class Reference

manager

Current initalized SDLTouchManager issuing the callback.

point

Location of the panning start point in the head unit’s coordinate

system.

-

touchManager:didReceivePanningFromPoint:toPoint:

@abstract Panning did move. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: fromPoint Location of the

panning’s previous point in the head unit’s coordinate system. - parameter:

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, panningDidStartAtPoint point: Any!)

PARAMETERS

Page 1220: Documentation iOS SDLAbstractProtocol Class Reference

toPoint Location of the panning’s new point in the head unit’s coordinate

system.

manager

Current initalized SDLTouchManager issuing the callback.

fromPoint

Location of the panning’s previous point in the head unit’s coordinate

system.

toPoint

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager didReceivePanningFromPoint:(CGPoint)fromPoint toPoint:(CGPoint)toPoint;

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, didReceivePanningFromPoint fromPoint: Any!, toPoint: Any!)

PARAMETERS

Page 1221: Documentation iOS SDLAbstractProtocol Class Reference

Location of the panning’s new point in the head unit’s coordinate

system.

-touchManager:panningDidEndAtPoint:

@abstract Panning did end. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Location of the

panning’s end point in the head unit’s coordinate system.

manager

Current initalized SDLTouchManager issuing the callback.

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager panningDidEndAtPoint:(CGPoint)point;

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, panningDidEndAtPoint point: Any!)

PARAMETERS

Page 1222: Documentation iOS SDLAbstractProtocol Class Reference

point

Location of the panning’s end point in the head unit’s coordinate

system.

-touchManager:pinchDidStartAtCenterPoint:

@abstract Pinch did start. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Center point of the

pinch in the head unit’s coordinate system.

manager

Current initalized SDLTouchManager issuing the callback.

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager pinchDidStartAtCenterPoint:(CGPoint)point;

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, pinchDidStartAtCenterPoint point: Any!)

PARAMETERS

Page 1223: Documentation iOS SDLAbstractProtocol Class Reference

point

Center point of the pinch in the head unit’s coordinate system.

-

touchManager:didReceivePinchAtCenterPoint:withScale:

@abstract Pinch did move. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Center point of the

pinch in the head unit’s coordinate system. - parameter: scale Scale relative to

the distance between touch points.

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager didReceivePinchAtCenterPoint:(CGPoint)point withScale:(CGFloat)scale;

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, didReceivePinchAtCenterPoint point: Any!, withScale scale: Any!)

Page 1224: Documentation iOS SDLAbstractProtocol Class Reference

manager

Current initalized SDLTouchManager issuing the callback.

point

Center point of the pinch in the head unit’s coordinate system.

scale

Scale relative to the distance between touch points.

-touchManager:pinchDidEndAtCenterPoint:

@abstract Pinch did end. - parameter: manager Current initalized

SDLTouchManager issuing the callback. - parameter: point Center point of the

pinch in the head unit’s coordinate system.

PARAMETERS

OBJECTIVE-C

- (void)touchManager:(nonnull SDLTouchManager *)manager pinchDidEndAtCenterPoint:(CGPoint)point;

Page 1225: Documentation iOS SDLAbstractProtocol Class Reference

manager

Current initalized SDLTouchManager issuing the callback.

point

Center point of the pinch in the head unit’s coordinate system.

SDLTransportDelegate ProtocolReference

Section Contents

• -onTransportConnected• -onTransportDisconnected• -onDataReceived:

SWIFT

optional func touchManager(_ manager: SDLTouchManager!, pinchDidEndAtCenterPoint point: Any!)

PARAMETERS

Page 1226: Documentation iOS SDLAbstractProtocol Class Reference

Overview

Undocumented

-onTransportConnected

Undocumented

-onTransportDisconnected

Undocumented

-onDataReceived:

Undocumented