GetPlayInfo - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Obtém a URL de reprodução de um arquivo de mídia (vídeo ou áudio) usando um determinado ID de áudio/vídeo. Use esta URL para reprodução de áudio/vídeo após integrar o SDK do Alibaba Cloud Player (para reprodução baseada em URL) ou um player de terceiros.

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

ice:GetPlayInfo

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaId	string	Não	O ID do recurso de mídia. Nota Especifique pelo menos um entre MediaId e InputURL.	86434e152b7d4f20be480574439fe***
InputURL	string	Não	A InputURL usada para registrar o recurso de mídia. Para mais informações, consulte RegisterMediaInfo. Nota Especifique pelo menos um entre MediaId e InputURL.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 or vod://**20b48fb04483915d4f2cd8ac**
AuthTimeout	integer	Não	O período de validade da URL de reprodução, em segundos. O valor padrão é 3600, que também é o mínimo.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	****11-DB8D-4A9A-875B-275798****
MediaBase	object	As informações básicas sobre o recurso de mídia.
CreationTime	string	A hora em que o recurso de mídia foi criado.	2021-09-22T10:07:31+08:00
Status	string	O status do recurso de mídia. Valores válidos: `Init`: O arquivo de origem não está pronto. `Preparing`: O arquivo de origem está sendo preparado. Este processo pode envolver upload ou composição. `PrepareFail`: A preparação do arquivo de origem falhou. Por exemplo, o sistema falhou ao recuperar os metadados do arquivo de origem. `Normal`: O arquivo de origem está pronto.	Normal
MediaId	string	O ID do recurso de mídia.	2eea77a61c7b4ddd95bec34a6f65b***
CoverURL	string	A URL da capa.	https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg
Title	string	O título.	testTitle
MediaType	string	O tipo do arquivo de mídia. Valores válidos: `video`: Um arquivo de vídeo. `audio`: Um arquivo apenas de áudio.	video
MediaTags	string	As tags. Você pode adicionar até 16 tags. Separe várias tags com vírgulas (,). O comprimento máximo de uma tag é de 32 bytes. As tags devem ser codificadas em UTF-8.	test,ccc
CateId	integer	O ID da categoria. Você pode obter o ID da categoria de uma das seguintes maneiras: Faça login no console do IMS e escolha gerenciamento de recursos de mídia > gerenciamento de categorias para visualizar o ID da categoria. A operação de criação de categoria retorna o ID da categoria no parâmetro `CateId`. A operação de obtenção de categoria retorna o ID da categoria no parâmetro `CateId`.	4220
Description	string	A descrição.	desc
PlayInfoList	array<object>	Uma lista de fluxos de reprodução de áudio ou vídeo.
	object	Os detalhes de um fluxo de áudio ou vídeo.
CreationTime	string	A hora de criação. A hora está no formato aaaa-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2022-05-10T02:28:49Z
Status	string	O status do fluxo de mídia. Valores válidos: Normal: O fluxo está disponível. Invisible: O fluxo não está visível.	Normal
NarrowBandType	string	O tipo de Narrowband HD. Valores válidos: 0: regular. 1.0: Narrowband HD 1.0. 2.0: Narrowband HD 2.0. Este parâmetro se aplica apenas se uma definição for configurada no modelo de transcodificação integrado para Narrowband HD 1.0. Para mais informações, consulte Configurar modelos de transcodificação - Definição.	0
Height	integer	A altura do fluxo de mídia em pixels.	1080
Bitrate	string	A taxa de bits do fluxo de mídia em Kbit/s.	20
ModificationTime	string	A hora da última modificação. A hora está no formato aaaa-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2022-05-13T11:39:41.714+08:00
WatermarkId	string	O ID da marca d'água associada ao fluxo de mídia.	5bed88672b1e2520ead228935ed51***
Encrypt	integer	Indica se o fluxo de mídia está criptografado. Valores válidos: 0: Não. 1: Sim.	0
Definition	string	A definição do fluxo de vídeo. Valores válidos: FD: fluente LD: definição padrão SD: alta definição HD: ultra-alta definição OD: original 2K 4K SQ: áudio de qualidade padrão HQ: áudio de alta qualidade AUTO: taxa de bits adaptativa	HD
EncryptType	string	O tipo de criptografia do fluxo de mídia. Valores válidos: AliyunVoDEncryption: Criptografia VoD do Alibaba Cloud. HLSEncryption: Criptografia padrão HLS. Nota Se um fluxo for criptografado com AliyunVoDEncryption, você poderá reproduzi-lo apenas com o SDK do Alibaba Cloud Player.	AliyunVoDEncryption
StreamType	string	O tipo do fluxo de mídia. O valor é video para fluxos de vídeo ou audio para fluxos apenas de áudio.	video
Size	integer	O tamanho do fluxo de mídia em bytes.	418112
Width	integer	A largura do fluxo de mídia em pixels.	1024
Fps	string	A taxa de quadros do fluxo de mídia em quadros por segundo.	25
Duration	string	A duração do fluxo de mídia em segundos.	9.0464
PlayURL	string	A URL de reprodução do fluxo de vídeo.	https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4
Format	string	O formato do fluxo de mídia. Para fluxos de vídeo, os valores válidos são mp4 e m3u8. Para fluxos apenas de áudio, o valor é mp3.	mp4
HDRType	string	O tipo de High Dynamic Range (HDR) do fluxo de mídia. Valores válidos: HDR HDR10 HLG DolbyVision HDRVivid SDR+	HDR
BitDepth	integer	A profundidade de bits de cor.	8
FileURL	string	A URL do arquivo OSS.	http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg
TransTemplateType	string	O tipo do modelo de transcodificação. Valores válidos: `Normal`: transcodificação regular `AudioTranscode`: transcodificação de áudio `Remux`: remuxing `NarrowBandV1`: Narrowband HD 1.0 `NarrowBandV2`: Narrowband HD 2.0 `UHD`: aprimoramento de áudio e vídeo (ultra-alta definição)	Normal
StreamTags	string	As tags de fluxo, que são usadas para identificar o tipo de transcodificação.	"{\"ims.audioServiceType\": \"AudioEnhancement\"}"
JobId	string	O ID do job.	36c9d38e70bf43ed9f7f8f48d6356***

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaBase": {
    "CreationTime": "2021-09-22T10:07:31+08:00",
    "Status": "Normal",
    "MediaId": "2eea77a61c7b4ddd95bec34a6f65b***",
    "CoverURL": "https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg",
    "Title": "testTitle",
    "MediaType": "video",
    "MediaTags": "test,ccc",
    "CateId": 4220,
    "Description": "desc"
  },
  "PlayInfoList": [
    {
      "CreationTime": "2022-05-10T02:28:49Z",
      "Status": "Normal",
      "NarrowBandType": "0",
      "Height": 1080,
      "Bitrate": "20",
      "ModificationTime": "2022-05-13T11:39:41.714+08:00",
      "WatermarkId": "5bed88672b1e2520ead228935ed51***",
      "Encrypt": 0,
      "Definition": "HD",
      "EncryptType": "AliyunVoDEncryption",
      "StreamType": "video",
      "Size": 418112,
      "Width": 1024,
      "Fps": "25",
      "Duration": "9.0464",
      "PlayURL": "https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4",
      "Format": "mp4",
      "HDRType": "HDR",
      "BitDepth": 8,
      "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg",
      "TransTemplateType": "Normal",
      "StreamTags": "\"{\\\"ims.audioServiceType\\\": \\\"AudioEnhancement\\\"}\"",
      "JobId": "36c9d38e70bf43ed9f7f8f48d6356***"
    }
  ]
}

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.