Speech · IOS API REFERENCE

DictationTranscriber.Preset

struct · iOS 26.0+ · SDK 27.1

struct Preset

Predefined transcriber configurations. You can configure a transcriber with a preset, or modify the values of a preset's properties and configure a transcriber with the modified values. You can also create your own presets by extending this type. It is not necessary to use a preset at all; you can also use the transcriber's designated initializer to completely customize its configuration. This example configures a transcriber according to the `shortDictation` preset, but adds emoji recognition: ```swift let preset = DictationTranscriber.Preset.shortDictation let transcriber = DictationTranscriber( locale: Locale.current, contentHints: preset.contentHints, transcriptionOptions: preset.transcriptionOptions.union([.emoji]) reportingOptions: preset.reportingOptions attributeOptions: preset.attributeOptions ) ``` This table lists the presets and their configurations: Preset | [shortForm](doc:ContentHint/shortForm) | [volatileResults](doc:ReportingOption/volatileResults) | [frequentFinalization](doc:ReportingOption/frequentFinalization) | [audioTimeRange](doc:ResultAttributeOption/audioTimeRange) | [punctuation](doc:TranscriptionOption/punctuation) --- | --- | --- | --- | --- | --- `phrase` | **Yes** | No | No | No | No `shortDictation` | **Yes** | No | No | No | **Yes** `progressiveShortDictation` | **Yes** | **Yes** | **Yes** | No | **Yes** `longDictation` | No | No | No | No | **Yes** `progressiveLongDictation` | No | **Yes** | No | No | **Yes** `timeIndexedLongDictation` | No | No | No | **Yes** | **Yes**

Members (15)

get · iOS 26.0+

progressiveLongDictation

TypeScript

static get progressiveLongDictation(): DictationTranscriber_Preset

Swift declaration

static let progressiveLongDictation: DictationTranscriber.Preset

Configuration for immediate transcription of lengthy audio.

get · iOS 26.0+

timeIndexedLongDictation

TypeScript

static get timeIndexedLongDictation(): DictationTranscriber_Preset

Swift declaration

static let timeIndexedLongDictation: DictationTranscriber.Preset

Configure for lengthy audio, cross-referencing words to time-codes.

get · iOS 26.0+

progressiveShortDictation

TypeScript

static get progressiveShortDictation(): DictationTranscriber_Preset

Swift declaration

static let progressiveShortDictation: DictationTranscriber.Preset

Configuration for immediate transcription of about a minute of live audio.

get · iOS 26.0+

longDictation

TypeScript

static get longDictation(): DictationTranscriber_Preset

Swift declaration

static let longDictation: DictationTranscriber.Preset

Configuration for more than a minute of audio.

get · iOS 26.0+

shortDictation

TypeScript

static get shortDictation(): DictationTranscriber_Preset

Swift declaration

static let shortDictation: DictationTranscriber.Preset

Configuration for about a minute of audio.

init · iOS 26.0+

init

TypeScript

static init(contentHints: Array<DictationTranscriber_ContentHint>, transcriptionOptions: Array<DictationTranscriber_TranscriptionOption>, reportingOptions: Array<DictationTranscriber_ReportingOption>, attributeOptions: Array<DictationTranscriber_ResultAttributeOption>): DictationTranscriber_Preset

Swift declaration

init(contentHints: Set<DictationTranscriber.ContentHint>, transcriptionOptions: Set<DictationTranscriber.TranscriptionOption>, reportingOptions: Set<DictationTranscriber.ReportingOption>, attributeOptions: Set<DictationTranscriber.ResultAttributeOption>)

Creates a preset. - Parameters: - contentHints: A selection of expected characteristics of the spoken audio. - transcriptionOptions: A selection of options relating to the text of the transcription. - reportingOptions: A selection of options relating to the transcriber's result delivery. - attributeOptions: A selection of options relating to the attributes of the transcription.

get · iOS 26.0+

contentHints

TypeScript

get contentHints(): Array<DictationTranscriber_ContentHint>

Swift declaration

var contentHints: Set<DictationTranscriber.ContentHint>

Expected characteristics of the spoken audio appropriate for this preset.

set · iOS 26.0+

contentHints

TypeScript

set contentHints(value: Array<DictationTranscriber_ContentHint>)

Swift declaration

var contentHints: Set<DictationTranscriber.ContentHint>

Expected characteristics of the spoken audio appropriate for this preset.

get · iOS 26.0+

attributeOptions

TypeScript

get attributeOptions(): Array<DictationTranscriber_ResultAttributeOption>

Swift declaration

var attributeOptions: Set<DictationTranscriber.ResultAttributeOption>

Options relating to the attributes of the transcription appropriate for this preset.

set · iOS 26.0+

attributeOptions

TypeScript

set attributeOptions(value: Array<DictationTranscriber_ResultAttributeOption>)

Swift declaration

var attributeOptions: Set<DictationTranscriber.ResultAttributeOption>

Options relating to the attributes of the transcription appropriate for this preset.

get · iOS 26.0+

reportingOptions

TypeScript

get reportingOptions(): Array<DictationTranscriber_ReportingOption>

Swift declaration

var reportingOptions: Set<DictationTranscriber.ReportingOption>

Options relating to the transcriber's result delivery appropriate for this preset.

set · iOS 26.0+

reportingOptions

TypeScript

set reportingOptions(value: Array<DictationTranscriber_ReportingOption>)

Swift declaration

var reportingOptions: Set<DictationTranscriber.ReportingOption>

Options relating to the transcriber's result delivery appropriate for this preset.

get · iOS 26.0+

transcriptionOptions

TypeScript

get transcriptionOptions(): Array<DictationTranscriber_TranscriptionOption>

Swift declaration

var transcriptionOptions: Set<DictationTranscriber.TranscriptionOption>

Options relating to the text of the transcription appropriate for this preset.

set · iOS 26.0+

transcriptionOptions

TypeScript

set transcriptionOptions(value: Array<DictationTranscriber_TranscriptionOption>)

Swift declaration

var transcriptionOptions: Set<DictationTranscriber.TranscriptionOption>

Options relating to the text of the transcription appropriate for this preset.

get · iOS 26.0+

phrase

TypeScript

static get phrase(): DictationTranscriber_Preset

Swift declaration

static let phrase: DictationTranscriber.Preset

Configuration for a short phrase without punctuation.

Skipped declarations

No declarations were skipped in this snapshot.

All Speech types →