Apsara Video SDK:Perguntas frequentes sobre licenças

Vencimento e renovação de licença

Visualizar a data de vencimento 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 na guia License Management, encontre o pedido de licença vinculado ao seu aplicativo e verifique a data de vencimento na coluna Expiration Date. Para renovar a licença, clique em Renew na coluna Actions.

Renove uma licença

Para mais informações sobre como renovar uma licença, consulte {{XREF_2}}.

Solucionar erros de licença

Se você encontrar falhas de integração ou outros erros de licença, siga estas etapas para solucionar o problema:

• Verifique se a autorização da licença está configurada corretamente 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 na guia Application Management, encontre o aplicativo de destino e clique em Details. A página exibe informações básicas sobre o aplicativo e sua licença vinculada.

  4. Verifique se as seguintes informações estão corretas:

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

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

• Verifique se a configuração da licença no seu projeto está correta e corresponde às informações da licença no console.

  • Web: Verifique a configuração do campo license usada durante a inicialização do player.

    • domain: Certifique-se de que o domínio da página do seu player corresponda ou seja um subdomínio do domínio especificado ao solicitar a licença.

    • key: Certifique-se de que o valor do License Key corresponda ao valor exibido no console.

  • Android: Verifique a configuração do AndroidManifest.xml.

    • License key: Certifique-se de que o valor de com.aliyun.alivc_license.licensekey corresponda à chave exibida no console.

    • license file: Certifique-se de que o valor de com.aliyun.alivc_license.licensefile corresponda ao caminho de armazenamento do seu arquivo de licença.

    • Package ID: Certifique-se de que o applicationId no build.gradle corresponda ao Package Name no console.

    • package signature: Se você vinculou uma assinatura ao criar a licença no console, certifique-se de que a assinatura configurada no seu projeto corresponda à do console. Execute o seguinte comando para consultar a assinatura do seu pacote: keytool -v -list -keystore your.keystore.

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

    • BundleId: Certifique-se de que o valor de CFBundleIdentifier corresponda ao Bundle ID configurado no console.

    • License key: Certifique-se de que o valor de AlivcLicenseKey corresponda à chave exibida no console.

    • license file: Certifique-se de que o valor de AlivcLicenseFile corresponda ao caminho do arquivo de licença dentro do seu pacote ipa.

  • HarmonyOS: Verifique a configuração do module.json5.

    • BundleId: Certifique-se de que o bundleName no app.json5 corresponda ao BundleID do HarmonyOS configurado no console.

    • License key: Certifique-se de que o valor de com.aliyun.alivc_license.licensekey corresponda à chave exibida no console.

    • license file: Certifique-se de que o valor de com.aliyun.alivc_license.licensefile corresponda ao caminho do arquivo de licença dentro do seu pacote hap.

• Verifique se a configuração do ambiente de service no projeto de acesso está correta (aplicável ao acesso de licença do player para Android, iOS e Flutter).

  O ApsaraVideo Player SDK oferece suporte à seleção de ambiente de service a partir da V6.14.0. A V6.14.0 e versões posteriores usam como padrão o ambiente da China continental, Hong Kong (China), Macau (China) e Taiwan (China). Para usar o ambiente Global (excluindo a China continental, Hong Kong (China), Macau (China) e Taiwan (China)), é necessário atualizar a configuração do SDK do player para o ambiente do site internacional. Para mais detalhes, consulte {{XREF_4}}.

Atualizar o arquivo e a chave da licença

• Arquivo de licença: Recomendamos atualizar o arquivo de licença. Após a renovação, a data de vencimento no arquivo de licença é atualizada. O uso do arquivo atualizado melhora a taxa de sucesso da autenticação. Para aplicativos publicados, o uso de um arquivo de licença histórico normalmente não afeta a funcionalidade.

• Chave da licença: Esta chave permanece inalterada, pois está exclusivamente vinculada ao seu UID.

Modificar o ID do aplicativo

Se as informações do seu aplicativo mudarem, você poderá modificá-las no console.

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 na guia Application Management, encontre o aplicativo de destino e clique em Create.

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

5. Após confirmar as alterações, clique em Details para concluir a modificação.

Modificar a assinatura MD5 do Android

Modificar a assinatura MD5 pode causar problemas em produção, portanto, prossiga com cautela. Os aplicativos que usam o ApsaraVideo MediaBox SDK exigem um arquivo e uma chave de licença para configuração. Se você alterar as configurações de autorização, como a assinatura MD5, o SDK em uma versão lançada do aplicativo poderá falhar na autenticação, tornando os recursos indisponíveis. Os cenários comuns incluem:

• Se você alterar a assinatura MD5 de um aplicativo Android de A para B, a versão do aplicativo configurada com a assinatura A falhará. Nesse caso, recomendamos criar um novo aplicativo que use o mesmo nome de pacote, mas que seja configurado com a assinatura B para as novas versões do aplicativo.

• Se você desvincular a assinatura, as versões mais antigas do SDK falharão na autenticação. Não recomendamos desvincular a assinatura se o seu aplicativo já tiver usado as seguintes versões do SDK:

  • ApsaraVideo MediaBox SDK: v1.6.0 e anteriores

  • Player SDK: v5.5.1.0 e anteriores

  • Live Streaming SDK: v4.4.8 e anteriores

  • Short Video SDK: v3.35.0 e anteriores

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

Para adicionar módulos do SDK ou modificar a edição ou os recursos de um módulo existente, envie um ticket.