ApsaraVideo VOD:Personalizar nomes de arquivos transcodificados

Definição de nome de arquivo

Um nome de arquivo é composto por strings variáveis e strings fixas. Strings variáveis são caracteres curinga específicos fornecidos pelo VOD que podem ser substituídos dinamicamente. Strings fixas não admitem substituição dinâmica.

• Strings variáveis

  Strings variáveis, também conhecidas como caracteres curinga, atuam como espaços reservados para valores específicos. Ao defina um caractere curinga, o VOD recupera o valor correspondente e o utiliza para substituir o curinga durante a geração do nome do arquivo transcodificado. O VOD oferece suporte aos seguintes caracteres curinga:

  • ID do vídeo: {MediaId}. Garante unicidade parcial, pois um único vídeo pode ter múltiplas saídas transcodificadas.

  • ID do job de transcodificação: {JobId}. Oferece unicidade total e identifica exclusivamente um arquivo transcodificado.

  • Marca de definição de reprodução: {PlayDefinition}. Não é um identificador único.

    Nota

    A marca de definição de reprodução corresponde ao valor do campo Definition retornado pela operação GetPlayInfo. Esse valor é uma string em letras minúsculas.

• Strings fixas

  Strings fixas podem representar informações comerciais específicas. Por exemplo, watermark indica uma saída com marca d'água e encrypt indica uma saída criptografada. Nas regras padrão fornecidas pelo VOD, uma saída de transcodificação criptografada inclui a palavra-chave encrypt-stream. Use regras personalizadas para configure strings fixas conforme os atributos comerciais da sua aplicação.

  Exemplo: Em {MediaId}/{JobId}-watermark-sd e {MediaId}/encrypt-hd, as palavras-chave watermark e encrypt indicam informações sobre marca d'água e criptografia.

Unicidade dos nomes de arquivo

Para evitar que os arquivos de saída transcodificados sejam sobrescritos, o nome configurado para cada arquivo deve ser exclusivo.

• Exemplo de unicidade:

  {MediaId}/{JobId}. {MediaId} fornece unicidade parcial e {JobId} garante unicidade global. Essa combinação assegura que todo o nome do arquivo seja exclusivo.

• Exemplo de nome não exclusivo:

  {MediaId}/test. {MediaId} oferece apenas unicidade parcial, enquanto test representa alguma informação comercial. Se você transcodificar um vídeo em dois arquivos MP4 com parâmetros diferentes, como resolução e taxa de bits, ambos terão o mesmo nome. Isso causa a sobrescrita dos arquivos, restando apenas um arquivo MP4.

Regras padrão

O VOD fornece um conjunto de regras padrão para gerar nomes de arquivos de saída:

• Saída não criptografada

  Formato:

  {MediaId}/[Random string]-{PlayDefinition}

  Exemplo:

  99f4f18c560c4f35459ef71tr/1b1196c767003c3dba0543055-40023f3f33e648df975f4dfc4c-sd

• Saída criptografada

  Formato:

  {MediaId}/[Random string]-{PlayDefinition}-encrypt-stream

  Exemplo:

  99f4f18c560c4f35459ef71tr/1b1196c767003c3dba0543055-40023f3f33e648df975f4dfc4c-sd-encrypt-stream

  Nota

  A palavra-chave encrypt-stream indica que o arquivo de saída é um resultado de transcodificação criptografada. Isso se aplica apenas à criptografia HLS (criptografia proprietária e criptografia padrão).

Regras personalizadas

Em alguns cenários comerciais, convém reduzir o tempo geral de resposta da reprodução. Para isso, construa diretamente o endereço de reprodução com base em determinadas regras. Por exemplo, se a regra for {MediaId}/{PlayDefinition}, monte o caminho do arquivo usando o MediaId e diferentes marcas de definição sem precisar chamar uma API de reprodução para obter a playlist. O VOD permite personalizar as regras de nomenclatura de arquivos transcodificados e gera os nomes com base nessas regras personalizadas.

Limites das regras

• Nomes de arquivos transcodificados personalizados podem conter apenas caracteres curinga específicos (strings variáveis), letras, dígitos, hifens (-) e sublinhados (_). O comprimento total de uma regra personalizada não pode exceder 128 caracteres.

• Inicie os nomes personalizados com o caractere curinga {MediaId}. Isso garante unicidade parcial e evita conflitos entre arquivos transcodificados de vídeos diferentes.

• Não inclua a extensão do arquivo no nome personalizado, pois o VOD a adiciona automaticamente. Por exemplo, se a regra de nomenclatura for {MediaId}/{JobId}-watermark-{PlayDefinition} e o formato de saída for mp4, o VOD acrescentará a extensão .mp4 ao gerar o nome do arquivo.

  Exemplo: 99f4f18c560c4f35459ef71tr/1b1196c767003c3dba0543055-watermark-sd.mp4

• Garanta que suas regras personalizadas gerem um nome exclusivo para cada arquivo transcodificado, evitando assim a sobrescrita de arquivos.

Métodos de configuração

A personalização de nomes de arquivos transcodificados é possível apenas via API. Para mais informações, consulte AddTranscodeTemplateGroup. Para detalhes sobre o parâmetro, veja TranscodeFileRegular em TranscodeTemplate.

Exemplo de configuração

public static JSONArray buildTranscodeTemplateList() {
        JSONObject transcodeTemplate = new JSONObject();
        // Customize the output file name for transcoding.
        transcodeTemplate.put("TranscodeFileRegular", "{MediaId}/{JobId}-watermark-{PlayDefinition}");
        // Template name.
        transcodeTemplate.put("TemplateName", "testtemplate");
        // Definition.
        transcodeTemplate.put("Definition", "LD");
        ......
        // Configure parameters such as video transcoding, audio transcoding, and output format.
        ......
        JSONArray transcodeTemplateList = new JSONArray();
        transcodeTemplateList.add(transcodeTemplate);
        return transcodeTemplateList;
    }

Para mais informações sobre como adicionar um grupo de modelos de transcodificação, consulte Transcoding templates.