diff options
author | François Laignel <francois@centricular.com> | 2023-03-10 16:47:38 +0300 |
---|---|---|
committer | GStreamer Marge Bot <gitlab-merge-bot@gstreamer-foundation.org> | 2023-03-14 16:48:32 +0300 |
commit | 743e97738fe44bec8843f467828a1ec2aa710d91 (patch) | |
tree | c23da089726cd9560d52d58521c560415a44fb52 /docs | |
parent | 9a55fda69c1c83ba5aabcc0796f0af9b031fc6da (diff) |
net/aws/transcriber: add translation request src pads
This commit adds an optional transcript translation feature implemented as
request src Pads.
When requesting a src Pad, the user can specify the translation language code
using Pad properties 'language-code'.
The following properties are defined on the Element:
- 'transcribe-latency': formerly 'latency', defines the expected latency for
the Transcribe webservice.
- 'translate-latency': defines the expected latency for the Translate
webservice.
- 'transcript-lookahead': maximum transcript duration to send to translation
when a transcript is hitting its deadline and no punctuation was found.
When the input and output languages are the same, only the 'transcribe-latency'
is used for the Pad. Otherwise, the resulting latency is the addition of
'transcribe-latency' and 'translate-latency'.
Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/merge_requests/1109>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/plugins/gst_plugins_cache.json | 80 |
1 files changed, 78 insertions, 2 deletions
diff --git a/docs/plugins/gst_plugins_cache.json b/docs/plugins/gst_plugins_cache.json index e21ba928..c6e6e16b 100644 --- a/docs/plugins/gst_plugins_cache.json +++ b/docs/plugins/gst_plugins_cache.json @@ -628,6 +628,9 @@ "GInitiallyUnowned", "GObject" ], + "interfaces": [ + "GstChildProxy" + ], "klass": "Audio/Text/Filter", "long-name": "Transcriber", "pad-templates": { @@ -639,7 +642,14 @@ "src": { "caps": "text/x-raw:\n format: utf8\n", "direction": "src", - "presence": "always" + "presence": "always", + "type": "GstTranslationSrcPad" + }, + "src_%%u": { + "caps": "text/x-raw:\n format: utf8\n", + "direction": "src", + "presence": "request", + "type": "GstTranslationSrcPad" } }, "properties": { @@ -668,7 +678,7 @@ "writable": true }, "latency": { - "blurb": "Amount of milliseconds to allow AWS transcribe", + "blurb": "Amount of milliseconds to allow AWS transcribe (Deprecated. Use transcribe-latency)", "conditionally-available": false, "construct": false, "construct-only": false, @@ -743,6 +753,48 @@ "type": "gchararray", "writable": true }, + "transcribe-latency": { + "blurb": "Amount of milliseconds to allow AWS transcribe", + "conditionally-available": false, + "construct": false, + "construct-only": false, + "controllable": false, + "default": "8000", + "max": "-1", + "min": "0", + "mutable": "ready", + "readable": true, + "type": "guint", + "writable": true + }, + "transcript-lookahead": { + "blurb": "Maximum duration in milliseconds of transcript to lookahead before sending to translation when no separator was encountered", + "conditionally-available": false, + "construct": false, + "construct-only": false, + "controllable": false, + "default": "3000", + "max": "-1", + "min": "0", + "mutable": "ready", + "readable": true, + "type": "guint", + "writable": true + }, + "translate-latency": { + "blurb": "Amount of milliseconds to allow AWS translate (ignored if the input and output languages are the same)", + "conditionally-available": false, + "construct": false, + "construct-only": false, + "controllable": false, + "default": "500", + "max": "-1", + "min": "0", + "mutable": "ready", + "readable": true, + "type": "guint", + "writable": true + }, "vocabulary-filter-method": { "blurb": "Defines how filtered words will be edited, has no effect when vocabulary-filter-name isn't set", "conditionally-available": false, @@ -845,6 +897,30 @@ "value": "2" } ] + }, + "GstTranslationSrcPad": { + "hierarchy": [ + "GstTranslationSrcPad", + "GstPad", + "GstObject", + "GInitiallyUnowned", + "GObject" + ], + "kind": "object", + "properties": { + "language-code": { + "blurb": "The Language the Stream must be translated to", + "conditionally-available": false, + "construct": false, + "construct-only": false, + "controllable": false, + "default": "NULL", + "mutable": "ready", + "readable": true, + "type": "gchararray", + "writable": true + } + } } }, "package": "gst-plugin-aws", |