Traducción de subtítulos en directo (Beta privada)
Utiliza la función «Traducción de subtítulos en directo» para traducir los subtítulos en tiempo real a diferentes idiomas para los participantes en una sesión de Vonage Video.
Beta privada
Nota: La traducción de subtítulos en directo se ofrece como beta privada Función. Ponte en contacto con nosotros para activar la traducción de subtítulos en directo en tu proyecto.
La beta privada está disponible para que una selección de clientes pueda probar y evaluar la función, así como aportar sus comentarios. Con el fin de incorporar dichos comentarios y adaptar el producto a las necesidades de los clientes, puede ser necesario realizar cambios que afecten a las API y al código de los clientes. Tenga en cuenta que puede ser necesario modificar el código escrito durante la fase de beta privada una vez que el producto esté disponible para el público en general.
Esta página incluye las siguientes secciones:
- Beta privada
- Visión general
- Traducción a nivel de sesión
- Traducción a nivel de abonado
- Idiomas admitidos
- Notas
Visión general
La traducción de subtítulos en directo amplía el Subtítulos en directo añadiendo la traducción en tiempo real de los subtítulos. Con Live Captions, el audio se transcribe en el idioma hablado. Con Live Captions Translation, esos subtítulos pueden traducirse automáticamente a otro idioma para los participantes.
Nota: La traducción de subtítulos en directo está disponible a partir de la versión 2.36.0 de los SDK de cliente.
Antes de utilizar la traducción con subtítulos en directo, asegúrese de que está familiarizado con la función Subtítulos en directo incluyendo cómo iniciar subtítulos mediante la API REST y cómo suscribirse a los subtítulos en los SDK de cliente.
La traducción se puede activar en dos niveles:
- Traducción a nivel de sesión — Establecer un idioma de traducción para todos los participantes al activar los subtítulos a través de la API del lado del servidor.
- Traducción a nivel de abonado — Los suscriptores individuales eligen su propio idioma de traducción mediante los SDK del cliente, independientemente de la configuración a nivel de sesión.
Estos dos niveles pueden utilizarse juntos o de forma independiente.
Traducción a nivel de sesión
Al llamar al Iniciar la API REST de subtítulos (POST /v2/project/<apiKey>/captions), puede incluir un targetLanguageCode en el cuerpo de la solicitud:
{
"sessionId": "<session-id>",
"token": "A valid OpenTok token with the role set to moderator",
"languageCode": "en-US",
"targetLanguageCode": "es-ES",
"maxDuration": 1800,
"partialCaptions": true
}
targetLanguageCode(Cadena) — (Opcional) El código de idioma BCP-47 del idioma de destino de la traducción (véase el lista de idiomas admitidos). Cuando se establece, todos los participantes en la sesión recibirán subtítulos traducidos en el idioma especificado en lugar del idioma original transcrito.
Comportamiento:
- Si
targetLanguageCodees no fijado (o se omiten), los subtítulos funcionan con normalidad: los participantes reciben subtítulos en la lengua hablada original definida porlanguageCode. - Si
targetLanguageCodeestá establecido, todos los participantes en la sesión reciben, por defecto, subtítulos traducidos al idioma especificado. - Un abonado que establece su propio idioma de traducción (véase Traducción a nivel de abonado) recibirán subtítulos en el idioma que elijan, lo que anulará la configuración a nivel de sesión
targetLanguageCode.
Traducción a nivel de abonado
Los suscriptores pueden elegir el idioma de traducción que deseen mediante los SDK de cliente y pueden cambiarlo en cualquier momento durante una sesión. Esto funciona independientemente de la configuración a nivel de sesión targetLanguageCode.
Puedes configurar la traducción a nivel de suscriptor utilizando cualquiera de los SDK de cliente de la Video API de Vonage, entre los que se incluyen Web (OpenTok.js), iOS, Android, Windows, macOS, Linuxy React Native. A continuación se muestran ejemplos de referencia para cada plataforma.
Configuración del idioma de traducción (Web)
El idioma predeterminado de los subtítulos viene determinado por el languageCode (o targetLanguageCode) establecido en la API de Start Captions. Para cambiar el idioma de traducción de un suscriptor concreto, llama a setCaptionsTranslationLanguage con un código de idioma BCP-47 válido. Pase null para volver al idioma por defecto.
// Example BCP-47 language code for captions translation
const captionsLanguageCode = 'es-ES'
// Set the subscriber's captions translation language
try {
await subscriber.setCaptionsTranslationLanguage(captionsLanguageCode)
} catch (err) {
console.error(`Failed to set captions translation language: ${err.message}`)
}
// Pass null to revert to the default language
try {
await subscriber.setCaptionsTranslationLanguage(null)
} catch (err) {
console.error(`Failed to revert captions translation language: ${err.message}`)
}
Obtener el idioma de traducción actual (Web)
Uso getCaptionsTranslationLanguage para comprobar el idioma de traducción seleccionado actualmente por el abonado. Devuelve el código de idioma BCP-47 seleccionado, o bien null si no se ha establecido ningún idioma de traducción.
const captionsLanguage = subscriber.getCaptionsTranslationLanguage()
if (captionsLanguage) {
console.log(`Captions translation language is set to: ${captionsLanguage}`)
} else {
console.log('No translation language set; using the session default.')
}
Configuración del idioma de traducción (Android)
Utiliza el setCaptionsTranslationLanguage() del objeto SubscriberKit para establecer el idioma de traducción. Pase null para volver al idioma por defecto.
// Set the subscriber's captions translation language
subscriber.setCaptionsTranslationLanguage("es-ES");
// Revert to the default language
subscriber.setCaptionsTranslationLanguage(null);
Obtener el idioma de traducción actual (Android)
Utiliza el getCaptionsTranslationLanguage() para comprobar el idioma de traducción seleccionado actualmente por el abonado. Devuelve el código de idioma BCP-47 seleccionado, o bien null si no se ha establecido ningún idioma de traducción.
String captionsLanguage = subscriber.getCaptionsTranslationLanguage();
if (captionsLanguage != null) {
Log.d(TAG, "Captions translation language is set to: " + captionsLanguage);
} else {
Log.d(TAG, "No translation language set; using the session default.");
}
Configuración del idioma de traducción (iOS)
Fije el captionsTranslationLanguage del objeto OTSubscriberKit al código de idioma BCP-47 deseado. Establézcalo en nil para volver al idioma por defecto.
// Set the subscriber's captions translation language
subscriber.captionsTranslationLanguage = @"es-ES";
// Revert to the default language
subscriber.captionsTranslationLanguage = nil;
Obtener el idioma de traducción actual (iOS)
Lee el captionsTranslationLanguage para comprobar el idioma de traducción seleccionado actualmente por el abonado. Devuelve el código de idioma BCP-47 seleccionado, o bien nil si no se ha establecido ningún idioma de traducción.
NSString *captionsLanguage = subscriber.captionsTranslationLanguage;
if (captionsLanguage) {
NSLog(@"Captions translation language is set to: %@", captionsLanguage);
} else {
NSLog(@"No translation language set; using the session default.");
}
Configuración del idioma de traducción (Windows)
Fije el CaptionsTranslationLanguage del objeto Suscriptor al código de idioma BCP-47 deseado. Póngalo en null para volver al idioma por defecto.
// Set the subscriber's captions translation language
subscriber.CaptionsTranslationLanguage = "es-ES";
// Revert to the default language
subscriber.CaptionsTranslationLanguage = null;
Obtener el idioma de traducción actual (Windows)
Lee el CaptionsTranslationLanguage para comprobar el idioma de traducción seleccionado actualmente por el abonado. Devuelve el código de idioma BCP-47 seleccionado, o bien null si no se ha establecido ningún idioma de traducción.
string captionsLanguage = subscriber.CaptionsTranslationLanguage;
if (captionsLanguage != null)
{
Console.WriteLine($"Captions translation language is set to: {captionsLanguage}");
}
else
{
Console.WriteLine("No translation language set; using the session default.");
}
Idiomas admitidos
Live Captions Translation utiliza los mismos códigos de idioma BCP-47 que Live Captions. Consulte la lista de idiomas admitidos para ver la lista completa de idiomas disponibles.
Notas
-
La traducción de subtítulos en directo requiere Subtítulos en directo para que estén activas durante la sesión. Debes iniciar los subtítulos utilizando el Iniciar API de subtítulos hasta que la traducción esté disponible.
-
Si se establece un idioma de traducción a nivel de abonado, se anula el idioma de traducción a nivel de sesión.
targetLanguageCodesólo para ese abonado. Pasarnullrestablece el comportamiento predeterminado del suscriptor (a nivel de sesióntargetLanguageCodesi se ha establecido; de lo contrario, el originallanguageCode). -
Si desea consultar la documentación básica sobre la función Live Captions (arquitectura, publicación de subtítulos, suscripción a subtítulos, webhooks de estado y problemas conocidos), consulte la página Guía de subtítulos en directo.