Todos os produtos
Search

Este produto

    Apsara Video SDK:Perguntas frequentes sobre licenças

    Central de documentação

    Apsara Video SDK:Perguntas frequentes sobre licenças

    Última atualização: Jul 05, 2026

    Perguntas frequentes sobre solicitação, renovação, uso e alteração de configurações de licença.

    Erro de licença no player web

    Problema: Ocorre um erro de licença ao usar o Player SDK for Web.

    Solução: O Player SDK for Web v2.28.0 e versões posteriores exigem licença. As novas licenças são incompatíveis com versões anteriores. Atualize para a versão v2.29.1 ou superior. Se você ainda não adquiriu uma licença, acesse a página de compra do ApsaraVideo MediaBox SDK para comprar uma nova licença. Após a compra, vincule-a ao seu aplicativo.

    Erro de licença no player móvel

    Problema: Ao usar o Player SDK para clientes móveis v7.0.0 ou posterior, surge uma mensagem como "License verify premium func:abr".

    image

    Solução: O Player SDK v7.0.0 e versões posteriores oferecem diferentes edições. Recursos avançados, como políticas ABR, exigem uma licença da Professional Edition. Para mais informações, consulte Obter uma licença do ApsaraVideo Player SDK.

    Expiração e renovação de licença

    Verificar a data de expiração da licença

    1. Faça login no console do ApsaraVideo VOD ou no console do ApsaraVideo Live.

    2. No painel de navegação à esquerda, escolha SDK Management > My Licenses.

    3. Clique em na aba License Management, localize o pedido de licença vinculado ao seu aplicativo e visualize a data de validade na coluna Expiration Date.image

    Renovar a licença

    Renovar uma licença.

    Importante

    1. Se a data de expiração informada por SMS diferir da exibida no console, prevalece a data do console (o período de validade pode ter sido estendido manualmente). Ignore o aviso de expiração na página Renewal do Billing and Cost Management. Desative a renovação automática.

    2. Se o seu pedido de licença agrupar vários recursos do SDK, renove todo o pedido. Existem dois métodos disponíveis:

      1. Se o pedido de licença possuir um id de instância, clique em Renew na coluna Actions.image

      2. Se o pedido de licença não possuir um id de instância, o botão Renew não estará disponível. Nesse caso, adquira uma nova licença na página de compra do ApsaraVideo MediaBox SDK e vincule-a ao seu aplicativo.

    Solucionar erros de licença

    Se ocorrer um erro de licença durante a integração, siga estas etapas:

    • Verifique a configuração da licença no console do ApsaraVideo VOD ou ApsaraVideo Live.

      1. Faça login no console do ApsaraVideo VOD ou no console do ApsaraVideo Live.

      2. No painel de navegação à esquerda, escolha SDK Management > My Licenses.

      3. Clique em na aba Application Management, localize o aplicativo desejado e clique em Details. Os detalhes do aplicativo e as informações da licença vinculada serão exibidos.

      4. Valide os seguintes itens:

        • Informações básicas: Confira o identificador do aplicativo (como o nome do pacote) e a assinatura do pacote. Recomendamos não vincular uma assinatura de pacote.

        • Informações da licença: Verifique a versão do SDK, o tipo de autorização, a data de expiração, o status da licença e os serviços de valor agregado adquiridos.

        image

    • Confirme se a configuração da licença no seu projeto corresponde à do console.

      • Para aplicativos web, verifique a configuração do campo license durante a inicialização do player.

        • domain: Domínio onde o player está hospedado. Deve corresponder exatamente ao domínio especificado durante a solicitação da licença ou ser um subdomínio dele.

        • key: Deve ser idêntica à chave de licença exibida no console.

      • Android: Revise as configurações no arquivo AndroidManifest.xml.

        • LicenseKey: Garanta que o valor de com.aliyun.alivc_license.licensekey seja igual à chave mostrada no console.

        • Arquivo de licença: Assegure-se de que o valor de com.aliyun.alivc_license.licensefile aponte corretamente para o caminho onde o arquivo de licença está armazenado.

        • id do Pacote: O applicationId definido no build.gradle deve coincidir com o Package Name registrado no console.

        • Assinatura do pacote: Se você vinculou uma assinatura ao criar a licença no console, confirme se a assinatura configurada no projeto é a mesma. Execute o comando a seguir para consultar a assinatura do seu pacote: keytool -v -list -keystore your.keystore.

      • iOS: Analise a configuração do Info.plist.

        • Bundle id: Valide se o valor de CFBundleIdentifier corresponde ao Bundle ID configurado no console.

        • License Key: Confirme se o valor de AlivcLicenseKey é igual ao exibido no console.

        • Arquivo de licença: Verifique se o valor de AlivcLicenseFile aponta para o caminho correto do arquivo de licença dentro do pacote ipa.

      • HarmonyOS: A principal configuração a ser verificada encontra-se no arquivo module.json5.

        • BundleId: O bundleName no app.json5 precisa corresponder ao BundleID do HarmonyOS configurado no console.

        • LicenseKey: O valor de com.aliyun.alivc_license.licensekey deve ser idêntico à chave de licença apresentada no console.

        • Arquivo de licença: O valor de com.aliyun.alivc_license.licensefile deve corresponder ao caminho do arquivo de licença dentro do pacote hap.

    Atualizações de arquivo e chave de licença

    • license file: Atualize o arquivo de licença após a renovação. O novo arquivo contém a data de expiração atualizada e melhora a taxa de sucesso da autenticação. Um arquivo de licença antigo em um aplicativo já publicado geralmente continua funcionando.

    • license key: A chave de licença permanece inalterada. Cada chave de licença é mapeada exclusivamente para um id de usuário (UID).

    Modificar um id de aplicativo

    Se as informações do seu aplicativo mudarem, modifique-as no console.

    Importante

    Alterar identificadores de aplicativo (como Package Name) causa falha na autenticação de aplicativos que utilizam os identificadores antigos. Baixe novamente e substitua o arquivo de licença. Proceda com cautela.

    1. Faça login no console do ApsaraVideo VOD.

    2. No painel de navegação à esquerda, escolha .

    3. Clique em na aba Application Management. Localize o aplicativo desejado e clique em Edit.

    4. Modifique o nome do aplicativo, a plataforma, o hash MD5 da assinatura do aplicativo Android e identificadores como o nome do pacote.

    5. Clique em Modify para salvar as alterações.

    Modificar a assinatura do pacote Android

    Modifique a assinatura do pacote com cautela. Alterar configurações de autorização, como a assinatura do pacote, pode causar falhas na autenticação do SDK para versões de aplicativos já publicadas. Cenários comuns:

    • Ao alterar a assinatura do pacote de A para B, as versões do aplicativo que usam a assinatura A param de funcionar. Crie um novo aplicativo com o mesmo nome de pacote, mas com a assinatura B, para as novas versões.

    • Desvincular a assinatura do pacote pode gerar falhas de autenticação em versões mais antigas do SDK. Não desvincule se o seu aplicativo utilizar alguma destas versões:

      • ApsaraVideo MediaBox SDK: v1.6.0 e anteriores

      • Player SDK: v5.5.1.0 e anteriores

      • Push SDK: v4.4.8 e anteriores

      • Short Video SDK: v3.35.0 e anteriores

    Modificar módulos, edições ou recursos autorizados

    O console não permite modificar diretamente as configurações de licença. Para adicionar módulos do SDK ou alterar a edição e os recursos de um módulo existente, envie um ticket.