Intelligent Media Services:iOS User Guide

Descrição do código-fonte

├── 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  

Executar a demonstração

1. Baixe o código-fonte e acesse a pasta Example.

2. Na pasta Example, execute o comando pod install --repo-update para instalar as dependências do SDK.

3. Abra o arquivo de projeto AUIAICallExample.xcworkspace e modifique o ID do pacote.

4. Abra o arquivo de configuração de cenário do agente /Resources/AUIAIMain.bundle/agent_scenes.json. Especifique 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 preencha os 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 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": []
           }
         ]
       }

   Nota

   Para testar apenas um tipo de agente, basta definir os valores dos campos agent_id e region correspondentes. Para o valor de region, consulte a coluna Region ID na tabela a seguir.

   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

5. Após configurar o agente, inicie-o usando um dos métodos abaixo:

   • Com AppServer implantado: Se você já implantou o código-fonte do AppServer fornecido pela Alibaba Cloud, acesse AUIAICallAppServer.swift e defina o nome de domínio do seu servidor.

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

   • Sem AppServer implantado: Para executar rapidamente a demonstração sem implantar o AppServer, acesse AUIAICallAuthTokenHelper.swift. Configure o parâmetro EnableDevelopToken, obtenha o App ID e a App Key do aplicativo ARTC no console e gere o token de autenticação diretamente no aplicativo.

     Nota

     Este método exige a incorporação da sua AppKey e de outras informações sensíveis no aplicativo. Ele se destina exclusivamente a testes e desenvolvimento. Nunca utilize este método em ambiente de produção. Expor sua AppKey no lado do cliente gera um grave risco de segurança.

     // 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"
     
         ...
     }

     Para obter o AppID e a AppKey do aplicativo ARTC:

     1. Acesse o console 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.

6. Selecione o target Example e, em seguida, compile e execute o projeto.

Desenvolver rapidamente seu próprio recurso de chamada de IA

Integre o AUIAICall ao seu aplicativo para habilitar recursos de chamada de áudio e vídeo com agentes.

// 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)
  }