Apsara Video SDK:Integrar uma licença

, iOS e HarmonyOS

Pré-requisitos

Um arquivo de licença e uma License Key obtidos em Gerencie uma licença.

Fluxo de autenticação

A autenticação da licença depende de uma License Key e de um arquivo de licença.

Para ignorar o arquivo de licença integrado, omita a configuração LicenseFile nas etapas específicas da plataforma abaixo.

Ambientes de serviço do ApsaraVideo Player SDK

O ApsaraVideo Player SDK V6.14.0 e versões posteriores suportam múltiplos ambientes de serviço para conformidade global. O ambiente determina qual centro de serviço processa a autenticação da licença e os dados de qualidade de reprodução.

Usuários do site internacional da Alibaba Cloud (www.alibabacloud.com) só podem usar o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)) (nó de Singapura). A versão V6.14.0 e posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) por padrão. Atualize a configuração para o ambiente do site internacional conforme descrito a seguir.

Integrar uma licença no cliente web

1. Obtenha a License Key no console.

2. Ao inicializar o player, passe o campo license, que inclui o nome de domínio registrado e a License Key:

   var player = new Aliplayer({
     license: {
       domain: "example.com", // The domain name you entered when you applied for the license
       key: "example-key" // The License Key you can view in the console after a successful application
     }
   });

3. Se nenhuma mensagem de erro aparecer após a inicialização, a licença foi configurada com sucesso.

   Nota

   O domínio da página deve corresponder ou ser um subdomínio do domínio registrado na sua solicitação de licença. Caso contrário, a verificação falhará.

Integrar uma licença no Android

1. Configure a licença.

   1. (Recomendado) Copie o arquivo de certificado para o diretório assets do seu projeto no Android Studio.

      Nota

      Você pode colocar o arquivo de certificado em outro local no dispositivo, mas garanta que com.aliyun.alivc_license.licensefile (para China continental, Hong Kong (China), Macau (China) e Taiwan (China)) ou com.aliyun.alivc_license.licensefile_SEA (para Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China))) corresponda ao caminho real do arquivo.

   2. No arquivo AndroidManifest.xml, adicione um nó <meta-data>.

      Importante

      • Se a autenticação falhar, verifique se os elementos <meta-data> estão sob <application> e se os nomes dos elementos estão corretos. Perguntas frequentes sobre licenças.

      • Para usuários do site internacional (www.alibabacloud.com) com ApsaraVideo Player SDK V6.14.0 ou posterior, configure uma licença para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)). Sem o ApsaraVideo Player SDK, configure apenas o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China).

      • É possível integrar dois conjuntos de licenças: um para Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)) e outro para China continental, Hong Kong (China), Macau (China) e Taiwan (China). Defina o ambiente de serviço do player sempre que o aplicativo for iniciado. Não é possível alternar ambientes durante a execução.

      

      // Configure the license for the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China) (default China site configuration)
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: Set your LicenseKey value. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Set the path of your license file. -->
      
      // Configure the license for the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment. Manually add _SEA to the end of the name.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: Set your LicenseKey value. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Set the path of your license file. -->

2. Configure o ambiente de serviço para o ApsaraVideo Player SDK (obrigatório para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China))).

   O ApsaraVideo Player SDK V6.14.0 e versões posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) por padrão. Usuários do site internacional devem alternar para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)) usando um dos métodos a seguir; caso contrário, a autenticação da licença falhará. Para outras versões e SDKs, pule esta etapa.

   1. Método 1: Chame a seguinte API para atualizar a configuração padrão para o ambiente do site internacional.

      // If you use the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment, ensure you call the following interface to update the default configuration to the international site environment before calling any player API. This ensures all subsequent services run in the international site environment.
      // Use the unified AlivcBase interface to set the international site environment. You cannot modify the environment at runtime.
      AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);

   2. Método 2 (Recomendado): Para o ApsaraVideo Player SDK V7.6.0 e versões posteriores, configure o ambiente do site internacional usando o método XML.

      No arquivo AndroidManifest.xml, adicione um nó <meta-data>.

      <meta-data
        android:name="com.aliyun.alivc_env"
        android:value="SEA"/>  

      A figura a seguir mostra um exemplo de configuração:

Integrar uma licença no iOS

1. Configure a licença.

   1. Copie o arquivo de certificado AliVideoCert-********.crt para o seu projeto Xcode. Coloque-o no diretório AppSupportFiles (recomendado), no sandbox ou em outro caminho. Em Target Membership, selecione o projeto atual.

      

   2. Abra o arquivo Info.plist. Defina AlivcLicenseKey e AlivcLicenseFile (para o ambiente China) ou AlivcLicenseKey_SEA e AlivcLicenseFile_SEA (para o ambiente Internacional) com a License Key e o caminho do arquivo de licença obtidos em Gerencie uma licença.

      Importante

      • Para usuários do site internacional (www.alibabacloud.com) com ApsaraVideo Player SDK V6.14.0 ou posterior, configure uma licença para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)). Sem o ApsaraVideo Player SDK, configure apenas o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China).

      • É possível integrar dois conjuntos de licenças: um para Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)) e outro para China continental, Hong Kong (China), Macau (China) e Taiwan (China). Defina o ambiente de serviço do player sempre que o aplicativo for iniciado. Não é possível alternar ambientes durante a execução.

      // Configure the license for the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China) (default configuration)
      <key>AlivcLicenseFile</key>
      <string>XXX</string>
      <key>AlivcLicenseKey</key>
      <string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>
      
      // Configure the license for the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment. Manually add _SEA to the end of the key name.
      <key>AlivcLicenseFile_SEA</key>
      <string>XXX</string>
      <key>AlivcLicenseKey_SEA</key>
      <string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>

2. Configure o ambiente de serviço para o ApsaraVideo Player SDK (obrigatório para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China))).

   O ApsaraVideo Player SDK V6.14.0 e versões posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) por padrão. Usuários do site internacional devem alternar para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)) usando um dos métodos a seguir; caso contrário, a autenticação da licença falhará. Para outras versões e SDKs, pule esta etapa.

   1. Método 1: Chame a seguinte API para atualizar a configuração padrão para o ambiente do site internacional.

      // If you use the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment, ensure you call the following interface to update the default configuration to the international site environment before calling any player API. This ensures all subsequent services run in the international site environment.
      // Use the unified AlivcBase interface to set the international site environment. You cannot modify the environment at runtime.
      AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

   2. Método 2 (Recomendado): Para o ApsaraVideo Player SDK V7.6.0 e versões posteriores, configure o ambiente do site internacional usando o método Info.Plist.

      Abra o arquivo Info.plist e defina AlivcEnv como SEA.

      // Configure the current environment as the international site environment.
      <key>AlivcEnv</key>
      <string>SEA</string>

      A figura a seguir mostra um exemplo de configuração:

Integrar uma licença no Flutter

Para aplicativos Flutter, integre a licença em cada plataforma suportada: Integrar uma licença no Android ou Integrar uma licença no iOS.