Introducción
Brightcove Auto Captioning es un servicio a nivel de plataforma que le permite generar automáticamente subtítulos para videos nuevos o existentes en 31 idiomas diferentes (siempre que tenga una pista de audio para el idioma especificado). Como todos los servicios de voz a texto, los subtítulos automáticos no son 100 % precisos, pero brindan una forma rápida y fácil de generar subtítulos directamente en Video Cloud.
Video Cloud utiliza el siguiente proceso para determinar la fuente que se utilizará para generar los subtítulos.
- Si el video tiene una pista de audio predeterminada, se usará como el archivo de origen de los subtítulos (compatible de manera predeterminada en el módulo multimedia)
- Si el video no tiene una pista de audio predeterminada pero existe un archivo maestro/mezzanine, se usará como archivo de origen (compatible de manera predeterminada en el módulo multimedia)
- Si el video no tiene una pista de audio predeterminada o archivos maestros/intermedios, pero las pistas de audio se especifican en la llamada de ingesta dinámica, se usará la pista de audio especificada (aún no se admite en el módulo multimedia)
- Si el video no tiene una pista de audio predeterminada, no hay archivos maestros/intermedios y no se especifica ninguna pista de audio, no se pueden generar subtítulos.
Configuración
la configuración para Dynamic Ingest solicitudes es la misma, ya sea que esté ingeriendo un video, imágenes, pistas de audio, WebVTT archivos, solicitando subtítulos automáticos, o todos estos:
- Solicitar URL
-
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
- Autenticación
- La autenticación requiere un token de acceso pasado como
Bearer
token en unAuthorization
encabezamiento:Authorization: Bearer {access_token}
Para obtener tokens de acceso, necesitará credenciales del cliente (vea abajo). Para conocer el proceso de obtención de un token de acceso, consulte Obtener tokens de acceso.
Nota sobre S3
Si sus archivos de origen se extraerán de un depósito de S3 protegido, deberá establecer una política de depósito para permitir Video Cloud para acceder a los archivos. Ver Utilizando Dynamic Ingest con S3 para detalles.
Obtención de credenciales
Para obtener un client_id
y client_secret
, tendrás que ir a la interfaz de usuario de OAuth y registrar esta aplicación:
Estos son los permisos que necesitarás:
También puede obtener sus credenciales a través de CURL , Postman , o nuestra aplicación en línea - consulte:
- Obtenga las credenciales del cliente mediante CURL
- Obtenga las credenciales del cliente mediante Postman
- Crear credenciales de cliente
Si obtienes credenciales directamente de la API, estos son los permisos que necesitas:
[
"video-cloud/video/all",
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/account/read",
"video-cloud/upload-urls/read"
]
Casos de uso
Estos son algunos casos de uso típicos
Cree subtítulos automáticos para nuevas ingestiones o retranscodificación
Cuerpo de la solicitud
{
"master": {
"use_archived_master": true
},
"profile": "multi-platform-standard-static-with-mp4",
"transcriptions": [
{
"srclang": "EN-us",
"kind": "captions",
"label": "English",
"status" : "published",
"default": true
}
],
"priority": "normal"
}
Crear subtítulos automáticos al ingerir una pista de audio
Cuerpo de la solicitud
{
"audio_tracks": {
"merge_with_existing": true,
"masters": [
{
"language": "fr-FR",
"variant": "alternate",
"url": "https://support.brightcove.com/test-assets//audio/celtic_lullaby.m4a"
}
]
},
"transcriptions": [
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"status" : "published",
"default": false,
"input_audio_track": {
"language": "fr-FR",
"variant": "alternate"
}
}
]
}
Cree subtítulos automáticos para un video existente usando el maestro digital
Cuerpo de la solicitud
{
"transcriptions": [
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"default": false
}
]
}
Cree subtítulos automáticos para un video existente que defina las pistas de audio
Cuerpo de la solicitud
{
"transcriptions": [
{
"srclang": "en-US",
"kind": "captions",
"label": "english-EN",
"default": false,
"input_audio_track": {
"language": "en-US",
"variant": "main"
}
},
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"default": false,
"input_audio_track": {
"language": "fr-FR",
"variant": "alternate"
}
}
]
}
Solicitar campos de cuerpo para subtítulos automáticos
La siguiente tabla muestra los campos del cuerpo de la solicitud para subtítulos automáticos.
Campo | Tipo | Requerido | Descripción |
---|---|---|---|
autodetect |
booleano | no |
true para detectar automáticamente el idioma de la fuente de audio. false usar srclang especificando el idioma del audio.
|
default |
booleano | no |
Si true , srclang se ignorará y se usará la pista de audio principal; el idioma se detectará automáticamente.
|
input_audio_track |
objeto | no | Para varias pistas de audio, define el audio del que extraer los subtítulos. Está compuesto por idioma y variante (ambos obligatorios). |
kind |
cuerda | no |
El tipo de salida a generar. Valores permitidos:
|
label |
cuerda | no | Etiqueta legible por humanos. El valor predeterminado es el código de idioma de estilo BCP-47. |
srclang |
cuerda | no | Código de idioma estilo BCP-47 para las pistas de texto (en-US, fr-FR, es-ES, etc.); ver idiomas admitidos |
status |
cuerda | no |
Indica la situación real del pie de foto, si es published , draft .
|
url |
cuerda | no |
La URL donde se encuentra un archivo de transcripción. Debe incluirse en el tipo es transcripciones . No debe incluirse si el tipo es subtítulos .
|
input_audio_track
campos
Campo | Tipo | Requerido | Descripción |
---|---|---|---|
language |
cuerda | sí | Código de idioma estilo BCP-47 para las pistas de texto (en-US, fr-FR, es-ES, etc.); ver idiomas admitidos |
variant |
cuerda | sí |
Especifica la variante a utilizar:
|
Idiomas admitidos
Actualmente, los subtítulos automáticos están limitados a los siguientes idiomas
|
|