Einführung
Bei der Aufnahme von Videos können Sie XML-Manifestdateien verwenden, um zusätzliche Metadaten (einschließlich des Videotitels, der Beschreibung, Flugzeiten, Etiketten und benutzerdefinierten Metadaten) sowie Miniaturansichten und Untertiteldateien anzugeben. Sie können XML-Manifestdateien verwenden, wenn Sie Inhalte mit FTP, Aspera oder MRSS aufnehmen.
Umgang mit Metadaten
Wenn Sie metadata
für Videos einschließen, wenn Sie sie aufnehmen, wird es auf zwei Arten den Video Cloud-Videofeldern zugeordnet:
- Standardmäßig wird jedes
metadata
Schlüssel/Wert-Paar als Tag in der Form hinzugefügt:meta::key::value
.<ooyala:metadata name="category">cooking</ooyala:metadata>
Würde zum Beispiel das Tag produzierenmeta::category::cooking
- Wenn Sie lieber Metadaten speichern
custom_fields
möchten, kann Brightcove Support eine Einstellung für Ihr Konto ändern, um dies zu tun. Achten Sie auf Folgendes:- Sie müssen benutzerdefinierte Felder mit Namen erstellen, die Ihren Metadaten-Schlüsseln entsprechen.
- Die Anzahl der benutzerdefinierten Felder ist standardmäßig auf 10 beschränkt. Wenn Sie also mehr benötigen, um Ihre Metadaten aufzunehmen, müssen Sie zusätzliche benutzerdefinierte Felder vom Support anfordern.
- Wenn in Ihrem Konto kein benutzerdefiniertes Feld für jedes Metadatenelement vorhanden ist, schlägt der gesamte Metadatenvorgang fehl.
Elemente des XML-Manifests
Sie können die folgenden Elemente in der XML-Manifestdatei verwenden.
XML-Tag | Beschreibung | Erforderlich/optional |
---|---|---|
<channel> | Enthält eine oder mehrere <item> Elemente. | erforderlich |
<item> | Stellt ein einzelnes Video zur Aufnahme dar. Sie können mehrere Videos angeben (<item> Tags) in einer XML-Manifestdatei. Enthält die restlichen Tags in dieser Tabelle. | erforderlich |
<media:content> | Gibt ein Video an, das aufgenommen werden soll. Eine der folgenden Möglichkeiten:
|
erforderlich (außer für Remote-Assets) |
<media:title> | Name oder Titel des Videos. | fakultativ |
<media:thumbnail> | Legt ein Miniaturbild (Vorschaubild) fest. Eine der folgenden Möglichkeiten:
|
fakultativ |
<media:subTitle> | Gibt eine Untertiteldatei an (unterstützt für DFXP-, WebVTT- und SRT-Dateien). Sehen Aufnahme von Untertiteldateien. Attribute:
Notiz: Wenn angegeben, liegt es in Ihrer Verantwortung, gültige Werte für anzugeben lang und frameRate. Gültige Werte werden zur DFXP-Datei hinzugefügt. Nicht konforme Werte werden ignoriert. In beiden Fällen wird die Untertiteldatei zu Backlot hinzugefügt und mit dem Asset verknüpft. |
fakultativ |
<media:description> | Beschreibung des Videos | fakultativ |
<link> | Permanente URL, in die Sie das Video einbetten. Wird den erstellten Assets zugeordnet hosted_at Eigentum. | fakultativ |
<dcterms:valid> | Flugzeiten, die die Start- und Endzeiten darstellen, zu denen das Asset gespielt werden kann. Beispiel:
<dcterms:gültig > start=2011-06-28T 15:15:00 - 07:00; Ende = 2022-12-01T 16:00:00 - 07:00; Scheme=w3c-dtf </dcterms:gültig > |
fakultativ |
<ooyala:labels> | Ein oder mehrere Labels, getrennt durch Kommas. Beispiel: /sports,/sports/jogging. Hintergrundinformationen finden Sie unter Etiketten. | fakultativ |
<media:keywords> | Eine andere Möglichkeit, Beschriftungen zu definieren (ohne Schrägstrich). Der durch Kommas getrennte Inhalt wird dem Video als Tags hinzugefügt. Ein neues Tag wird nur erstellt, wenn noch kein gleichnamiges Tag vorhanden ist.
Zum Beispiel für Folgendes <media:keywords> Tag, die Etiketten label1 und label2 würde erstellt und dem Video als Tags hinzugefügt. Ein Label namens parentlabel würde auch mit dem Etikett erstellt werden childlabel darin verschachtelt. <media: keywords> label1, label2, parentlabel / childlabel </ media: keywords> Notiz: Die Inhalte von <media:keywords> werden ignoriert, wenn die <ooyala:labels> Das Tag ist in der XML-Manifestdatei oder MRSS enthalten. |
fakultativ |
<ooyala:embedcode> | Video-Cloud-Video-ID | optional (erforderlich, wenn Sie ein Video aktualisieren, anstatt ein neues hinzuzufügen) |
<ooyala:profileguid> | ID des Verarbeitungsprofils, bei dem es sich um eine Gruppe von Codierungen handelt, die die Formate definieren, in die ein Master-Video während der Transkodierung konvertiert werden muss. Weitere Informationen erhalten Sie von Ihrem Ooyala-Supportmitarbeiter. | fakultativ |
<ooyala:metadata> | Benutzerdefinierte Metadaten für das Video. Sie können für jeden Metadatentyp ein Element festlegen. Siehe die Umgang mit Metadaten Abschnitt für Details darüber, wie metadata wird Videos als spezielle Tags hinzugefügt. Beispiel: <ooyala:metadata name="category">cooking</ooyala:metadata> |
fakultativ |
<ooyala:remoteasset> | Gibt ein zu verwendendes Remote-Asset an. Ein Remote-Asset ist ein Video, das an einem anderen Ort als Backlot gehostet wird. Geben Sie die folgenden Attribute an:
Notiz: Nachdem ein Remote-Asset erstellt wurde, kann sich seine Ausbreitung auf die verschiedenen CDNs um 60 Sekunden oder mehr verzögern. Wenn Sie ein Remote-Asset zu früh nach seiner Erstellung anfordern, werden die Ergebnisse von den CDNs zwischengespeichert, was einige Minuten dauern kann. Best Practice: Warten Sie nach der Erstellung 30 oder 60 Sekunden und fragen Sie mit ab Backlot-API [GET] /v2/assets/asset_id Nachdem Sie den Einbettungscode des Remote-Assets (Inhalts-ID oder Asset-ID) abgerufen haben, fahren Sie mit dem Einbetten des Assets fort. |
erforderlich (nur Remote-Assets) |
<ooyala:profileguid> | Gibt ein Video Cloud-Aufgaufsichtsprofil an, das für die Verarbeitung des Videos verwendet werden soll. Wenn Sie das Standardprofil des Kontos nicht verwenden möchten, müssen Sie das Kontoprofil angeben, das Sie stattdessen verwenden möchten. Siehe Verwalten von Ingest-Profilen. | fakultativ |
Beispiel
Beispiel für eine XML-Manifestdatei (OIS v2.5)
<?xml version="1.0" kodieren="utf-8"?> <rss version="2.0" xmlns: media=“ http://search.yahoo.com/mrss/“ xmlns:dcterms“ http://purl.org/dc/terms/“ xmlns: fh=“ http://purl.org/syndication/history/1.0“ xmlns: ooyala=“ http://www.ooyala.com/mrss/ "> <kanal > <Artikel > <media:content url=“ test.mp4 "> < /media:inhalt > <media:subtitle href="my_caption.dfxp“ > < /media:subtitle > <media:thumbnail url=“ my_thumbnail.jpg "filesize="35712" > < /media:thumbnail > <media:title > Test XML < /media:title > <media:description > Dies ist ein Beispiel < /media:description > <ooyala:labels > /test, /beispiel, /xml < /ooyala:labels > <dcterms:gültig > start=2016-01-01T 15:15:00 - 07:00; End=2022-01-01T 16:00:00 - 07:00 < /dcterms:gültig > <ooyala:profileguid > 57d5a5a10f654fe79ef954dc8d29a108 < /ooyala:profileguid > </artikel > </kanal > </rss >
Schritt für Schritt
Erstellen einer XML-Manifestdatei
So erstellen Sie eine XML-Metadatendatei:
- Laden Sie Ihre Videos und andere Inhalte hoch (Miniaturansichten, Untertiteldateien usw.).
- Öffnen Sie einen Texteditor, vorzugsweise einen, der XML validiert.
- Fügen Sie die erforderlichen XML-Header hinzu. Beispiel:
<?xml version="1.0" kodieren="utf-8"?> <rss version="2.0" xmlns: media=“ http://search.yahoo.com/mrss/“ xmlns:dcterms“ http://purl.org/dc/terms/“ xmlns: fh=“ http://purl.org/syndication/history/1.0“ xmlns: ooyala=“ http://www.ooyala.com/mrss/ ">
- Ein ... kreieren channel Container.
- Erstelle ein item Eintrag für jedes Video, der die gewünschten Elemente aus der obigen Tabelle enthält.
Im folgenden Beispiel gibt das XML Metadaten für zwei Videos an. Für das erste Video befinden sich die Datei und die Miniaturansichten auf einem Upload-Server und werden von diesem Server abgerufen. Für das zweite Video wurden die Datei und das Thumbnail bereits auf einen Ooyala-Server hochgeladen. Das zweite Video hat auch Flugzeiten.
<?xml version="1.0" kodieren="utf-8"?> <rss version="2.0" xmlns: media=“ http://search.yahoo.com/mrss/“ xmlns:dcterms“ http://purl.org/dc/terms/“ xmlns: fh=“ http://purl.org/syndication/history/1.0“ xmlns: ooyala=“ http://www.ooyala.com/mrss/ "> <kanal > <Artikel > <media:inhalt url=“ http://mysite.com/upload/lacrosse_70.mov "/> <media:thumbnail url=“ http://mysite.com/upload/lacrosse_70_previewimage.jpg "/> <media:title > Sportarten, die es wirklich gibt: Lacrosse < /media:title > <media:description > Meine Beschreibung meines < Videos/Media:description > <ooyala:labels > /sports/lacrosse, /hobbies/lacrosse < /ooyala:labels > <verlinken > http://mysite.com/videos/sports/real_sports.html < /link > <ooyala:metadata name="Video_ID“ > 70 < /ooyala:metadata > <ooyala:metadata name="season_number“ > < 1/ooyala:metadata > </artikel > <Artikel > <media:inhalt url=“ curling_71.mov "/> <media:thumbnail url=“ curling_71_previewimage.jpg "/> <media:title > Sportarten, die es wirklich gibt: Curling < /media:title > <media:description > Meine Beschreibung meines < Videos/Media:description > <ooyala:labels > /sports/curling, /hobbies/curling < /ooyala:labels > <verlinken > http://mysite.com/videos/sports/real_sports.html < /link > <ooyala:metadata name="video_ID“ > 71 < /ooyala:metadata > <ooyala:metadata name="season_number“ > < 1/ooyala:metadata > <!— Festlegen von Flugzeiten — > <dcterms:gültig > start=2011-06-28T 15:15:00 - 07:00; Ende = 2022-12-01T 16:00:00 - 07:00; Scheme=w3c-dtf </dcterms:gültig > </artikel > </kanal > </rss >
- Speichern Sie die Datei als XML. Stellen Sie sicher, dass Sie einen eindeutigen Namen angeben. Wenn Sie zwei Dateien mit demselben Namen angeben und eine hochladen, während die andere verarbeitet wird, wird die zweite möglicherweise ignoriert.
- Laden Sie mit der Upload-Methode Ihrer Wahl die XML-Manifestdatei hoch, während Sie die Videos hochgeladen haben. Siehe entweder FTP oder Aspera.