Live-API: VOD-Clips erstellen

Überblick

Clips sind Videos, die aus einem Livestream extrahiert wurden. Sie können an einen S3-Bucket, eine FTP-Site oder eine gesendet werden Video Cloud Konto. Der Clip wird als MP4-Video erstellt und in jedem Fall an das Ziel gesendet. Im Falle von Video Cloud Der MP4 wird vom Aufnahmesystem transkodiert, und welche Arten von Wiedergaben für das Video erstellt werden, hängt vom verwendeten Aufnahmeprofil ab.

Definitionen für Clips werden mit dem /vods Endpunkt.

Clips können auf verschiedene Arten erstellt werden:

• Mit stream_start_timecode und/oder stream_end_timecode in SMPTE-Timecodes für das Live-Stream-Ereignis definiert - Beachten Sie, dass dies erfordert, dass der Encoder Timecode-Informationen sendet
• Mit start_time und/oder end_time definiert relativ zur Startzeit ( stream_start_time) des gesamten Live-Stream-Events
• Mit start_time und/oder end_time definiert in Epoche (Unix) Zeit (in Sekunden)
• Mit duration
• Sowohl die Live-API als auch das Live-Modul unterstützen die Erstellung von Clips aus verschlüsselten oder DRM-geschützten Aufträgen.

Hinweise

1. Um Clips möglichst schnell zur Verfügung zu stellen, wird zunächst ein segmentgenauer Clip erstellt und dann, sobald dieser verfügbar ist, durch einen framegenauen Clip ersetzt.
2. Wenn Sie dies angeben duration, sieht der resultierende Clip wie folgt aus:
   • Wenn der Job aktiv und noch aktiv ist: (Anfragezeit - Dauer) bis (Anfragezeit)
   • Wenn der Job beendet ist: ( finished_at- Dauer) bis ( finished_at)
3. Wenn Sie beide angeben start_time UND end_time:
   • Wenn der Job aktiv ist und noch lebt: solange das Epochenzeitfenster vollständig in created_at und der Wunschzeit wird der Clip gemacht
   • Wenn der Job abgeschlossen ist: Solange das Zeitfenster der Epoche vollständig innerhalb von created_at und liegt finished_at, wird der Clip erstellt
4. Clips von Livestreams mit SSAI wird keine Werbung enthalten.
5. Clips können bis zu 7 Tage nach einem Ereignis erstellt werden. Zum SEP Sie können bis zur nächsten Aktivierung oder bis zu 7 Tagen (je nachdem, welcher Zeitraum kürzer ist) erstellt werden.
6. Die VOD-API fügt keine Inhalte hinzu, die nicht im Stream vorhanden sind. Wenn Sie 350 in einem 300 Sekunden langen Livestream angeben, ist die Ausgabe 300 Sekunden lang.
7. Sie müssen keinen DVR-fähigen Livestream verwenden, damit Clipping funktioniert, da der Livestream so gespeichert wird, wie er gesendet wird und sofort und 7 Tage nach Ende der Veranstaltung verfügbar ist.
8. Brightcove Live-Clipping erzeugt nur einen Clip, der dieselbe Auflösung wie die Ausgabe mit der höchsten Auflösung aufweist. Sie stimmt nicht mit der Eingangsauflösung der Quelle überein (es sei denn, diese entspricht der Ausgabe mit der höchsten Auflösung).

Clips können auch an mehrere Ziele gesendet werden:

• EIN Video Cloud Konto
• Ein FTP-Server
• Ein S3-Eimer

Wenn Sie einen Clip angeben, wird die Ausgabe Muss enthalten entweder ein url Ziel oder ein videocloud Objekt, um die Erstellung des Videos und die Aufnahme des Clips im Detail zu detaillieren Video Cloud.

Hinweis: Clips kann während des Livestreams erstellt werden. Dazu müssen Sie die Start- und Endzeit des Clips in Epochenzeit oder relativ zu Anfang Uhrzeit des Livestreams.

Referenzen

Wenn das Ziel, an das Sie den Clip senden, Zugangsdaten erfordert, können Sie diese mit den Zugangsdatenvorgängen der Live-API erstellen. Sehen Verwalten von Anmeldeinformationen für die Live-API für mehr Details.

Endpunkt

Clips werden erstellt, indem Sie a POST Anfrage zu:

https://api.bcovlive.io/v1/vods

Text anfordern - Video Cloud

Beispiel 1: Start-/Endzeiten relativ zum Stream-Start

Der Anfragetext enthält Start- und Endzeiten sowie Details dazu, wohin der Clip gesendet werden soll. Hier ist ein Beispielanforderungshauptteil, der einen Clip der dritten Minute eines Streams erstellt und an a sendet Video Cloud Konto:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs by stream from min 2 to min 3",
      "stream_start_time": 120,
      "stream_end_time": 180,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
          "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

In diesem Beispiel erstellen wir einen Clip mit einer Dauer von einer Minute und senden ihn an Video Cloud. Wir geben dem Clip einen Namen und ein paar Tags, ohne die anzugeben ingest profile für die erneute Codierung, damit die Standardeinstellung des Kontos verwendet wird, und Anweisungen Video Cloud um während der Transcodierung Miniatur- und Posterbilder aus dem Clip aufzunehmen.

Beispiel 2: Start-/Endzeiten in Epochenzeit

Der Anforderungstext enthält Start- und Endzeiten in Epochenzeit und Details dazu, wohin der Clip gesendet werden soll. Hier ist ein Beispielanforderungshauptteil, der einen Clip der dritten Minute eines Streams erstellt und an a sendet Video Cloud Konto:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
    "outputs":[
      {
        "label": "60 secs - epoch time",
        "start_time": 1516652694,
        "end_time": 1516652754,
        "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
        "videocloud": {
          "video": {
          "name": "One Minute Clip",
          "tags": ["live", "clip"]
          },
            "ingest": {
            "capture-images": true
        }
      }
    }
  ]
}

In diesem Beispiel erstellen wir einen Clip mit einer Dauer von einer Minute zu einer bestimmten Epochenzeit (in diesem Fall am 22. Januar 2018 um 08:24:54 GMT).

Beispiel 3: Dauer mit Startzeit relativ zum Stream-Start

Der Anforderungstext enthält die Dauer und stream_start_time sowie Details dazu, wohin der Clip gesendet werden soll. Hier ist ein Beispielanforderungshauptteil, der einen Clip der dritten Minute eines Streams erstellt und an a sendet Video Cloud Konto:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs from start time",
      "stream_start_time": 300,
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true,
        "profile": "valid-ingest-profile-name"
        }
      }
    }
  ]
}

In diesem Beispiel erstellen wir einen einminütigen Clip, der 5 Minuten nach dem Start des Livestreams beginnt.

Beispiel 4: Dauer ohne Start- oder Endzeit

Der Anforderungstext enthält Start- und Endzeiten in Epochenzeit und Details dazu, wohin der Clip gesendet werden soll. Hier ist ein Beispielanforderungshauptteil, der einen Clip der dritten Minute eines Streams erstellt und an a sendet Video Cloud Konto:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "60 secs - duration",
      "duration": 60,
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
        "name": "One Minute Clip",
        "tags": ["live", "clip"]
        },
        "ingest": {
          "capture-images": true
        }
      },
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ]
}

In diesem Beispiel erstellen wir einen Clip von einer Minute Dauer. Da wir keine Start- oder Endzeit angeben, wird der Clip aus den letzten 60 Sekunden des Livestreams entnommen.

Beispiel 5: Verwendung von stream_start_timecode und stream_end_timecode

Der Anforderungstext enthält Start- und Endzeiten/Frames in HH:MM:SS:FF-Timecodes sowie Details darüber, wohin der Clip gesendet werden soll. Beachten Sie, dass der Encoder Timecodes senden muss, um Timecodes zu verwenden. Hier ist ein Beispielanforderungshauptteil, der einen Clip der 50 Minuten eines Streams erstellt und an a sendet Video Cloud Konto:

{
  "live_job_id":"PUT-LIVE-JOB-ID-HERE",
  "outputs":[
    {
      "label": "Clipping using Timecode from-01:10:18:15 to-01:11:08:15",
      "stream_start_timecode": "01:10:18:15",
      "stream_end_timecode": "01:11:08:15",
      "credentials": "USER_VIDEOCLOUD_CREDENTIAL_LABEL",
      "videocloud": {
        "video": {
          "name": "Fifty Minute Clip",
          "tags": ["live", "clip"]
        },
        "ingest": {
        "capture-images": true
        }
      }
    },
    "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
  ]
}

Allgemeine Informationen zum Senden von Clips an Video Cloud

Um zu sehen, welche Felder in der enthalten sein können video und ingest Objekte, siehe die Dynamic Ingest API Reference.

{
  "live_job_id":"",
  "outputs":[
    {
      "label": "last_30",
      "duration": 30,
      "url": "s3://YOUR_BUCKET_NAME/file_name.mp4",
      "credentials": "s3-credentials",
      "notifications": ["https://myserver.com/api/notification_listener?type=jvod"]
    }
  ],
}

{
  "vod_jobs": [
    {
      "jvod_id": "9582606c50d84be5ad4bc104f2aa3360",
      "label": "last 60 secs of live job"
    }
  ],
  "live_job_id": "88ba5d87b61a4ef3a6dddabd0c38d319"
}