DetectMediaMeta - Intelligent Media Management: Central de Documentação do Alibaba Cloud

Obtém os metadados de um arquivo de mídia, incluindo informações de formato de mídia e informações de fluxo de mídia.

Descrição da operação

Antes de usar esta operação, certifique-se de estar familiarizado com a cobrança do Intelligent Media Management (IMM) e seus preços.
Antes de chamar esta operação, certifique-se de que há um projeto disponível na região atual. Para mais informações, consulte Gerenciamento de projetos.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

imm:DetectMediaMeta

none

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProjectName	string	Não	O nome do projeto. Para obter informações sobre como obter o nome do projeto, consulte Criar um projeto.	test-project
SourceURI	string	Não	O URI do Object Storage Service (OSS) do arquivo de mídia. O URI do OSS segue o formato oss://${Bucket}/${Object}, onde `${Bucket}` é o nome de um bucket do OSS na mesma região do projeto atual, e `${Object}` é o caminho completo do arquivo, incluindo a extensão do nome do arquivo.	oss://examplebucket/sampleobject.mp4
CredentialConfig	CredentialConfig	Não	Deixe este parâmetro vazio, a menos que tenha requisitos especiais. A configuração de autorização em cadeia. Este parâmetro é opcional. Para mais informações, consulte Usar autorização em cadeia para acessar recursos de outras entidades.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	2213B1A9-EB3D-4666-84E0-24980BC*****
Language	string	O idioma usado no vídeo. O valor segue o padrão ISO 639-2.	eng
Title	string	O título do arquivo de mídia.	test
VideoStreams	array	O array de fluxos de vídeo.
	VideoStream	As informações do fluxo de vídeo.
AudioStreams	array	O array de fluxos de áudio.
	AudioStream	As informações do fluxo de áudio.
Subtitles	array	O array de fluxos de legendas.
	SubtitleStream	As informações do fluxo de legendas.
StreamCount	integer	O número de fluxos de mídia.	2
ProgramCount	integer	O número de programas.	2
FormatName	string	O nome do formato.	mov,mp4,m4a,3gp,3g2,mj2
FormatLongName	string	O nome completo do formato.	QuickTime / MOV
Size	integer	O tamanho do arquivo de mídia, em bytes.	25115517
StartTime	number	O tempo inicial de reprodução da mídia, em segundos.	0.000000
Bitrate	integer	A taxa de bits do arquivo de mídia, em bit/s.	13164131
Artist	string	O artista.	unable
AlbumArtist	string	O artista do álbum.	unable
Composer	string	O compositor.	unable
Performer	string	O intérprete.	unable
Album	string	O álbum.	unable
Duration	number	A duração total do vídeo, em segundos.	15.263000
ProduceTime	string	A hora em que o vídeo foi gravado. O valor segue o padrão RFC 3339 Nano.	2022-04-24T02:39:57Z
LatLong	string	O ponto central de coordenadas geográficas, que é um valor de latitude e longitude. O formato é latitude,longitude, com a latitude primeiro e a longitude depois. O intervalo de latitude é [-90,+90] e o intervalo de longitude é [-180,+180]. Exemplo: 35.8,-45.91.	+120.029003,+30.283095
VideoWidth	integer	A largura do quadro de vídeo no arquivo de mídia, em pixels.	1080
VideoHeight	integer	A altura do quadro de vídeo no arquivo de mídia, em pixels.	1920
Addresses	array	Os resultados da detecção de geolocalização do vídeo. Este parâmetro tem um valor apenas quando o vídeo contém informações de geolocalização.
	Address	As informações detalhadas de localização.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2213B1A9-EB3D-4666-84E0-24980BC*****",
  "Language": "eng",
  "Title": "test",
  "VideoStreams": [
    {
      "Index": 0,
      "Language": "en",
      "CodecName": "h264",
      "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
      "Profile": "High",
      "CodecTimeBase": "1373627/83160000",
      "CodecTagString": "avc1",
      "CodecTag": "0x31637661",
      "Width": 1280,
      "Height": 720,
      "HasBFrames": 2,
      "SampleAspectRatio": "1:1",
      "DisplayAspectRatio": "16:9",
      "PixelFormat": "yuv420p",
      "Level": 40,
      "FrameRate": "25/1",
      "AverageFrameRate": "25/1",
      "TimeBase": "1/12800",
      "StartTime": 0,
      "Duration": 22.88,
      "Bitrate": 5407765,
      "FrameCount": 572,
      "Rotate": "90",
      "BitDepth": 8,
      "ColorSpace": "bt709",
      "ColorRange": "tv",
      "ColorTransfer": "bt709",
      "ColorPrimaries": "bt709"
    }
  ],
  "AudioStreams": [
    {
      "Index": 1,
      "Language": "en",
      "CodecName": "aac",
      "CodecLongName": "AAC (Advanced Audio Coding)",
      "CodecTimeBase": "1/44100",
      "CodecTagString": "mp4a",
      "CodecTag": "0x6134706d",
      "TimeBase": "1/48000",
      "StartTime": 0.0235,
      "Duration": 3.690667,
      "Bitrate": 320087,
      "FrameCount": 173,
      "Lyric": "test",
      "SampleFormat": "fltp",
      "SampleRate": 48000,
      "Channels": 2,
      "ChannelLayout": "stereo"
    }
  ],
  "Subtitles": [
    {
      "Index": 2,
      "Language": "en",
      "CodecName": "mov_text",
      "CodecLongName": "MOV text",
      "CodecTagString": "tx3g",
      "CodecTag": "0x67337874",
      "StartTime": 0,
      "Duration": 71.378,
      "Bitrate": 74,
      "Content": "欢迎",
      "Width": 600,
      "Height": 30
    }
  ],
  "StreamCount": 2,
  "ProgramCount": 2,
  "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
  "FormatLongName": "QuickTime / MOV",
  "Size": 25115517,
  "StartTime": 0,
  "Bitrate": 13164131,
  "Artist": "unable",
  "AlbumArtist": "unable",
  "Composer": "unable",
  "Performer": "unable",
  "Album": "unable",
  "Duration": 15.263,
  "ProduceTime": "2022-04-24T02:39:57Z",
  "LatLong": "+120.029003,+30.283095",
  "VideoWidth": 1080,
  "VideoHeight": 1920,
  "Addresses": [
    {
      "Language": "zh-Hans",
      "AddressLine": "中国浙江省杭州市余杭区文一西路969号",
      "Country": "中国",
      "Province": "浙江省",
      "City": "杭州市",
      "District": "余杭区",
      "Township": "文一西路"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.