ApsaraVideo VOD:Parâmetros de solicitação

Campo

Tipo

Obrigatório

Descrição

PlayDomain

String

Não

O domínio de streaming. Se você configurar vários nomes de domínio de origem, especifique um nome de domínio para reproduzir o vídeo. Caso o domínio de streaming especificado não exista, a URL de streaming retornará o domínio de streaming padrão configurado para o endereço de armazenamento do vídeo. Exemplo: "vod.test_domain".

XForwardedFor

String

Não

O endereço IP de origem do cliente que inicia a solicitação. Este campo verifica se a solicitação partiu de um endereço IP adicionado a um grupo de segurança de revisão. Para obter mais informações, consulte Visualização de endereço IP de segurança. O ApsaraVideo VOD obtém o endereço IP do cliente com base neste campo após a solicitação passar por vários servidores proxy. Para aumentar a segurança dos dados, o endereço IP do cliente é criptografado usando AES/ECB/PKCS5Padding. Para obter a chave de criptografia, abra um ticket.

Exemplo: yqCD7Fp1uqChoVj/sl/p5Q==.

PreviewTime

String

Não

A duração da visualização. Unidade: segundos. O valor mínimo é 1 e o máximo corresponde à duração total do vídeo. Se este campo ficar vazio, todo o vídeo estará disponível para visualização. Para saber mais sobre como ativar o recurso de visualização, consulte Configurar o recurso de visualização.

MtsHlsUriToken

String

Não

O MtsHlsUriToken gerado por um serviço de emissão de tokens. Use este campo para descriptografar e reproduzir vídeos protegidos com criptografia HTTP Live Streaming (HLS), evitando assim o roubo de chaves de descriptografia. Para obter mais informações, consulte Criptografia HLS.

EncryptType

String

Não

O tipo de criptografia. Defina este campo para reproduzir vídeos sem criptografia ou vídeos com um tipo específico de proteção. Valores válidos:

• Unencrypted: sem criptografia

• AliyunVoDEncryption: criptografia proprietária da Alibaba Cloud

• HLSEncryption: criptografia HLS

StorageClass

String

Não

A classe de armazenamento do ativo de mídia. Utilize este campo para filtrar os streams de reprodução de uma classe de armazenamento específica. Valores válidos:

• Por padrão, este campo permanece vazio. Uma string vazia indica ausência de filtro. Se a classe de armazenamento do arquivo de áudio ou vídeo for Standard, todas as URLs de reprodução dos streams serão retornadas. Caso a classe de armazenamento dos recursos de mídia não seja Standard, nenhuma URL de reprodução será devolvida. Quando a classe de armazenamento do arquivo source não for Standard, apenas as URLs de reprodução dos streams transcodificados serão retornadas, excluindo a URL do stream de qualidade original.

• All: todas as classes de armazenamento.

• Standard: todos os recursos de mídia armazenados como objetos Standard.

• IA: todos os recursos de mídia armazenados como objetos IA.

• Archive: todos os recursos de mídia armazenados como objetos Archive.

• ColdArchive: todos os recursos de mídia armazenados como objetos Cold Archive.

• SourceIA: apenas os arquivos source são objetos IA.

• SourceArchive: apenas os arquivos source são objetos Archive.

• SourceColdArchive: apenas os arquivos source são objetos Cold Archive.

• Changing: a classe de armazenamento dos recursos de mídia está em processo de alteração.

• SourceChanging: a classe de armazenamento do arquivo source está em processo de alteração.

Campo

Tipo

Obrigatório

Descrição

uid

String

Não

Campo adicional. Geralmente definido como 0, mas aceita valores personalizados.

rand

String

Não

Número aleatório. Na maioria dos casos, assume o valor 0. Para gerar uma URL diferente a cada solicitação de vídeo, utilize o UUID como número aleatório.

Campo

Tipo

Obrigatório

Descrição

MessageCallback

String

Não

Configurações de callback para notificações de eventos, representadas por um objeto JSON. Ao preencher este campo, as configurações especificadas terão prioridade; caso contrário, o sistema aplicará as configurações padrão de callback. Para mais informações, consulte Especificar múltiplas URLs de callback.

Os parâmetros são descritos abaixo:

• CallbackType: método de callback. Valores válidos: http e mns.

• CallbackURL: URL de callback HTTP. Obrigatório quando CallbackType for definido como http.

• MNSQueueName: nome da fila do Message Service (MNS). Necessário se CallbackType for igual a mns.

• MSSEndpoint: endpoint da fila MNS. Exigido quando CallbackType estiver configurado como mns.

Exemplos:

• Callback HTTP: {"CallbackType":"http", "CallbackURL":"http://callback-host/addr"}

• Callback MNS: {"CallbackType":"mns","MNSQueueName":"vod-callback-bj","MNSEndpoint":"http://174809843091****.mns.cn-beijing.aliyuncs.com"}

Extend

String

Não

Campo estendido personalizado, transmitido de forma transparente durante os callbacks de eventos. Aceita até 512 bytes e deve ser um objeto JSON.

AccelerateConfig

String

Não

Configurações para aceleração de upload, estruturadas como objeto JSON. Exemplo: {"Type":"oss","Domain":"https://oss-accelerate.aliyuncs.com"}. Type indica o método de aceleração, aceitando apenas o valor oss. Domain representa o nome de domínio acelerado, disponível em Regiões e endpoints. O protocolo HTTPS é utilizado por padrão.

Campo

Tipo

Obrigatório

Descrição

CipherText

String

Sim

Chave cifrada utilizada para recuperar a chave em texto simples. Preencha com o valor de CiphertextBlob retornado na resposta da operação GenerateKMSDataKey.

DecryptKeyUri

String

Sim

URI da chave derivada da chave cifrada. Composta pelo endereço IP do serviço de descriptografia concatenado ao valor de Ciphertext.

Refere-se ao serviço de descriptografia implementado por você. Por exemplo, se o IP do seu serviço for http://demo.aliyundoc.com, configure o parâmetro assim:

http://demo.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt****

KeyServiceType

String

Sim

Tipo de serviço de chave. Valor padrão: KMS, referente ao Key Management Service da Alibaba Cloud.

Campo

Tipo

Obrigatório

Descrição

CellWidth

String

Não

Largura dos snapshots originais que formam o sprite de imagem. Padrão: largura de um snapshot normal. Unidade: pixels.

CellHeight

String

Não

Altura dos snapshots originais que compõem o sprite de imagem. Padrão: altura de um snapshot normal. Unidade: pixels.

Padding

String

Não

Espaçamento interno entre os snapshots originais no sprite de imagem. Padrão: 0. Unidade: pixels.

Margin

String

Não

Margem externa dos snapshots originais no sprite de imagem. Padrão: 0. Unidade: pixels.

Color

String

Não

Cor de fundo do sprite de imagem. Padrão: Preto.

Columns

String

Não

Quantidade de colunas para organizar os snapshots originais no sprite. Intervalo válido: [1,10000]. Padrão: 10.

Lines

String

Não

Número de linhas para dispor os snapshots originais no sprite. Intervalo válido: [1,10000]. Padrão: 10.

KeepCellPic

String

Não

Indica se os snapshots originais que formam o sprite devem ser mantidos. Valores válidos:

• keep

• exclua

Valor padrão: keep.