API en direct : Création de clips VOD

Aperçu

Les clips sont des vidéos extraites d'un flux en direct. Ils peuvent être envoyés à un compartiment S3, à un site FTP ou à un Video Cloud compte. Le clip est créé en tant que vidéo MP4, et c'est ce qui est envoyé à la destination dans tous les cas. Dans le cas de Video Cloud, le MP4 sera transcodé par le système ingest, et les types de rendus créés pour la vidéo dépendront du profil d'ingeste utilisé.

Les définitions des clips sont créées à l'aide du /vods point final.

Les clips peuvent être créés de plusieurs manières :

• Avec stream_start_timecode et/ou stream_end_timecode définis dans les codes temporels SMPTE pour l'événement diffusé en direct. Notez que cela nécessite que l'encodeur envoie des informations de timecode
• Avec start_time et/ou end_time définie par rapport à l'heure de début ( stream_start_time) de l'ensemble de l'événement diffusé en direct
• Avec start_time et/ou end_time défini en temps Epoch (Unix) (en secondes)
• Avec duration
• L'API Live et le module Live prennent tous deux en charge la création de clips à partir de travaux cryptés ou protégés par DRM.

Remarques

1. Pour rendre les clips disponibles le plus rapidement possible, un clip précis au segment est d'abord créé, puis remplacé par un clip précis à l'image dès qu'il est disponible.
2. Si vous le spécifiez duration, le clip obtenu sera le suivant :
   • Si l'offre est active et toujours en ligne : (heure de la demande - durée) à (heure de la demande)
   • Si le travail est terminé : ( finished_at- durée) à ( finished_at)
3. Si vous spécifiez à la fois start_time ET end_time:
   • Si la tâche est active et toujours active : tant que la fenêtre de temps Epoch tombe entièrement dans created_at et l'heure de la demande, le clip sera fait
   • Si le travail est terminé : tant que la fenêtre temporelle d'Epoch se situe entièrement dans les limites created_at et finished_at que le clip sera créé
4. Clips de flux en direct utilisant SSAI n'inclura pas d'annonces.
5. Les clips peuvent être créés jusqu'à 7 jours après un événement. Pour SEP, ils peuvent être créés jusqu'à la prochaine activation ou 7 jours (selon la durée la plus courte).
6. L'API VOD n'ajoutera aucun contenu en dehors de ce qui est présent dans le flux. Si vous spécifiez 350 sur un flux en direct de 300 secondes, la sortie durera 300 secondes.
7. Vous n'avez pas besoin d'utiliser un flux en direct compatible DVR pour que l'écrêtage fonctionne, car le flux en direct est stocké au fur et à mesure de sa diffusion et est disponible immédiatement et pendant 7 jours après la fin de l'événement.
8. L'écrêtage Brightcove Live ne produira qu'un élément ayant la même résolution que la sortie de résolution la plus élevée. Il ne correspondra pas à la résolution d'entrée source (à moins qu'elle ne soit la même que la sortie de résolution la plus élevée).

Les clips peuvent également être envoyés vers plusieurs destinations :

• Un Video Cloud compte
• Un serveur FTP
• Un seau S3

Lorsque vous spécifiez un élément, la sortie doit contenir soit une url destination, soit un videocloud objet pour détailler la création du vidéo et l'ingestion du clip dans Video Cloud.

Remarque : clips peut être créé pendant que le flux en direct est en cours d'exécution. Pour ce faire, vous devrez définir les heures de début et de fin du clip en temps Epoch ou par rapport à début l'heure de la diffusion en direct.

Crédits

Si la destination à laquelle vous envoyez le clip nécessite des informations d'identification pour y accéder, vous pouvez les créer à l'aide des opérations d'identification de l'API Live. Voir Gestion des informations d'identification pour l'API Live pour plus de détails.

Point de terminaison

Les clips sont créés en envoyant une POST demande à :

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

Corps de la demande - Video Cloud

Exemple 1 : heures de début/fin par rapport au début du flux

Le corps de la demande comprend les heures de début et de fin, ainsi que des détails sur l'endroit où envoyer le clip. Voici un exemple de corps de requête qui crée un clip de la troisième minute d'un flux et l'envoie à un Video Cloud compte :

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

Dans cet exemple, nous créons un clip d'une durée d'une minute et nous l'envoyons à Video Cloud. Nous donnons au clip un nom et quelques balises, sans spécifier le ingest profile pour le retranscodage, de sorte que la valeur par défaut du compte sera utilisée, et nous vous demandons de Video Cloud capturer des images miniatures et affiches à partir du clip pendant transcodage.

Exemple 2 : heures de début/fin en heure d'époque

Le corps de la demande inclut les heures de début et de fin dans l'heure Epoch, et des détails sur l'endroit où envoyer le clip. Voici un exemple de corps de requête qui crée un clip de la troisième minute d'un flux et l'envoie à un Video Cloud compte :

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

Dans cet exemple, nous créons un clip d'une durée d'une minute à une heure précise d'époque (dans ce cas, le 22 janvier 2018 à 08:24:54 GMT).

Exemple 3 : durée avec heure de début par rapport au début du flux

Le corps de la requête inclut la durée et stream_start_time, ainsi que des détails sur l'endroit où envoyer le clip. Voici un exemple de corps de requête qui crée un clip de la troisième minute d'un flux et l'envoie à un Video Cloud compte :

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

Dans cet exemple, nous créons un clip d'une durée d'une minute commençant 5 minutes après le début de la diffusion en direct.

Exemple 4 : durée sans heure de début ni de fin

Le corps de la demande inclut les heures de début et de fin dans l'heure Epoch, et des détails sur l'endroit où envoyer le clip. Voici un exemple de corps de requête qui crée un clip de la troisième minute d'un flux et l'envoie à un Video Cloud compte :

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

Dans cet exemple, nous créons un clip d'une durée d'une minute. Étant donné que nous ne spécifions pas d'heure de début ou de fin, le clip sera extrait des 60 dernières secondes du flux en direct.

Exemple 5 : utilisation stream_start_timecode et stream_end_timecode

Le corps de la requête inclut les heures et les images de début et de fin dans les codes temporels HH:MM:SS:FF, ainsi que des informations sur l'endroit où envoyer le clip. Notez que pour utiliser des codes temporels, l'encodeur doit envoyer des codes temporels. Voici un exemple de corps de requête qui crée un clip des 50 minutes d'un flux et l'envoie à un Video Cloud compte :

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

Informations générales sur l'envoi de clips à Video Cloud

Pour voir quels champs peuvent être inclus dans le video et ingest objets, voir le 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"
}