Intelligent Media Services:Guia do usuário para Android

Visão geral do código-fonte

├── Android       		// Root directory of the Android project
│   ├── AUIBaseKits     // AUI base components
│   ├── AUIAICall       // UI components
│   ├── README.md
│   ├── app             // Demo entry point
│   ├── build.gradle  
│   └── settings.gradle

Execute a demonstração

1. Após baixar o código-fonte, abra a pasta Android no Android Studio.

2. Abra o arquivo de projeto build.gradle e atualize o ID do pacote.

3. Abra o arquivo de configuração de cena do agente /AUIAICall/src/main/assets/AgentConfig/agent_scenes.json. Nesse arquivo, insira o ID do agente e a região conforme o tipo de agente. Por exemplo, para configurar um agente de voz, localize o nó Scenes onde agent_type é VoiceAgent e defina os valores dos campos agent_id e region.

   // The following example shows how to configure a voice call agent
       {
         "agent_type": "VoiceAgent",
         "scenes": [
           {
             "agent_id": "<Voice call agent ID>",
             "region": "<Region of the voice call agent ID>",
             "title": "Voice Call",
             "tags": [],
             "limit_seconds": 1800,
             "description": "",
             "asr_model_id": "xxx",
             "tts_model_id": "xxx",
             "voice_styles": []
           }
         ]
       }

   Nota

   Caso queira testar apenas um tipo de agente, basta definir os campos agent_id e region para esse tipo específico. No campo region, utilize um dos valores de Region ID listados na tabela abaixo.

   Nome da região	Region ID
   China (Hangzhou)	cn-hangzhou
   China (Shanghai)	cn-shanghai
   China (Beijing)	cn-beijing
   China (Shenzhen)	cn-shenzhen
   Singapura	ap-southeast-1

4. Após concluir a configuração do agente, inicie-o de uma das duas formas a seguir:

   • AppServer já implantado: Se você já implantou o código-fonte do AppServer fornecido pela Alibaba Cloud em seu servidor, abra o arquivo AppServiceConst.java e atualize o nome de domínio do servidor.

     // AppServiceConst.java
     String HOST = "your application server domain name";

   • AppServer não implantado: Se você ainda não implantou o código-fonte do AppServer, mas deseja executar rapidamente a demonstração para testar o agente, abra o arquivo AUIAICallAuthTokenHelper.java. Defina o parâmetro EnableDevelopToken como true e copie o App ID e a App Key do ARTC no console. Essa configuração gera um token de autenticação no lado do cliente para fins de teste.

     Importante

     Este método exige a inserção local de informações sensíveis, como a AppKey. Ele é adequado apenas para testes e desenvolvimento. Não deve ser usado em produção, a fim de evitar riscos de segurança decorrentes do vazamento da AppKey.

     // AUIAICallAuthTokenHelper.java
     public class AUIAICallAuthTokenHelper {
         // Set to true to enable Develop mode
         private static final boolean EnableDevelopToken = true;
     
         // Copy the RTC AppId for audio and video calls from the console
         private static final String AICallRTCDevelopAppId = "RTC AppId used by the agent";
         // Copy the RTC AppKey for audio and video calls from the console
         private static final String AICallRTCDevelopAppKey = "RTC AppKey used by the agent";
     }

     Siga estas etapas para obter o AppId e a AppKey do seu aplicativo ARTC:

     1. Acesse o console do IMS e clique em seu agente de IA para abrir a página de detalhes.

        Na aba Basic Information, localize a seção Workflow Configuration e anote o RTC App ID listado em ARTC application.

     2. Clique no RTC App ID para abrir o console do ApsaraVideo Live e obter o App ID e a AppKey.

        Na página Application Management, clique em seu aplicativo, acesse a aba Basic Information e copie o App ID e a AppKey.

Desenvolva rapidamente seu próprio recurso de chamada com IA

Integre rapidamente o AUIAICall ao seu aplicativo para adicionar chamadas de áudio e vídeo baseadas em agentes.

/** Ensure microphone and camera permissions are granted before starting */
Context currentActivity = AUIAICallEntranceActivity.this;
Intent intent = new Intent(currentActivity, AUIAICallInCallActivity.class);

// Set the call type (voice, digital human, or visual understanding). This must match the agent ID type.
ARTCAICallEngine.ARTCAICallAgentType aiCallAgentType = 
    ARTCAICallEngine.ARTCAICallAgentType.VoiceAgent;
// Agent ID. Must not be empty.
String aiAgentId = "";
// Region where the agent is located. Must not be empty.
String aiAgentRegion = "";
// User ID for joining the RTC session. We recommend using your business login user ID.
String userId = "123";
// Call authentication token. See: https://www.alibabacloud.com/help/zh/ims/user-guide/generate-artc-authentication-token?spm=a2c4g.11186623.0.0.1ce65bc4BKdQy7
String token = "";

intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_LOGIN_USER_ID, userId);
// Agent type
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_TYPE, aiCallAgentType);
// Agent ID
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_ID, aiAgentId);
// Agent region
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_REGION, aiAgentRegion);
// Set the call authentication token
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_RTC_AUTH_TOKEN, token);

currentActivity.startActivity(intent);