Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Obter uma licença do SDK de vídeo curto

Última atualização: Jun 27, 2026

O SDK de vídeo curto utiliza licenças para autorização. Este tópico descreve como obter e usar uma licença desse SDK.

Atualização do serviço de licença

O serviço de licença unificado foi adicionado ao SDK de vídeo curto V3.29.0 e versões posteriores. Esse serviço fornece autorização de acesso para todos os aplicativos que utilizam Push SDK, ApsaraVideo Player SDK, SDK de vídeo curto e Queen SDK. Cada licença está vinculada a um aplicativo específico, permitindo vincular uma única licença a apenas um aplicativo Android e um aplicativo iOS. Devido à atualização do serviço de licença, o método de integração do SDK de vídeo curto mudou. A tabela a seguir compara os métodos de integração antes e depois dessa atualização.

Versão do SDK

Método de integração

V3.29.0 e posteriores

Se você é um novo usuário e deseja utilizar o SDK de vídeo curto V3.29.0 ou superior, integre a versão mais recente seguindo as instruções da documentação.

Versões anteriores à V3.29.0

Caso já tenha integrado uma versão do SDK de vídeo curto anterior à V3.29.0, continue usando o SDK dentro do período de validade da sua licença. Para atualizar para a V3.29.0 ou posterior, chame o método específico de registro do SDK utilizando a chave de licença e o arquivo de licença obtidos durante a integração.

Autorização de licença

Etapa 1: Criar um aplicativo

  1. Acesse a página My Authorizations no console do ApsaraVideo VOD. Na aba , clique em .

  2. Insira as informações do aplicativo. Os aplicativos são categorizados por plataforma: Web ou Mobile.

    1. Web: Insira um e o Web Domain correspondente. Selecione I understand and agree to the compliance commitments (clique em View Statement para detalhes) e, em seguida, clique em Create.

      截屏2026-01-13 16

      Diretrizes para domínio web

      • Exemplo de domínio válido: aliyun.com.

        Importante

        Para abranger múltiplos subdomínios, como pc.aliyun.com e mobile.aliyun.com, insira apenas o domínio principal aliyun.com.

      • Evite os seguintes formatos:

        • Incluir prefixo de protocolo: http://aliyun.com ou https://aliyun.com.

        • Incluir caminho ou subpágina: aliyun.com/index ou aliyun.com/login.

        • Usar domínio curinga: *.aliyun.com ou .aliyun.com.

    2. Mobile: Selecione uma plataforma, insira um e forneça o Android package name, o Bundle ID do iOS e o HarmonyOS Bundle ID correspondentes para criar o aplicativo.

      O HarmonyOS Bundle ID encontra-se no campo bundleName do arquivo app.json5 do seu projeto. Após inserir as informações, marque a caixa de seleção Compliance Commitment e clique em Create.

      截屏2026-01-13 16

      Vincular assinatura de aplicativo Android

      Nota
      • Este campo é obrigatório se você selecionar Android como Platform Type e marcar Bind Signature.

      • Vincular uma assinatura aumenta a segurança, impedindo que outros aplicativos com o mesmo nome de pacote utilizem a licença.

      • Versões mais recentes do SDK não exigem assinatura vinculada, incluindo ApsaraVideo MediaBox v1.7.0+, player SDK v5.5.2+, live streaming SDK v4.4.9+ e short video SDK v3.36.0+.

      Obtenha o valor MD5 da assinatura do seu aplicativo Android de duas formas:

      • Execute o comando keytool -v -list -keystore your.keystore para visualizar o valor MD5 da assinatura correspondente.

      • No Android Studio: Clique em Gradle na barra lateral direita e navegue até Tasks > android > signingReport do aplicativo. Converta todas as letras do valor MD5 resultante para minúsculas e remova os dois pontos.

        publishNonDefault is deprecated and has no effect anymore. All variants are now published.
        AGPBI: {"kind":"warning","text":"        Using flatDirs should be avoided because it doesn't support any meta-data formats.\n                Currently detected u..."}
        AGPBI: {"kind":"warning","text":"Please remove usages of `jcenter()` Maven repository from your build scripts and migrate your build to other Maven repositories.\nThis repository is deprecated..."}
        > Task :lista...
            Variant: debug
            Config: debug
            Store: /Us...
            Alias: and
            MD5: 5A:1E...
            SHA1: 7C:D...
            SHA-256: 5...
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: release
            Config: none
            ----------
            Variant: xxx
            Config: dxxx
            Store: /Uxxx
            Alias: androiddebugkey
            MD5: 5A:1E:F4xxx
            SHA1: 7C:D8:Exxx
            SHA-256: 55:xxx
            Valid until: Tuesday, March 1, 2044
            ----------
            Variant: debugUnitTest

Etapa 2: Adquirir uma licença

Nota

Se já tiver adquirido uma licença, prossiga para a Etapa 3: Vincular uma licença.

  1. Retorne à página My Authorizations, selecione a aba Order Instances e clique em Purchase License.

  2. Na página de compra do ApsaraVideo MediaBox, selecione o SDK e os módulos de função conforme suas necessidades de negócio (direitos de SDK não podem ser combinados em uma única compra) e conclua a aquisição.

    Importante

    Conforme ilustrado na figura, os direitos do SDK devem ser adquiridos separadamente. Por exemplo, é possível adquirir apenas a Standard Edition do player SDK.image

  3. Após o pagamento bem-sucedido, retorne à aba Order Instances para visualizar sua nova instância de pedido.

Etapa 3: Vincular uma licença

  1. Retorne à página My Authorizations, selecione a aba License Management e clique em Bind License.

  2. Na página Bind License, selecione o aplicativo e o pedido de licença do SDK a serem vinculados. Após confirmar as informações, clique em Bind.

    Nota

    Cada pedido de licença pode ser vinculado a um único aplicativo , abrangendo plataformas Web ou Mobile.

    Na seção Authorized Platforms, selecione as plataformas que deseja autorizar, como Android. Uma licença mobile é válida apenas para aplicativos móveis.

  3. Após a vinculação bem-sucedida, retorne à aba License Management para visualizar o nome do aplicativo vinculado e suas informações de autorização.

Etapa 4: Obter informações de autorização

  1. Na aba License Management, localize o aplicativo alvo. Sua license key aparece no topo da página. Clique no botão de cópia para copiar a chave. Um link Download Certificate está disponível sob cada nome de aplicativo na lista.

  2. Após confirmar os detalhes da autorização, clique em Download Certificate para salvar o arquivo de licença localmente. Salve também a chave de licença para uso durante a integração do aplicativo. Para instruções sobre configuração do arquivo de licença, consulte Integrar uma licença.

Renovar uma licença

Expiração da licença

A licença do SDK de vídeo curto possui um período de validade específico. As condições que determinam a expiração variam conforme a versão do SDK. Os itens a seguir comparam essas condições:

  • Para SDK de vídeo curto anterior à V3.29.0:

    • O seguinte valor é retornado: ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001).

    • Uma das seguintes mensagens aparece no log:

      • Sem rede disponível há 30 dias. A licença foi desativada. Renove a licença ou contate a equipe de vendas para autorização.

      • A licença está desativada. Renove a licença ou contate a equipe de vendas para autorização.

      • Licença inválida pois o nome do pacote, bundle ID e assinatura não estão registrados no site oficial do SDK de vídeo curto. Seu período de teste gratuito de sete dias encerrou.

  • Para SDK de vídeo curto V3.29.0 e posteriores:

    • O seguinte valor é retornado: ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001).

    • Uma das seguintes mensagens aparece no log:

      • A licença expirou. Renove a licença ou contate a equipe de vendas para autorização.

      • Licença não inicializada. Para mais informações, consulte Inicializar o SDK de vídeo curto para Android ou Inicializar o SDK de vídeo curto para iOS.

      • Licença inválida pois o nome do pacote, bundle ID e assinatura não estão registrados no site oficial do SDK de vídeo curto. Contate a equipe de vendas para autorização.

      • Ao utilizar serviços de valor agregado, a seguinte informação é exibida: XXX expirou. Renove a licença ou contate a equipe de vendas para autorização. XXX indica o serviço de valor agregado em uso.

      • Ao utilizar serviços de valor agregado, a seguinte informação é exibida: XXX é inválido. Obtenha a licença antes de usar o serviço de valor agregado. XXX indica o serviço de valor agregado em uso.

  • Renovação de licença

    Método 1: Renovar pela página de Gerenciamento de Licenças

    1. Acesse a página My Authorizations no console do ApsaraVideo VOD.

    2. Selecione a aba License Management, localize e salve o ID da instância vinculado ao aplicativo alvo.

      Importante
      1. Se o ID da instância estiver vazio ou ocorrer um erro no console durante a renovação, utilize o Método 2: Adquirir nova licença e vincular o aplicativo ou envie um ticket da Alibaba Cloud para renovação.

      2. A renovação aplica-se a todo o pedido de licença. Se o pedido incluir múltiplos direitos de SDK, todos serão renovados conjuntamente. Não é possível alterar a configuração durante a renovação. Em caso de dúvidas, envie um ticket da Alibaba Cloud.

      image

    3. Acesse a página Renewals no console Billing Management. Pesquise pelo ID da instância salvo, localize o pedido e clique em Renew na coluna Actions.

    4. Na página de renovação do ApsaraVideo MediaBox, confirme sua configuração atual e a duração da renovação, depois clique em Buy Now para concluir. Recomendamos ativar a auto-renewal para evitar expiração.image

    Método 2: Adquirir nova licença e vincular o aplicativo

    Se o ID da instância estiver vazio para sua licença de SDK adquirida ou se ocorrer um erro durante a renovação, adquira uma nova licença na página de compra do ApsaraVideo MediaBox antes que a licença atual expire. Após a compra, siga as instruções na Etapa 3: Vincular uma licença para prevenir interrupções de serviço.