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

SDLPerformAudioPassThru Class Reference

Section Contents

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

-initWithSamplingRate:bitsPerSample:audioType:maxDuration:

Undocumented

Objective-C

- (instancetype)initWithSamplingRate:(SDLSamplingRate)samplingRate bitsPerSample:(SDLBitsPerSample)bitsPerSample audioType:(SDLAudioType)audioType maxDuration:(UInt32)maxDuration;

Swift

init(samplingRate: SDLSamplingRate, bitsPerSample: SDLBitsPerSample, audioType: SDLAudioType, maxDuration: UInt32)

-initWithInitialPrompt:audioPassThruDisplayText1:audioPassThruDisplayText2:samplingRate:bitsPerSample:audioType:maxDuration:muteAudio:

Undocumented

Objective-C

- (instancetype)initWithInitialPrompt:(nullable NSString *)initialPrompt audioPassThruDisplayText1:(nullable NSString *)audioPassThruDisplayText1 audioPassThruDisplayText2:(nullable NSString *)audioPassThruDisplayText2 samplingRate:(SDLSamplingRate)samplingRate bitsPerSample:(SDLBitsPerSample)bitsPerSample audioType:(SDLAudioType)audioType maxDuration:(UInt32)maxDuration muteAudio:(BOOL)muteAudio;

Swift

init(initialPrompt: String?, audioPassThruDisplayText1: String?, audioPassThruDisplayText2: String?, samplingRate: SDLSamplingRate, bitsPerSample: SDLBitsPerSample, audioType: SDLAudioType, maxDuration: UInt32, muteAudio: Bool)

-initWithSamplingRate:bitsPerSample:audioType:maxDuration:audioDataHandler:

Undocumented

Objective-C

- (instancetype)initWithSamplingRate:(SDLSamplingRate)samplingRate bitsPerSample:(SDLBitsPerSample)bitsPerSample audioType:(SDLAudioType)audioType maxDuration:(UInt32)maxDuration audioDataHandler:(nullable SDLAudioPassThruHandler)audioDataHandler;

Swift

init(samplingRate: SDLSamplingRate, bitsPerSample: SDLBitsPerSample, audioType: SDLAudioType, maxDuration: UInt32, audioDataHandler: SDLAudioPassThruHandler? = nil)

-initWithInitialPrompt:audioPassThruDisplayText1:audioPassThruDisplayText2:samplingRate:bitsPerSample:audioType:maxDuration:muteAudio:audioDataHandler:

Undocumented

Objective-C

- (instancetype)initWithInitialPrompt:(nullable NSString *)initialPrompt audioPassThruDisplayText1:(nullable NSString *)audioPassThruDisplayText1 audioPassThruDisplayText2:(nullable NSString *)audioPassThruDisplayText2 samplingRate:(SDLSamplingRate)samplingRate bitsPerSample:(SDLBitsPerSample)bitsPerSample audioType:(SDLAudioType)audioType maxDuration:(UInt32)maxDuration muteAudio:(BOOL)muteAudio audioDataHandler:(nullable SDLAudioPassThruHandler)audioDataHandler;

Swift

init(initialPrompt: String?, audioPassThruDisplayText1: String?, audioPassThruDisplayText2: String?, samplingRate: SDLSamplingRate, bitsPerSample: SDLBitsPerSample, audioType: SDLAudioType, maxDuration: UInt32, muteAudio: Bool, audioDataHandler: SDLAudioPassThruHandler? = nil)

initialPrompt

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

@property (readwrite, strong, nonatomic, nullable)
    NSArray<SDLTTSChunk *> *initialPrompt;

Swift

var initialPrompt: [SDLTTSChunk]? { get set }

audioPassThruDisplayText1

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, nonatomic, nullable)
    NSString *audioPassThruDisplayText1;

Swift

var audioPassThruDisplayText1: String? { get set }

audioPassThruDisplayText2

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

Objective-C

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

Swift

var audioPassThruDisplayText2: String? { get set }

samplingRate

A samplingRate

@discussion a SamplingRate value representing a 8 or 16 or 22 or 24 khz

Objective-C

@property (readwrite, strong, nonatomic) SDLSamplingRate _Nonnull samplingRate;

Swift

var samplingRate: SDLSamplingRate { get set }

maxDuration

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, nonatomic) NSNumber<SDLInt> *_Nonnull maxDuration;

Swift

var maxDuration: NSNumber & SDLInt { get set }

bitsPerSample

the quality the audio is recorded - 8 bit or 16 bit

@discussion a BitsPerSample value representing 8 bit or 16 bit

Objective-C

@property (readwrite, strong, nonatomic) SDLBitsPerSample _Nonnull bitsPerSample;

Swift

var bitsPerSample: SDLBitsPerSample { get set }

audioType

an audioType

Objective-C

@property (readwrite, strong, nonatomic) SDLAudioType _Nonnull audioType;

Swift

var audioType: SDLAudioType { get set }

muteAudio

a Boolean value representing if the current audio source should be muted during the APT session

Objective-C

@property (readwrite, strong, nonatomic, nullable) NSNumber<SDLBool> *muteAudio;

Swift

var muteAudio: (NSNumber & SDLBool)? { get set }

audioDataHandler

A handler that will be called whenever an onAudioPassThru notification is received.

Objective-C

@property (readwrite, strong, nonatomic, nullable)
    SDLAudioPassThruHandler audioDataHandler;

Swift

var audioDataHandler: SDLAudioPassThruHandler? { get set }
View on GitHub.com
Previous Section Next Section