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
Acesse a página My Authorizations no console do ApsaraVideo VOD. Na aba , clique em .
-
Insira as informações do aplicativo. Os aplicativos são categorizados por plataforma: Web ou Mobile.
-
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.

Diretrizes para domínio web
-
Exemplo de domínio válido:
aliyun.com.ImportantePara abranger múltiplos subdomínios, como
pc.aliyun.comemobile.aliyun.com, insira apenas o domínio principalaliyun.com. -
Evite os seguintes formatos:
Incluir prefixo de protocolo:
http://aliyun.comouhttps://aliyun.com.Incluir caminho ou subpágina:
aliyun.com/indexoualiyun.com/login.Usar domínio curinga:
*.aliyun.comou.aliyun.com.
-
-
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
bundleNamedo arquivoapp.json5do seu projeto. Após inserir as informações, marque a caixa de seleção Compliance Commitment e clique em Create.
Vincular assinatura de aplicativo Android
NotaEste 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.keystorepara 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
Se já tiver adquirido uma licença, prossiga para a Etapa 3: Vincular uma licença.
Retorne à página My Authorizations, selecione a aba Order Instances e clique em Purchase License.
-
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.
ImportanteConforme ilustrado na figura, os direitos do SDK devem ser adquiridos separadamente. Por exemplo, é possível adquirir apenas a Standard Edition do player SDK.

Após o pagamento bem-sucedido, retorne à aba Order Instances para visualizar sua nova instância de pedido.
Etapa 3: Vincular uma licença
Retorne à página My Authorizations, selecione a aba License Management e clique em Bind License.
-
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.
NotaCada 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.
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
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.
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.
Acesse a página My Authorizations no console do ApsaraVideo VOD.
-
Selecione a aba License Management, localize e salve o ID da instância vinculado ao aplicativo alvo.
ImportanteSe 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.
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.

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.
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.

Renovação de licença
Método 1: Renovar pela página de Gerenciamento de Licenças
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.