Intelligent Media Services:Guide utilisateur Android

Présentation du code source

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

Exécuter la démo

1. Après avoir téléchargé le code source, ouvrez le dossier Android dans Android Studio.

2. Ouvrez le fichier de projet build.gradle et mettez à jour l'ID du package.

3. Ouvrez le fichier de configuration des scènes d'agent /AUIAICall/src/main/assets/AgentConfig/agent_scenes.json. Saisissez-y l'ID de l'agent et la région correspondant à votre type d'agent. Par exemple, pour configurer un agent vocal, localisez le nœud Scenes où agent_type correspond à VoiceAgent, puis définissez les valeurs des champs agent_id et 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": []
           }
         ]
       }

   Remarque

   Pour tester un seul type d'agent, définissez uniquement les champs agent_id et region pour ce type. Pour le champ region, utilisez l'un des ID de région indiqués dans le tableau ci-dessous.

   Nom de la région	ID de région
   Chine (Hangzhou)	cn-hangzhou
   Chine (Shanghai)	cn-shanghai
   Chine (Pékin)	cn-beijing
   Chine (Shenzhen)	cn-shenzhen
   Singapour	ap-southeast-1

4. Une fois la configuration de l'agent terminée, lancez-le selon l'une des deux méthodes suivantes :

   • AppServer déjà déployé : si vous avez déployé le code source AppServer fourni par Alibaba Cloud sur votre serveur, ouvrez le fichier AppServiceConst.java et mettez à jour le nom de domaine du serveur.

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

   • AppServer non déployé : si vous n'avez pas déployé le code source AppServer mais souhaitez exécuter rapidement la démo pour tester l'agent, ouvrez le fichier AUIAICallAuthTokenHelper.java. Définissez le paramètre EnableDevelopToken sur true, puis copiez l'App ID et l'App Key ARTC depuis la console. Cette configuration génère un jeton d'authentification côté client à des fins de test.

     Important

     Cette méthode nécessite la saisie locale d'informations sensibles, telles que l'AppKey. Elle convient uniquement aux tests et au développement. Ne l'utilisez en aucun cas en production afin d'éviter les risques de sécurité liés à une fuite de l'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";
     }

     Procédez comme suit pour obtenir l'AppId et l'AppKey de votre application ARTC :

     1. Accédez à la console IMS et cliquez sur votre agent IA pour ouvrir sa page de détails.

        Dans l'onglet Basic Information, localisez la section Workflow Configuration et notez le RTC App ID indiqué sous ARTC application.

     2. Cliquez sur le RTC App ID pour ouvrir la console ApsaraVideo Live et récupérer l'App ID ainsi que l'AppKey.

        Sur la page Application Management, cliquez sur le nom de votre application, allez dans l'onglet Basic Information, puis copiez l'App ID et l'AppKey.

Développer rapidement votre propre fonctionnalité d'appel IA

Intégrez rapidement AUIAICall à votre application pour ajouter des appels audio et vidéo basés sur des agents.

/** 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);