Microsoft Azure Start Transcription Workflow Operation
ID: microsoft-azure-start-transcription
Description
Microsoft Azure Start Transcription invokes the Azure Speech service by passing a file with an audio track to transcript.
Note: You have to configure the Microsoft Azure Transcription Service
first to make use this operation. Read the documentation how to achieve it.
Parameter Table
Configuration keys | Description | Default value | Example |
---|---|---|---|
source-flavors | The flavors of the media files to use as audio input. Only the first available track will be used. | EMPTY | presenter/delivery |
source-tags | The comma separated list of tags of the file to transcribe. | EMPTY | transcript |
skip-if-flavor-exists | If this flavor already exists in the media package, skip this operation. To be used when the media package already has a transcript file. Optional |
EMPTY | captions/source |
language | The language code to use for the transcription. Optional. If set, it will override the configuration language code. Read documentation for supported languages | EMPTY | de-DE |
audio-extraction-encoding-profile | The encoding profile to extract audio from media file for transcription. | transcription-azure.audio | audio-to-opus.transcription |
One of source-flavors or source-tags must be specified.
Examples
The example below will start the transcription on the first trimmed media file found in the media package, but only if captions/source
element doesn't exist yet. The encoding profile to extract the audio stream is custom-transcription-azure.audio
.
<!-- This operation will start the transcription job -->
<operation
id="microsoft-azure-start-transcription"
fail-on-error="true"
exception-handler-workflow="partial-error"
description="Start Microsoft Azure transcription job">
<configurations>
<configuration key="source-flavors">*/trimmed</configuration>
<!-- Skip this operation if flavor already exists. -->
<!-- Used for cases when mediapackage already has captions. -->
<configuration key="skip-if-flavor-exists">captions/source</configuration>
<configuration key="audio-extraction-encoding-profile">custom-transcription-azure.audio</configuration>
</configurations>
</operation>
The next example shows you how to create a transcription of the presenter/trimmed
media file with the language code de-DE
. The transcription will start if captions/source
element is missing.
<!-- This operation will start the transcription job -->
<operation
id="microsoft-azure-start-transcription"
fail-on-error="true"
exception-handler-workflow="partial-error"
description="Start Microsoft Azure transcription job">
<configurations>
<configuration key="source-flavors">presenter/trimmed</configuration>
<!-- Skip this operation if flavor already exists. -->
<!-- Used for cases when mediapackage already has captions. -->
<configuration key="skip-if-flavor-exists">captions/source</configuration>
<configuration key="language">de-DE</configuration>
</configurations>
</operation>