Support Kontaktieren Sie Support | Systemstatus Systemstatus
Inhalt der Seite

    Ooyala-Video Cloud Aufnahmeadapter: XML-Manifest-Dateien

    Sie können weiterhin FTP, Aspera oder MRSS mit einem XML-Manifest verwenden, um Ihre Videos in Video Cloud aufzunehmen. In diesem Thema wird die Struktur des XML erläutert.

    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.

    Notiz: Dieses Thema gilt für OIS v2.5.

    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:

    1. 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 produzieren meta::category::cooking
    2. 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.

    Elemente des XML-Manifests
    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: Verwenden Sie für ein Remote-Asset <ooyala:remoteasset> stattdessen. 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:
    • Dateiname eines Thumbnails, das Sie hochgeladen haben.
    • URL, in der sich das Thumbnail befindet. Die URL kann http:// oder enthalten https://.
    fakultativ
    <media:subTitle> Gibt eine Untertiteldatei an (unterstützt für DFXP-, WebVTT- und SRT-Dateien). Sehen Aufnahme von Untertiteldateien. Attribute:
    • href(erforderlich) - Eine der folgenden Möglichkeiten:
      • Dateiname der von Ihnen hochgeladenen Untertiteldatei. Beispiel: caption-1.dfxp
      • URL, unter der sich die Datei mit Untertiteln befindet. Die URL kann http:// oder enthalten https://.
      lang(optional) - Sprache der Untertiteldatei. Code aus zwei Buchstaben. Sehen Unterstützte Untertitel.
    • frameRate(optional) - Bildrate der Untertiteldatei. Einheiten sind in Frames pro Sekunde (FPS). Der Standardwert ist 30. Ältere Dateien mit Untertiteln könnten 24 sein.
    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:
    • durationInMs: Mediendauer (in Millisekunden)
    • url:: URL des Remote-Assets. Die URL kann http:// oder enthalten https://.
    Diese Einstellung entspricht dem Wert von hosted_at Eigenschaft für ein entferntes Asset. Beispiel: <ooyala:remoteasset durationInMs='5000' url="http://your_website/your_remote_assets.mp4" />
    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:

    1. Laden Sie Ihre Videos und andere Inhalte hoch (Miniaturansichten, Untertiteldateien usw.).
    2. Öffnen Sie einen Texteditor, vorzugsweise einen, der XML validiert.
    3. 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/ ">
    4. Ein ... kreieren channel Container.
    5. 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 >    
    6. 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.
    7. Laden Sie mit der Upload-Methode Ihrer Wahl die XML-Manifestdatei hoch, während Sie die Videos hochgeladen haben. Siehe entweder FTP oder Aspera.

    Seite zuletzt aktualisiert am 29 Sep. 2020