Cette page vous explique comment créer et gérer des extraits de chaînes de l'API Live Stream. Un extrait de chaîne est une sous-ressource d'une chaîne. Vous pouvez utiliser un extrait de chaîne pour créer des fichiers de vidéo à la demande (VOD) à partir d'une diffusion en direct ; Ces fichiers VOD sont enregistrées dans Cloud Storage. Pour en savoir plus, consultez Créer des extraits VOD à partir d'une diffusion en direct
Configurer votre authentification et votre projet Google Cloud
Si vous n'avez pas créé projet Google Cloud et identifiants, consultez la page Avant de commencerPrérequis
Avant de créer un extrait de chaîne, vous devez créer les ressources suivantes:
Créer un extrait de chaîne
Assurez-vous de créer la chaîne. et commencer à diffuser du contenu sur la chaîne avant de créer un clip.
Pour créer un extrait de chaîne, utilisez l'
projects.locations.channels.clips.create
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: votre projet Google Cloud numéro ; celui-ci est indiqué dans le champ Numéro du projet Page Paramètres IAMLOCATION
: emplacement où se trouve votre chaîne localisé ; utilisez l'une des régions disponibles. <ph type="x-smartling-placeholder"></ph> Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: identifiant de la chaîne défini par l'utilisateurCLIP_ID
: identifiant défini par l'utilisateur pour le clip VOD.MARK_IN_TIME
: l'heure de l'epoch Unix marque dans le fichier manifeste d'origine de la diffusion en direct ; utilise un code temporel selon la RFC3339 UTC "Zulu" ; (par exemple,2014-10-02T15:01:23Z
).MARK_OUT_TIME
: heure de l'epoch Unix Markdown dans le fichier manifeste de la diffusion en direct d'origine. utilise un code temporel selon la RFC3339 UTC "Zulu" ; (par exemple, exemple :2014-10-02T15:01:23Z
)BUCKET_NAME
: nom de l'instance Cloud Storage le bucket que vous avez créé pour contenir le fichier manifeste et les fichiers segments pour les extraits vidéo à la demande ; vous pouvez utiliser le même bucket que vous avez créé pour le fichier manifeste de diffusion en direct ou un autre bucket ; vous pouvez aussi ajouter un répertoire au nom du bucket (par exemple,my-bucket/vod-clip
)
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID/clips/CLIP_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
Cette commande crée une opération de longue durée (LRO) que vous pouvez utiliser pour suivre la progression de votre demande. Voir Gérer les opérations de longue durée pour plus d'informations.
Obtenir les détails des extraits de la chaîne
Pour obtenir les détails d'un extrait de chaîne, utilisez l'icône
projects.locations.channels.clips.get
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: votre projet Google Cloud numéro ; celui-ci est indiqué dans le champ Numéro du projet Page Paramètres IAMLOCATION
: emplacement où se trouve votre chaîne localisé ; utilisez l'une des régions disponibles. <ph type="x-smartling-placeholder"></ph> Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: identifiant de la chaîne défini par l'utilisateurCLIP_ID
: identifiant défini par l'utilisateur pour le clip VOD.
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID/clips/CLIP_ID", "createTime": CREATE_TIME, "startTime": START_TIME, "updateTime": UPDATE_TIME, "state": "SUCCEEDED", "outputUri": "gs://BUCKET_NAME", "slices": [ { "timeSlice": { "markinTime": "MARK_IN_TIME", "markoutTime": "MARK_OUT_TIME" } } ], "features": {}, "clipManifests": [ { "manifestKey": "manifest_hls", "outputUri": "gs://BUCKET_NAME/main.m3u8" } ] }
Seuls les 1 000 enregistrements de jobs d'extraits vidéo les plus récents par canal sont disponibles.
à l'aide du
projects.locations.channels.clips.get
. Tous les enregistrements de jobs d'extraction plus anciens que la limite sont supprimés. Vous devez gérer l'extrait généré
spécifiés par le paramètre
outputUri
;
l'API Live Stream ne supprime pas ces fichiers de Cloud Storage.
Lister les extraits de la chaîne
Pour lister tous les clips que vous avez créés pour une chaîne, utilisez l'icône
projects.locations.channels.clips.list
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_NUMBER
: votre projet Google Cloud numéro ; celui-ci est indiqué dans le champ Numéro du projet Page Paramètres IAMLOCATION
: emplacement où se trouve votre chaîne localisé ; utilisez l'une des régions disponibles. <ph type="x-smartling-placeholder"></ph> Afficher les lieuxus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: identifiant de la chaîne défini par l'utilisateur
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "clips": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID/clips/CLIP_ID", "createTime": CREATE_TIME, "startTime": START_TIME, "updateTime": UPDATE_TIME, "state": "SUCCEEDED", "outputUri": "gs://BUCKET_NAME", "slices": [ { "timeSlice": { "markinTime": "MARK_IN_TIME", "markoutTime": "MARK_OUT_TIME" } } ], "features": {}, "clipManifests": [ { "manifestKey": "manifest_hls", "outputUri": "gs://BUCKET_NAME/main.m3u8" } ] }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID/clips/my-clip2", "createTime": CREATE_TIME, "startTime": START_TIME, "updateTime": UPDATE_TIME, "state": "SUCCEEDED", "outputUri": "gs://BUCKET_NAME", "slices": [ { "timeSlice": { "markinTime": "MARK_IN_TIME", "markoutTime": "MARK_OUT_TIME" } } ], "features": {}, "clipManifests": [ { "manifestKey": "manifest_hls", "outputUri": "gs://BUCKET_NAME/main.m3u8" } ] } ] }