Intelligent Media Services:Guide utilisateur iOS

Description du code source

├── iOS  // Root directory for the iOS platform
│   ├── AUIAICall.podspec                // Pod description file
│   ├── Source                                    // Source code files
│   ├── Resources                                 // Resource files
│   ├── Example                                   // Demo code
│   ├── AUIBaseKits                               // Basic UI components 
│   ├── README.md                                 // Readme  

Exécution de la démo

1. Téléchargez le code source et accédez au dossier Example.

2. Dans le dossier Example, exécutez la commande pod install --repo-update pour installer les dépendances du SDK.

3. Ouvrez le fichier de projet AUIAICallExample.xcworkspace et modifiez l'ID du package.

4. Ouvrez le fichier de configuration des scénarios d'agent /Resources/AUIAIMain.bundle/agent_scenes.json. Spécifiez l'ID de l'agent et la région selon le type d'agent. Par exemple, pour configurer un agent vocal, localisez le nœud Scenes où agent_type est VoiceAgent, puis renseignez les 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 where the voice call agent ID is located>",
             "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 valeurs des champs agent_id et region correspondants. Pour la valeur region, reportez-vous à la colonne Region ID du tableau suivant.

   Nom de la région	Region ID
   China (Hangzhou)	cn-hangzhou
   China (Shanghai)	cn-shanghai
   China (Beijing)	cn-beijing
   China (Shenzhen)	cn-shenzhen
   Singapore	ap-southeast-1

5. Une fois l'agent configuré, lancez-le selon l'une des méthodes suivantes :

   • Si AppServer est déployé : si vous avez déployé le code source AppServer fourni par Alibaba Cloud, ouvrez AUIAICallAppServer.swift et définissez le nom de domaine de votre serveur.

     // AUIAICallAppServer.swift
     public let AICallServerDomain = "Your application server domain name"

   • Si AppServer n'est pas déployé : pour exécuter rapidement la démo sans déployer AppServer, ouvrez AUIAICallAuthTokenHelper.swift. Configurez le paramètre EnableDevelopToken, récupérez l'App ID et l'App Key de l'application ARTC dans la console, puis générez le jeton d'authentification directement dans l'application.

     Remarque

     Cette méthode implique d'intégrer votre AppKey et d'autres informations sensibles dans votre application. Elle est réservée aux tests et au développement. N'utilisez jamais cette méthode en production, car l'exposition de votre AppKey côté client présente un risque de sécurité majeur.

     // AUIAICallAuthTokenHelper.swift
     @objcMembers public class AUIAICallAuthTokenHelper: NSObject {
     
         // Set to true to enable Develop mode
         private static let EnableDevelopToken: Bool = true     
         // Copy the RTCAppId from the console
         private static let RTCDevelopAppId: String = "RTC AppId used by the agent"
         // Copy the RTCAppKey from the console
         private static let RTCDevelopAppKey: String = "RTC AppKey used by the agent"
     
         ...
     }

     Pour obtenir l'AppID et l'AppKey de l'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.

6. Sélectionnez la cible Example, puis compilez et exécutez le projet.

Développement rapide de votre propre fonctionnalité d'appel IA

Intégrez AUIAICall à votre application pour activer les fonctionnalités d'appels audio et vidéo avec agent.

// Import components
import AUIAICall
import ARTCAICallKit
import AUIFoundation

// Check if microphone permission is enabled
AVDeviceAuth.checkMicAuth { auth in
   if auth == false {
       return
   }

   // For userId, use the user ID after your app logs on
   let userId = "xxx"
   // Build the controller using userId
   let controller = AUIAICallController(userId: userId)
   // Set the agent ID. It cannot be nil.
   controller.config.agentId = "xxx"
   // Set the call type (voice, digital human, or visual understanding). It must match the agent ID type.
   controller.config.agentType = agentType
   // The region where the agent is located. It cannot be nil.
   controller.config.region = "xx-xxx"
   // Create the call ViewController
   let vc = AUIAICallViewController(controller)
   // Open the call interface in full screen
   vc.modalPresentationStyle = .fullScreen
   vc.modalTransitionStyle = .coverVertical
   vc.modalPresentationCapturesStatusBarAppearance = true
   self.present(vc, animated: true)
  }