Apsara Video SDK:Integrar uma licença

, iOS e HarmonyOS

Pré-requisitos

Você solicitou uma licença e obteve o arquivo de licença e a License Key. Para mais informações, consulte Gerencie uma licença.

Fluxo de autenticação

Conforme mostrado na figura anterior, a autenticação da licença do Apsara Video SDK depende da License Key e do arquivo de licença. Os requisitos de configuração são:

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

Ambientes de service do ApsaraVideo Player SDK

Para atender aos requisitos globais de conformidade, o ApsaraVideo Player SDK V6.14.0 e versões posteriores oferecem vários ambientes de service que mantêm os services localizados e em conformidade. O ambiente selecionado determina qual centro de service oferece suporte à autenticação de licença e aos dados de qualidade de reprodução do ApsaraVideo Player SDK. Selecione o ambiente de service que atende aos seus requisitos.

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 singapore). A versão V6.14.0 e posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) como 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.

   No painel de navegação à esquerda, escolha SDK Management > My Licenses. Na aba License Management, localize o campo License Key e copie seu valor.

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

      É possível 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 verificação falhar após configurar a licença, verifique se o nó <meta-data> está posicionado sob o elemento <application> e se o nome do nó <meta-data> está correto. Se o problema persistir, consulte FAQ about licenses para solução de problemas.

      • 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 service 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 service 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 suporta seleção de ambiente de service a partir da versão V6.14.0. As versões V6.14.0 e posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) como padrão. Para usar o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)), que atualmente é o único ambiente disponível para usuários do site internacional, utilize um dos métodos a seguir para alternar o ApsaraVideo Player SDK para o ambiente do site internacional. Caso contrário, a autenticação da licença falhará. Ignore esta etapa para outras versões e outros SDKs.

   1. Método 1: Chame a API a seguir 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"/>  

      O exemplo a seguir mostra uma configuração:

      <manifest xmlns:android="http://schemas.android.com/apk/res/android">
          <application
              ...>
              <!-- Other configurations -->
      
              <meta-data
                  android:name="com.aliyun.alivc_license.licensekey_SEA"
                  android:value="xxx" />
              <meta-data
                  android:name="com.aliyun.alivc_license.licensefile_SEA"
                  android:value="assets/SEALicense.crt" />
      
              <meta-data
                  android:name="com.aliyun.alivc_env"
                  android:value="SEA"/>
      
          </application>
      
      </manifest>

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.

      No arquivo Info.plist do seu projeto, adicione os dois itens de configuração a seguir:

      • AlivcLicenseFile (String): Defina como o nome do arquivo de certificado, por exemplo, license.crt.

      • AlivcLicenseKey (String): Defina como o valor da License Key obtido.

   2. Abra o arquivo Info.plist. Defina AlivcLicenseKey e AlivcLicenseFile (para o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China)) ou AlivcLicenseKey_SEA e AlivcLicenseFile_SEA (para o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China))) como 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 service 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 service 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 suporta seleção de ambiente de service a partir da versão V6.14.0. As versões V6.14.0 e posteriores usam o ambiente China continental, Hong Kong (China), Macau (China) e Taiwan (China) como padrão. Para usar o ambiente Global (exceto China continental, Hong Kong (China), Macau (China) e Taiwan (China)), que atualmente é o único ambiente disponível para usuários do site internacional, utilize um dos métodos a seguir para alternar o ApsaraVideo Player SDK para o ambiente do site internacional. Caso contrário, a autenticação da licença falhará. Ignore esta etapa para outras versões e outros SDKs.

   1. Método 1: Chame a API a seguir 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>

      Você também deve adicionar o arquivo de certificado SEALicense.crt ao diretório AppSupportFiles do seu projeto. No arquivo Info.plist, configure os seguintes pares chave-valor:

      • AlivcLicenseFile_SEA: Defina como SEALicense.crt

      • AlivcLicenseKey_SEA: Defina como sua License Key

Integrar uma licença no Flutter

O Flutter é uma solução multiplataforma desenvolvida pelo Google. Portanto, no Flutter você deve integrar as licenças de várias plataformas ou integrar a licença que corresponde ao seu cenário de negócios. Para mais informações, consulte Integrate a license on Android ou Integrate a license on iOS.