A análise de alteração de imagem detecta mudanças na imagem de vídeo.
Nesta seção, apresentamos algumas maneiras de analisar um vídeo quanto a alterações de imagem.
Veja um exemplo de análise de alteração de imagem de vídeo em um arquivo no Cloud Storage.
Procurando informações mais detalhadas? Confira nosso tutorial detalhado do Python.
REST
Enviar solicitação de anotação de vídeo
Veja a seguir como enviar uma solicitação POST para o método videos:annotate
.
O exemplo usa a CLI do Google Cloud para criar um token de acesso. Para
instruções sobre como instalar a gcloud CLI, consulte o
Guia de início rápido da API Video Intelligence.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- INPUT_URI: um bucket do Cloud Storage que contém o arquivo que você quer anotar, incluindo o nome do arquivo. É necessário começar com
gs://
. - PROJECT_NUMBER: o identificador numérico do seu projeto do Google Cloud
Método HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON da solicitação:
{ "inputUri": "INPUT_URI", "features": ["SHOT_CHANGE_DETECTION"] }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Se a resposta for bem-sucedida, a API Video Intelligence vai retornarname
para sua
operação O exemplo acima mostra um exemplo desse tipo de resposta, em que
project-name
é o nome do seu projeto e operation-id
é o ID do
operação de longa duração criada para a solicitação.
- PROJECT_NUMBER: o número do seu projeto
- LOCATION_ID: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são:
us-east1
,us-west1
,europe-west1
easia-east1
. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo de vídeo. - OPERATION_ID: o ID da operação de longa duração criada para a solicitação e fornecida na resposta quando você iniciou a operação. Por exemplo,
12345....
Ver os resultados de anotação
Para recuperar o resultado da operação, faça uma solicitação GET usando o
nome da operação retornado da chamada para videos:annotate
, conforme mostrado no
exemplo a seguir.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- OPERATION_NAME: o nome da operação, conforme retornado pela API Video Intelligence. O nome da operação tem o formato
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
. - PROJECT_NUMBER: o identificador numérico do projeto do Google Cloud
Método HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
As anotações de detecção de enquadramento são retornadas como uma lista deshotAnnotations
.
Observação: o campo done só é retornado quando o valor dele é True.
Ele não é incluído nas respostas de uma operação não concluída.
Fazer o download dos resultados da anotação
Copie a anotação da origem e a cole no bucket de destino: consulte Copiar arquivos e objetos
gcloud storage cp gcs_uri gs://my-bucket
Observação: se o URI de saída do GCS for fornecido pelo usuário, a anotação será armazenada nesse URI.
Go
Java
Para autenticar no Video Intelligence, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para autenticar no Video Intelligence, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber mais sobre como instalar e usar a biblioteca de cliente da API Cloud Video Intelligence para Python, consulte Bibliotecas de cliente da API Video Intelligence.Outras linguagens
C#: Siga as Instruções de configuração do C# na página de bibliotecas de cliente e acesse a Documentação de referência do Video Intelligence para .NET.
PHP: Siga as Instruções de configuração do PHP na página das bibliotecas de cliente e acesse a Documentação de referência do Video Intelligence para PHP.
Ruby: Siga as Instruções de configuração do Ruby na página das bibliotecas de cliente e acesse a Documentação de referência do Video Intelligence para Ruby.