文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>实时音视频>AI 实时对话>快速集成（含 UI）>快速集成（iOS）

快速集成（iOS）

最近更新时间：2025-09-17 11:02:52

我的收藏

本页目录：

本文将指导您如何在较短时间内接入 AIConversationKit组件。遵循本指南，您将在20分钟内完成以下关键步骤，并实现具备完整 UI 界面的 AI 对话功能。
AI 对话界面


环境准备

最低兼容 iOS 13，建议使用 iOS13 及以上版本。
Xcode 13 及以上版本。

步骤1：开通服务

在使用 AIConversationKit 发起对话前，您需要前往控制台开通 AIConversationKit 专属的 AI 对话服务，具体步骤请参见 开通服务。

步骤2：导入 AIConversationKit 组件：

1. 前往 GitHub 下载 zip 文件，解压后，您会看到 AIConversationKit 目录、AIConversationKit.podspec 文件和 Resource 目录。

2. 复制上一步中解压得到的目录里的 AIConversationKit、podspec 和 Resource 到您的工程中。

3. 然后在 .xcodeproj 打开控制台，执行 pod init。
4. 在生成的 Podfile 里这样写：
   pod 'AIConversationKit',:path => 'AIConversationKit.podspec'

5. 执行 pod install。

6. 打开 .xcworkspace:

7. 配置证书信息：


步骤3：工程配置

使用 AI 对话，需要授权麦克风使用权限。在 App 的 Info.plist 中添加以下麦克风声明，对应麦克风系统弹出授权对话框时的提示信息。
<key>NSMicrophoneUsageDescription</key>
<string>此应用需要使用麦克风进行 AI 语音对话</string>


步骤4：登录

在您的项目中添加如下代码，它的作用是通过调用 TUILogin 中的相关接口完成组件的登录。这个步骤异常关键，因为只有在登录后才能正常使用 AIConversationKit 的各项功能，故请您耐心检查相关参数是否配置正确。
swift
import TUICore
import AIConversationKit

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let sdkAppId = 1600000001  // 请替换为步骤一取到的 sdkAppId
        let userId = "people"      // 请替换为您的 UserID
        let sdkSecretKey = "xxx"      // 请替换为步骤一取到的 sdkSecretKey
        let userSig = GenerateTestUserSig.genTestUserSig(sdkAppId: sdkAppId, userId: userId, secrectkey: sdkSecretKey)
        TUILogin.login(Int32(sdkAppId), userID: userId, userSig:userSig){
            print("login success")
        } fail: { code, message in
            print("login failed, code: \\(code), error: \\(message ?? "nil")")
        }
    return true
}


TUILogin.login 函数参数说明：
SDKAppID：在 开通服务 中的最后一步中获取。
UserID：当前用户的 ID，字符串类型，只允许包含英文字母（a-z 和 A-Z）、数字（0-9）、连词符（-）和下划线（_）。
UserSig：使用 开通服务 的第3步中获取的SDKSecretKey对SDKAppID、UserID等信息进行加密，就可以得到UserSig，它是一个鉴权用的票据，用于腾讯云识别当前用户是否能够使用TRTC的服务。您可以通过控制台中的 辅助工具 生成一个临时可用的UserSig。
更多信息请参见 如何计算及使用 UserSig。
说明：
开发环境：如果您正在本地开发调试阶段，可以采用本地 GenerateTestUserSig.genTestUserSig() 函数生成 userSig。该方法中 SDKSecretKey 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
生产环境：如果您的项目要发布上线，请采用 服务端生成 UserSig 的方式。

步骤5：开始您的第一次 AI 对话

在 TUILogin.login 成功后，参考如下代码，即可发起 AI 对话。
Swift
let startParams = StartAIConversationParams()

let sdkAppId = 1600000001  // 1、替换 sdkAppId
let sdkSecretKey = "xxx"   // 2、替换 sdkSecretKey
let aiRobotId = "robot_\\(TUILogin.getUserID() ?? "")"
let aiRobotSig = GenerateTestUserSig.genTestUserSig(sdkAppId: sdkAppId, userId: aiRobotId, secrectkey: sdkSecretKey)
startParams.agentConfig = AIConversationDefine.AgentConfig.generateDefaultConfig(aiRobotId: aiRobotId, aiRobotSig: aiRobotSig)

startParams.secretId = "xxx"           // 3、替换 secretId
startParams.secretKey = "xxx"          // 4、替换 secretKey

// 5、替换 llmConfig
startParams.llmConfig = "{\\"LLMType\\":\\"openai\\",\\"Model\\":\\"hunyuan-turbo-latest\\",\\"SystemPrompt\\":\\"您是一个个人助手\\",\\"APIUrl\\":\\"https://hunyuan.cloud.tencent.com/openai/v1/chat/completions\\",\\"APIKey\\":\\"xxxx\\",\\"History\\":5,\\"Streaming\\":true}"
// 6、替换 ttsConfig
startParams.ttsConfig = "{\\"TTSType\\":\\"tencent\\",\\"AppId\\":\\"xxx\\",\\"SecretId\\":\\"xxx\\",\\"SecretKey\\":\\"xxx\\",\\"VoiceType\\":\\"502001\\",\\"Speed\\":1.25,\\"Volume\\":5,\\"PrimaryLanguage\\":1,\\"FastVoiceType\\":\\"\\"}"

let aiViewController = AIConversationViewController(aiParams: startParams)
navigationController?.pushViewController(aiViewController, animated: true)
1. sdkAppId 和 sdkSecretKey 使用 步骤4 获取的数据即可；
2. 使用 Playground 配置 AI 对话参数，包括基础配置、STT、LLM、TTS；然后点击右下角的快速跑通，切换到 iOS，获取 SecretId、SecretKey 和 Config 参数。

3. 将云 API 的 SecretId 和 SecretKey 复制到startParams.secretId和startParams.secretKey中。
4. 将 Config 信息复制到 Json 解析工具中，如 JsonUtil，将 LLMConfig 对应的字符串值复制到startParams.llmConfig，将 TTSConfig 对应的字符串值复制到startParams.ttsConfig中。
说明：
开发环境：如果您正在本地开发调试阶段，可以采用上述方式快速集成 AI 对话。该方法中账号信息很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
生产环境：如果您的项目要发布上线，请将上述账号信息保存到服务端中，避免流量被盗用；相关对话配置，也可以保存到服务端中，方便动态调整 AI 对话效果。
中国站
目录