Support Kontakt Support | Systemstatus Systemstatus
Seiteninhalt

    Benachrichtigungen für Dynamic Ingest

    In diesem Thema erfahren Sie mehr über Benachrichtigungen für Dynamic Delivery-Ingest-Jobs, die mit der Funktion Dynamic Ingest API.

    Dynamic Ingest API Benachrichtigungen

    Sie können eine oder mehrere Rückruf-URLs angeben, um Benachrichtigungen über die Ergebnisse des Aufnahmeprozesses zu erhalten. Die von Ihnen angegebenen URLs sollten für Apps gelten, die POST-Anforderungen akzeptieren können. Benachrichtigungen werden im JSON-Format gesendet.

    Einrichtung

    Hier ist ein Beispiel.

    • Benutzer mit der Pub-ID 57838016001
    • Möchte Dynamic Ingest zum Hochladen einer Quellvideodatei verwenden, die sich unter https://s3.amazonaws.com/bucket/mysourcevideo.mp4 befindet
    • Möchte einen vorhandenen Titel im Katalog mit der Video-ID 5199670523001 hochladen
    • Verwenden des Multi-Plattform-Standard-statischen Profils
    • Will Callbacks an zwei Endpunkten empfangen, die sich unter http: // host1 / path1 bzw. http: // host2 / path2 befinden

    Die DI-Anfrage würde folgendermaßen aussehen:

    POST-Anfrage

    Anfrage Körper

        {
          "master": {
            "url": "https://s3.amazonaws.com/bucket/mysourcevideo.mp4"
          },
          "profile": "multi-platform-standard-static",
          "callbacks": ["http://host1/path1”, “http://host2/path2”]
        }

    Beispielbenachrichtigung

    Benachrichtigungen werden als POST-Anfragen mit der Benachrichtigung im Anfragetext als JSON gesendet [1] . Hier finden Sie einen vollständigen Satz von Benachrichtigungen von einem typischen Video-Ingest-Job:

    {
          "entity": "default\/audio192",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio192",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio64",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio64",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio96",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio96",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/audio128",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/audio128",
          "language": "en",
          "variant": "main",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "DIGITAL_MASTER",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video450",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video450",
          "bitrate": 451,
          "width": 480,
          "height": 270,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "TITLE",
          "version": "1",
          "action": "PUBLISH",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "thumbnail",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "poster",
          "entityType": "ASSET",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video900",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video900",
          "bitrate": 901,
          "width": 640,
          "height": 360,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video700",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video700",
          "bitrate": 700,
          "width": 640,
          "height": 360,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video1200",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video1200",
          "bitrate": 1204,
          "width": 960,
          "height": 540,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video1700",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video1700",
          "bitrate": 1703,
          "width": 960,
          "height": 540,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video3500",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video3500",
          "bitrate": 3498,
          "width": 1920,
          "height": 1080,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video2000",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video2000",
          "bitrate": 2000,
          "width": 1280,
          "height": 720,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "default\/video3800",
          "entityType": "DYNAMIC_RENDITION",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "dynamicRenditionId": "default\/video3800",
          "bitrate": 3804,
          "width": 1920,
          "height": 1080,
          "accountId": "57838016001",
          "status": "SUCCESS"
        }
    {
          "entity": "5660367449001",
          "entityType": "TITLE",
          "version": "1",
          "action": "CREATE",
          "jobId": "d3ef8751-2b88-4141-95d5-83f0393aca07",
          "videoId": "5660367449001",
          "accountId": "57838016001",
          "status": "SUCCESS"
        }

    Benachrichtigungsfelder

    Artikel Beschreibung
    status wird sein FAILED wenn das Einlesen oder Erstellen einer Wiedergabe nicht erfolgreich war, SUCCESS wenn die Anfrage erfolgreich war
    accountId die Konto-ID
    videoId die Video-ID
    jobId die Job-ID für die dynamische Ingest-Anfrage
    entity entweder der Name der Entität oder die Video Cloud ID des Videos für den TITEL
    entityType die Art von Asset, auf die berichtet wird - zum Beispiel: TITLE (ein Video), DIGITAL_MASTER, ASSET (eine Wiedergabe, eine Bildunterschriftdatei oder ein Bild)
    bitrate Bitrate für eine Wiedergabe
    width Rahmenbreite für eine Wiedergabe
    height Rahmenhöhe für eine Wiedergabe
    errorMessage eine Erklärung, warum die Aufnahme fehlgeschlagen ist, wenn sie es getan hat
    version eine Zeichenkette, die immer gleich ist "1"
    action die Aktion, die aufgetreten ist - zum Beispiel CREATE

    Benachrichtigungen interpretieren

    Eine Benachrichtigung mit "action": "CREATE" und "status": "SUCCESS" zeigt den Abschluss eines Prozesses an.

    • Wenn die entityType is TITLE, dann ist die Verarbeitung eines aufgenommenen Videos abgeschlossen.
    • Für entityType: TITLE, action: PUBLISH bezieht sich auf die Zeit, zu der das Video aktiviert wird. Bei Videos, die sofort aktiv sind, entspricht dies etwa der Zeit CREATE Zeit.
    • Wenn die entityType is ASSET, DYNAMIC_RENDITION or DIGITAL_MASTER, dann wurde eine Wiedergabe, ein Bild, ein Manifest, eine WebVTT-Datei oder ein digitaler Master erfolgreich zu Ihrem Video hinzugefügt.

    Seite zuletzt aktualisiert am 29