La fonction d'analyse de changements de plans détecte les changements de plans dans une vidéo.
Cette section présente plusieurs méthodes permettant d'analyser les changements de plans d'une vidéo.
Voici l'exemple d'une analyse des changements de plans d'un fichier vidéo se trouvant dans Google Cloud Storage.
Vous souhaitez obtenir une analyse plus approfondie ? Consultez le tutoriel détaillé en Python.
API REST et ligne de commande
Envoyer une requête d'annotation vidéo
Vous trouverez ci-dessous la procédure à suivre pour envoyer une requête POST à la méthode videos:annotate
.
Il utilise le jeton (token
) d'accès associé à un compte de service configuré pour le projet à l'aide du SDK Cloud. Pour obtenir des instructions sur l'installation du SDK Cloud, la configuration d'un projet avec un compte de service et l'obtention d'un jeton d'accès, consultez la page Guide de démarrage rapide de l'API Video Intelligence.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- INPUT_URI/var>: a Cloud Storage bucket that contains
the file you want to annotate, including the file name. Must
start with
gs://
.
Méthode HTTP et URL :
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corps JSON de la requête :
{ "inputUri": "INPUT_URI", "features": ["SHOT_CHANGE_DETECTION"] }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Si la réponse aboutit, l'API Video Intelligence renvoie lename
de votre opération. L'exemple ci-dessus montre un exemple de ce type de réponse, où project-name
est le nom de votre projet et operation-id
est l'ID de l'opération de longue durée créée pour la requête.
- PROJECT_NUMBER : numéro de votre projet.
- LOCATION_ID : région cloud dans laquelle l'annotation doit avoir lieu. Les régions cloud compatibles sont les suivantes :
us-east1
,us-west1
,europe-west1
etasia-east1
. Si aucune région n'est spécifiée, une région sera déterminée en fonction de l'emplacement du fichier vidéo. - OPERATION_ID : ID de l'opération de longue durée créée pour la requête, qui est fourni dans la réponse renvoyée au démarrage de l'opération, par exemple
12345....
Obtenir des résultats d'annotation
Pour récupérer le résultat de l'opération, envoyez une requête GET en utilisant le nom de l'opération renvoyé par l'appel à videos:annotate
, comme indiqué dans l'exemple suivant.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- OPERATION_NAME: nom de l'opération tel qu'il a été renvoyé par l'API Video Intelligence. Il est au format suivant :
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
.
Méthode HTTP et URL :
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Les annotations de détection de plans sont renvoyées sous la forme d'une listeshotAnnotations
.
Remarque : Le champ done n'est renvoyé que lorsque sa valeur est True.
Il n'est pas inclus dans les réponses pour lesquelles l'opération n'est pas terminée.
Télécharger les résultats d'annotation
Copiez l'annotation de la source dans le bucket de destination: (voir Copier les fichiers et les objets).
gsutil cp gcs_uri gs://my-bucket
Remarque: Si l'URI gcs de sortie est fourni par l'utilisateur, l'annotation est stockée dans cet URI gcs.