Imágenes y API de ingesta dinámica

Este tema explica cómo capturar o ingerir imágenes para un video.

Introducción

Puede ingerir dos categorías de imágenes:

  • Póster principal/predeterminado e imágenes en miniatura, que se definen en el cuerpo de la solicitud como poster y thumbnail objetos (los detalles del campo y la sintaxis se encuentran a continuación)
  • Imágenes variantes multilingües, que se definen en un images matriz de objetos (los detalles del campo y la sintaxis se encuentran a continuación)

Las imágenes variantes multilingües pueden ser de seis tipos:

póster
La imagen del póster se muestra en Brightcove Player antes de que el usuario reproduzca el video. Por lo general, es un cuadro capturado del video, pero no tiene por qué serlo.
miniatura
La imagen en miniatura se muestra en listas de reproducción, pantallas finales, etc. Por lo general, es un cuadro capturado del video, pero no tiene por qué serlo.
retrato
Una imagen que se utiliza normalmente como póster en modo vertical en teléfonos y otros dispositivos. Requerido para Baliza Brightcove. Los detalles de la especificación se encuentran en el mesa debajo.
cuadrado
Una imagen que se utiliza normalmente como logotipo de canal o en pantallas de cuadrícula. Requerido para Baliza Brightcove. Los detalles de la especificación se encuentran en el mesa debajo.
amplio
Una imagen que se utiliza normalmente como póster en modo horizontal en teléfonos y otros dispositivos. Requerido para Baliza Brightcove. Los detalles de la especificación se encuentran en el mesa debajo.
ultra ancho
Una imagen que se utiliza normalmente como póster en pantallas ultraanchas como televisores. Requerido para Baliza Brightcove. Los detalles de la especificación se encuentran en el mesa debajo.

Especificaciones

Las tablas siguientes proporcionan especificaciones para las imágenes.

Detalles de la imagen principal
Tipo Formato Relación de aspecto (W / H) Ancho mínimo (píxeles)
Póster png o jpg 16: 9 o 4: 3 640
Miniatura png o jpg 16: 9 o 4: 3 160
Detalles de la imagen de la variante multilingüe
Tipo Formato Relación de aspecto (W / H) Ancho mínimo (píxeles)
póster jpg o png coincidir con video ninguno
miniatura jpg o png coincidir con video ninguno
retrato jpg o png 0,6667 (2x3) 500
cuadrado jpg o png 1.0 (1x1) 500
amplio jpg o png 1,7778 (16 x 9) 2000
ultra ancho jpg o png 2.3333 21x9 2000

Hay dos formas diferentes de agregar imágenes en miniatura y póster principal a sus videos usando la API de Ingesta Dinámica:

  • Capturar imágenes en el punto medio del video durante la transcodificación (actualmente esto se aplica a poster y thumbnail imágenes. Se deben ingerir otros tipos). La captura de imágenes para el póster principal y la miniatura se puede utilizar junto con las imágenes ingeridas para variantes multilingües.
  • Ingiera sus propias imágenes, ya sea al mismo tiempo que ingiere el video, o por separado. Tenga en cuenta que si ingiere imágenes después de ingerir el video, debe esperar a que se complete el procesamiento del video antes de ingerir las imágenes.

Configuración

La configuración para las solicitudes de Ingesta dinámica es la misma, ya sea que esté ingiriendo un video, imágenes, un archivo WebVTT 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 un Authorization encabezamiento: 
    Authorization: Bearer {access_token}

Nota sobre S3

Si sus imágenes se extraerán de un depósito de S3 protegido, deberá establecer una política de depósito para permitir que Video Cloud acceda a los archivos. Ver Uso de Dynamic Ingest con S3 para detalles.

Variantes multilingües

Puede proporcionar diferentes versiones de imágenes para utilizarlas en diferentes idiomas. Esto es manejado por Baliza Brightcove para aplicaciones Brightcove Beacon. La implementación general en Brightcove Player requiere actualmente un desarrollo personalizado.

El idioma de una imagen se especifica en el language propiedad detallada en la siguiente sección.

Ingerir imágenes

Aquí están los detalles de cómo agregar imágenes personalizadas para su video.

Campos de imagen en el cuerpo de la solicitud

Como se indicó anteriormente, el póster principal y las imágenes en miniatura se especifican como objetos de nivel superior en el cuerpo de la solicitud. Las imágenes de variantes multilingües en el cuerpo de la solicitud de ingesta se especifican como una matriz de objetos. Las propiedades del objeto se detallan en las siguientes tablas.

Póster principal e imágenes en miniatura
Propiedad Descripción Tipo Requerido Ejemplo
url URL pública donde se puede recuperar la imagen Cadena https://some.site.com/images/celtic-lullaby-large.png
width Ancho de la imagen en píxeles Número 1920
Height Altura de la imagen en píxeles Número 1080
Propiedades de objeto de imagen multilingüe
Propiedad Descripción Tipo Requerido Ejemplo
url Una URL de la que Video Cloud puede recuperar la imagen cuerda https://mysite.com/videos/video123/images/poster.png
language Código de idioma para la imagen de las subetiquetas en https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry (el valor predeterminado se puede configurar para la cuenta poniéndose en contacto con el Soporte de Brightcove); si no se incluye, se utilizará el idioma predeterminado de la cuenta. cuerda
variant El tipo de esta imagen: poster | thumbnail | portrait | square | wide | ultra-wide cuerda wide
height número 2160
width número 3840

Cuerpo de solicitud de muestra

El cuerpo de solicitud de muestra a continuación incluye solo los campos de imagen. También se pueden incluir otros campos de ingesta.

{
			"poster": {
				"url": "https://some.site.com/images/celtic-lullaby-large.png",
				"width": 1400,
				"height": 1400
			},
			"thumbnail": {
				"url": "https://some.site.com/images/celtic-lullaby-large.png",
				"width": 160,
				"height": 90
			},
	    "images":[
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/poster.jpg",
            "variant": "poster",
            "height": 1080,
            "width": 1920
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/thumbnail.jpg",
            "variant": "thumbnail",
            "height": 108,
            "width": 292
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/square.jpg",
            "language": "de",
            "variant": "square",
            "height": 570,
            "width": 570
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/wide.jpg",
            "language": "fr",
            "variant": "wide",
            "height": 1440,
            "width": 2560
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/portrait.jpg",
            "language": "es",
            "variant": "portrait",
            "height": 1200,
            "width": 800
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/ultra-wide.jpg",
            "language": "hi",
            "variant": "ultra-wide",
            "height": 1646,
            "width": 3840
        }
      ]
    }
Respuesta de muestra

A continuación se muestra una respuesta a un Solicitud de obtención de imágenes de vídeo de la API de CMS. Ver Recuperando datos de imagen debajo.

{
  "thumbnail.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
        "height": 108,
        "width": 292
      }
    ]
  },
  "ultra-wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
        "height": 857,
        "width": 2000
      }
    ]
  },
  "wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
        "height": 1125,
        "width": 2000
      }
    ]
  },
  "portrait.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
        "height": 750,
        "width": 500
      }
    ]
  },
  "poster.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
        "height": 1080,
        "width": 1920
      }
    ]
  },
  "square.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
        "height": 500,
        "width": 500
      }
    ]
  },
  "poster": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
        "height": 1400,
        "width": 1400
      }
    ]
  },
  "thumbnail": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
        "height": 90,
        "width": 160
      }
    ]
  },
  "ultra-wide.hi": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
        "height": 1646,
        "width": 3840
      }
    ]
  },
  "wide.fr": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
        "height": 1440,
        "width": 2560
      }
    ]
  },
  "portrait.es": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
        "height": 1200,
        "width": 800
      }
    ]
  },
  "square.de": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
        "height": 570,
        "width": 570
      }
    ]
  }
}

Cambio de tamaño automático

Cuando agrega un póster personalizado y / o imágenes en miniatura a través de Studio o la API de ingesta dinámica, Video Cloud las redimensionará de forma predeterminada para que coincidan con los tamaños de imagen definidos en el perfil de ingesta predeterminado para la cuenta.

Tenga en cuenta que el cambio de tamaño y el relleno son las únicas modificaciones de Video Cloud o Baliza Brightcove. Las imágenes nunca se recortan.

Capturar imágenes

Durante la transcodificación, Video Cloud puede capturar una instantánea del video en el punto medio y guardarla como póster e imágenes en miniatura.

Para los perfiles de ingesta personalizados, la captura de imágenes requiere que se agreguen dos representaciones especiales al perfil de ingesta que está utilizando. Ver Imágenes en perfiles de ingesta debajo.

También debe configurar el capture-images marcar en su solicitud de datos a true si desea que el póster y la miniatura se capturen del video durante la transcodificación, pero este es el valor predeterminado Si el perfil seleccionado incluye reproducciones de imágenes. (Si no hay representaciones de imágenes en el perfil, el valor predeterminado para capture-images es false.)

Datos de solicitud de muestra:

      {
        "master": { "url": "https://some.site.com/videos/mp4/Bird_Titmouse.mp4" },
        "profile": "multi-platform-standard-static",
        "capture-images": true
      }

Imágenes en perfiles de ingesta

Para poster y thumbnail solo imágenes, debe incluir representaciones de imágenes en el perfil de ingesta. Esto es para la captura automática, ya sea que lo use cuando ingiera el video o decida hacerlo más tarde cuando lo transcodifique. Las representaciones de imágenes se incluyen en todos los perfiles de ingesta estándar, por lo que esta sección solo se aplica a los perfiles de ingesta personalizados.

A continuación, se detallan cómo se especifican las representaciones de imágenes en los perfiles de ingesta.

Propiedad Valor
media_type "imagen"
label "póster" o "miniatura" (necesita una versión para cada uno)
format "png" o "jpg"
width número (píxeles)
height número (píxeles)

Aquí hay datos de muestra para las representaciones:

"images": [
	{
		"label": "square",
		"height": 500,
		"width": 500
	},
	{
		"label": "ultra-wide",
		"height": 1714,
		"width": 4000
	},
	{
		"label": "wide",
		"height": 2250,
		"width": 4000
	},
	{
		"label": "portrait",
		"height": 3000,
		"width": 2000
	},
	{
		"label": "thumbnail",
		"height": 90,
		"width": 160
	},
	{
		"label": "poster",
		"height": 1080,
		"width": 1920
	}
]

Recuperando datos de imagen

Puede recuperar datos de imágenes usando el API de CMS.

La CMS API devolverá los datos de la imagen en un GET solicitud de https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id} o, si solo desea los datos de la imagen, https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/images

En cualquier caso, los datos de la imagen en la respuesta se verán así:

{
  "thumbnail": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
        "height": 90,
        "width": 160
      }
    ]
  },
  "poster": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
        "height": 720,
        "width": 1280
      }
    ]
  },
  "portrait.es": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
        "height": 1200,
        "width": 800
      }
    ]
  },
  "thumbnail.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
        "height": 108,
        "width": 292
      }
    ]
  },
  "poster.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
        "height": 1080,
        "width": 1920
      }
    ]
  },
  "square.de": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
        "height": 570,
        "width": 570
      }
    ]
  },
  "ultra-wide.hi": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
        "height": 1646,
        "width": 3840
      }
    ]
  },
  "wide.fr": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
        "height": 1440,
        "width": 2560
      }
    ]
  }
}

Limitaciones

  • El sistema de ingestión no permite trabajos simultáneos en el mismo video.
  • Actualmente, los datos de imagen para las variantes ancha, cuadrada, vertical y ultraancha son devueltos solo por la API de CMS. no por solicitudes de video de Playback API.