awstranslate

awstranslate is an element that can be used to translate text from one language to another.

When working with live data, the element will accumulate input text until the deadline is reached, comparing the current running time with the running time of the input items and the upstream latency.

At this point the input items will be drained up until the first item ending with a punctuation symbol.

The accumulator will also be drained upon receiving rstranscribe/final-transcript and rstranscribe/speaker-change custom events.

When the user wants to use a very low / no latency upstream, and is willing to accept desynchronization in order to build up long-enough sentences for translation, they can set the accumulator-lateness property to shift the input timestamps forward when accumulating.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──awstranslate

Factory details

Authors: – Mathieu Duponchelle

Classification:Text/Filter

Rank – none

Plugin – aws

Package – gst-plugin-aws

Pad Templates

sink

text/x-raw:
         format: utf8

Presencealways

Directionsink

Object typeGstPad


src

text/x-raw:
         format: utf8

Presencealways

Directionsrc

Object typeGstPad


Properties

access-key

“access-key” gchararray

AWS Access Key

Flags : Read / Write

Default value : NULL


accumulator-lateness

“accumulator-lateness” guint

The element will accumulate input text until a deadline is reached, function of the first item running time and the upstream latency.

For live cases where overall latency is to be kept low at the expense of synchronization, this property can be set to still accumulate reasonable amounts of text for translation.

The timestamps of the translated text will then be shifted forward by the value of this property.

Flags : Read / Write

Default value : 0

Since : plugins-rs-0.14.0


input-language-code

“input-language-code” gchararray

The Language of the input stream

Flags : Read / Write

Default value : en-US


latency

“latency” guint

Amount of milliseconds to allow AWS translate

Flags : Read / Write

Default value : 2000


output-language-code

“output-language-code” gchararray

The Language of the output stream

Flags : Read / Write

Default value : fr-FR


secret-access-key

“secret-access-key” gchararray

AWS Secret Access Key

Flags : Read / Write

Default value : NULL


session-token

“session-token” gchararray

AWS temporary Session Token from STS

Flags : Read / Write

Default value : NULL


tokenization-method

“tokenization-method” GstAwsTranscriberTranslationTokenizationMethod *

The tokenization method to apply

Flags : Read / Write

Default value : span-based (1)


Named constants

GstAwsTranscriberTranslationTokenizationMethod

Members

none (0) – None: don't tokenize translations
span-based (1) – Span based: insert spans in the transript text and use the resulting spans in the translations to reproduce speech pacing.

The results of the search are