Bilder und die Dynamic Ingest API

In diesem Thema wird erklärt, wie Sie Bilder für ein Video erfassen oder einlesen.

Einleitung

Sie können zwei Kategorien von Bildern aufnehmen:

  • Primäre/Standard-Poster- und Miniaturbilder, die im Anfragetext definiert sind als poster Und thumbnail Objekte (Feld- und Syntaxdetails sind unten)
  • Mehrsprachige Variantenbilder, die in einer images Reihe von Objekten definiert sind (Feld- und Syntaxdetails finden Sie unten)

Die mehrsprachigen Variantenbilder können von sechs Typen sein:

Plakat
Das Posterbild wird im Brightcove Player angezeigt, bevor der Benutzer das Video abspielt. Es ist normalerweise ein Frame, der aus dem Video aufgenommen wurde, muss es aber nicht.
Miniaturansicht
Das Miniaturbild wird in Wiedergabelisten, Endbildschirmen usw. angezeigt. Es ist normalerweise ein Frame, der aus dem Video aufgenommen wurde, muss es aber nicht.
Porträt
Ein Bild, das normalerweise als Poster im Hochformat auf Telefonen und anderen Geräten verwendet wird. Benötigt für Brightcove-Leuchtfeuer. Details der Spezifikation sind in der Tisch unter.
Quadrat
Ein Bild, das normalerweise als Kanallogo oder in Rasteranzeigen verwendet wird. Benötigt für Brightcove-Leuchtfeuer. Details der Spezifikation sind in der Tisch unter.
weit
Ein Bild, das normalerweise als Poster im Querformat auf Telefonen und anderen Geräten verwendet wird. Benötigt für Brightcove-Leuchtfeuer. Details der Spezifikation sind in der Tisch unter.
extra breit
Ein Bild, das normalerweise als Poster auf Ultra-Wide-Displays wie Fernsehern verwendet wird. Benötigt für Brightcove-Leuchtfeuer. Details der Spezifikation sind in der Tisch unter.

Spezifikationen

Die folgenden Tabellen enthalten Spezifikationen für Bilder.

Details zum primären Bild
Typ Formatieren Seitenverhältnis (B/H) Mindestbreite (Pixel)
Plakat png oder jpg 16:9 oder 4:3 640
Miniaturansicht png oder jpg 16:9 oder 4:3 160
Bilddetails der mehrsprachigen Variante
Typ Formatieren Seitenverhältnis (B/H) Mindestbreite (Pixel)
Plakat jpg oder png Video zum Spiel keiner
Miniaturansicht jpg oder png Video zum Spiel keiner
Porträt jpg oder png 0,6667 (2x3) 500
Quadrat jpg oder png 1,0 (1x1) 500
weit jpg oder png 1.778 (16x9) 2000
extra breit jpg oder png 2.333 21x9 2000

Es gibt zwei verschiedene Möglichkeiten, mithilfe der Dynamic Ingest API primäre Poster- und Miniaturbilder zu Ihren Videos hinzuzufügen:

  • Bilder aufnehmen in der Mitte des Videos beim Transkodieren (derzeit gilt dies für poster und thumbnail Bilder. Andere Typen müssen aufgenommen werden). Das Erfassen von Bildern für das Hauptposter und die Miniaturansicht können zusammen mit aufgenommenen Bildern für mehrsprachige Varianten verwendet werden.
  • Nehmen Sie Ihre eigenen Bilder auf, entweder gleichzeitig mit der Aufnahme des Videos oder separat. Beachten Sie, dass bei der Aufnahme von Bildern nach der Aufnahme des Videos Sie müssen warten, bis die Videoverarbeitung abgeschlossen ist, bevor Sie die Bilder aufnehmen.

Einrichtung

Das Setup für dynamische Ingest-Anfragen ist gleich, egal ob Sie ein Video, Bilder, eine WebVTT-Datei oder alles davon aufnehmen:

Anfrage-URL
    https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
Authentifizierung
Für die Authentifizierung ist ein Zugriffstoken erforderlich, das als Bearer Token in einem Authorization Header übergeben wird: 
    Authorization: Bearer {access_token}

Hinweis zu S3

Wenn Ihre Bilder aus einem geschützten S3-Bucket abgerufen werden, müssen Sie eine Bucket-Richtlinie festlegen, damit Video Cloud auf die Dateien zugreifen kann. Sehen Verwenden der dynamischen Aufnahme mit S3 für Details.

Mehrsprachige Varianten

Sie können verschiedene Versionen von Bildern bereitstellen, die für verschiedene Sprachen verwendet werden sollen. Dies wird abgewickelt von Brightcove-Leuchtfeuer für Brightcove Beacon-Apps. Die allgemeine Implementierung im Brightcove Player erfordert derzeit eine benutzerdefinierte Entwicklung.

Die Sprache für ein Bild wird im language Eigenschaft, die im nächsten Abschnitt beschrieben wird.

Bilder aufnehmen

Hier sind die Details zum Hinzufügen von benutzerdefinierten Bildern für Ihr Video.

Bildfelder im Anfragetext

Wie oben erwähnt, werden primäre Poster- und Miniaturbilder als Objekte der obersten Ebene im Anforderungstext angegeben. Mehrsprachige Variantenbilder im Text der Aufnahmeanforderung werden als Array von Objekten angegeben. Die Objekteigenschaften sind in den folgenden Tabellen aufgeführt.

Primäre Poster und Miniaturbilder
Eigentum Beschreibung Typ Erforderlich Beispiel
url Öffentliche URL, unter der das Bild abgerufen werden kann Zeichenfolge https://some.site.com/images/celtic-lullaby-large.png
width Breite des Bildes in Pixel Nummer 1920
Height Höhe des Bildes in Pixel Nummer 1080
Eigenschaften von mehrsprachigen Bildobjekten
Eigentum Beschreibung Typ Erforderlich Beispiel
url Eine URL, von der Video Cloud das Bild abrufen kann Schnur https://mysite.com/videos/video123/images/poster.png
language Sprachcode für das Bild aus den Subtags in https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry (der Standard kann für das Konto festgelegt werden, indem Sie sich an den Brightcove-Support wenden); falls nicht enthalten, wird die Standardsprache für das Konto verwendet. Schnur
variant Der Typ für dieses Bild: poster | thumbnail | portrait | square | wide | ultra-wide Schnur wide
height Nummer 2160
width Nummer 3840

Beispielanfragetext

Der unten stehende Beispiel-Anfragetext enthält nur die Bildfelder. Andere Aufnahmefelder können ebenfalls eingeschlossen werden.

{
			"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
        }
      ]
    }
Beispielantwort

Unten ist eine Antwort auf a CMS-API Anfrage zum Abrufen von Videobildern. Sehen Abrufen von Bilddaten unter.

{
  "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
      }
    ]
  }
}

Automatische Größenänderung

Wenn Sie benutzerdefinierte Poster- und/oder Miniaturbilder über Studio oder die Dynamic Ingest API hinzufügen, passt Video Cloud diese standardmäßig an die Bildgrößen an, die im standardmäßigen Ingest-Profil für das Konto definiert sind.

Beachten Sie, dass Größenänderung und Auffüllen die einzigen Änderungen sind, die Video Cloud oder Brightcove-Leuchtfeuer. Bilder werden nie beschnitten.

Bilder aufnehmen

Während der Transcodierung kann Video Cloud einen Schnappschuss aus dem Video in der Mitte aufnehmen und diesen als Poster und Miniaturansichten speichern.

Bei benutzerdefinierten Aufnahmeprofilen erfordert die Bilderfassung, dass dem von Ihnen verwendeten Aufnahmeprofil zwei spezielle Darstellungen hinzugefügt werden. Sehen Bilder in Aufnahmeprofilen unter.

Sie sollten auch die einstellen capture-images Markieren Sie in Ihren Anforderungsdaten zu true Wenn Sie möchten, dass das Poster und die Miniaturansicht während der Transcodierung aus dem Video aufgenommen werden, dies ist jedoch der Standardwert wenn Das ausgewählte Profil enthält Bildwiedergaben. (Wenn das Profil keine Bildwiedergaben enthält, ist die Standardeinstellung für capture-images ist false.)

Beispielanfragedaten:

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

Bilder in Aufnahmeprofilen

Zum poster und thumbnail nur Bilder, müssen Sie Bildwiedergaben in das Aufnahmeprofil aufnehmen. Dies dient der automatischen Aufnahme, unabhängig davon, ob Sie es beim Aufnehmen des Videos verwenden oder sich später beim Transkodieren entscheiden. Bildwiedergaben sind in allen standardmäßigen Aufnahmeprofilen enthalten, daher gilt dieser Abschnitt nur für benutzerdefinierte Aufnahmeprofile.

Im Folgenden finden Sie Details dazu, wie Bildwiedergaben in Aufnahmeprofilen angegeben werden.

Eigentum Wert
media_type "Bild"
label "Poster" oder "Miniaturansicht" (Sie benötigen jeweils eine Wiedergabe)
format "png" oder "jpg"
width Zahl (Pixel)
height Zahl (Pixel)

Hier sind Beispieldaten für die Wiedergaben:

"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
	}
]

Abrufen von Bilddaten

Sie können Bilddaten mit dem CMS-API.

Das CMS API gibt die Bilddaten in a zurück GET Anfrage zu https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id} oder, wenn Sie nur die Bilddaten möchten, zu https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/images

In beiden Fällen sehen die Bilddaten in der Antwort so aus:

{
  "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
      }
    ]
  }
}

Einschränkungen

  • Das Aufnahmesystem lässt keine gleichzeitigen Jobs auf demselben Video zu.
  • Derzeit werden Bilddaten für die Varianten Wide, Square, Portrait und Ultra-Wide nur von der CMS-API zurückgegeben. nicht per Playback API Videoanfragen.