实时音视频 原子组件集成（iOS）

一、功能预览

二、核心功能

AIConversationCoreView 是一个专为 AI 对话设计的轻量级 View 组件，是你构建 AI 对话的核心，它封装了所有复杂的底层技术（例如开启 AI 对话、结束 AI 对话）。你可以将 AIConversationCoreView 作为 AI 对话画面的"画布"，专注于上层 UI 与交互的开发。

四、步骤 1：开通服务

使用 AIConversationCoreView 前，请先参考 开通服务，领取体验版或开通付费版。

六、集成 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. 配置证书信息：

七、工程配置

使用 AI 对话，需要授权麦克风使用权限。在 App 的 Info.plist 中添加以下麦克风声明，对应麦克风系统弹出授权对话框时的提示信息。

<key>NSMicrophoneUsageDescription</key><string>此应用需要使用麦克风进行 AI 语音对话</string>

八、步骤 3：实现登录逻辑

在你的项目中添加登录代码，这是使用 AIConversationCoreView 各项功能的关键前提：

注意：重要：

注意：推荐在你 App 自身的用户账户登录成功后，再调用 TUILogin.login，以确保登录业务逻辑的清晰和一致。

swiftimport TUICoreimport AIConversationKit// 示例代码在 didFinishLaunchingWithOptions 完成登录，推荐你在自己登录业务完成后再调用登录服务func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { let userId = "denny" // 请替换为你的 UserID let sdkAppId = 1600000001 // 请替换为开通服务控制台的 SDKAppID let sdkSecretKey = "xxx" // 请替换为开通服务控制台的 SDKSecretKey let userSig = GenerateTestUserSig.genTestUserSig(sdkAppId: sdkAppId, userId: userId, secretkey: 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}

登录接口参数说明

十、步骤 1：添加 AIConversationCoreView

只需要将 AIConversationCoreView 添加到你的 ViewController 中即可。

import UIKitimport AIConversationKitclass YourAIViewController: UIViewController { private let conversationCoreView = AIConversationCoreView() override func viewDidLoad() { super.viewDidLoad() view.addSubview(conversationCoreView) conversationCoreView.frame = view.bounds conversationCoreView.autoresizingMask = [.flexibleWidth, .flexibleHeight] }}

十一、步骤 2：开启 AI 对话

通过调用 startAIConversation 接口开始 AI 对话，完整示例代码如下：

import UIKitimport AIConversationKitimport TUICoreclass YourAIViewController: UIViewController { private let conversationCoreView = AIConversationCoreView() override func viewDidLoad() { super.viewDidLoad() view.addSubview(conversationCoreView) conversationCoreView.frame = view.bounds conversationCoreView.autoresizingMask = [.flexibleWidth, .flexibleHeight] startAIConversation() } private func startAIConversation() { var config = AIConversationConfig() let sdkAppId = 1600000001 // 1、替换 sdkAppId let sdkSecretKey = "xxx" // 2、替换 sdkSecretKey let aiRobotId = "robot_\\(TUILogin.getUserID() ?? "")" let aiRobotSig = GenerateTestUserSig.genTestUserSig(sdkAppId: sdkAppId, userId: aiRobotId, secretkey: sdkSecretKey) config.agentConfig?.aiRobotId = aiRobotId config.agentConfig?.aiRobotSig = aiRobotSig config.secretId = "xxx" // 3、替换 secretId config.secretKey = "xxx" // 4、替换 secretKey // 5、替换 llmConfig config.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 config.ttsConfig = "{\\"TTSType\\":\\"tencent\\",\\"AppId\\":\\"xxx\\",\\"SecretId\\":\\"xxx\\",\\"SecretKey\\":\\"xxx\\",\\"VoiceType\\":\\"502001\\",\\"Speed\\":1.25,\\"Volume\\":5,\\"PrimaryLanguage\\":1,\\"FastVoiceType\\":\\"\\"}" conversationCoreView.startAIConversation(config: config) { code, message in print("startAIConversation code: \\(code), message: \\(message)") } }}

1. sdkAppId 和 sdkSecretKey 使用 完成登录 后获取的数据即可。

2. 请到 准备工作 配置 AI 对话后台参数，包括基础配置、STT、LLM、TTS；然后点击右下角的快速跑通，切换到 iOS，获取 SecretId、SecretKey 和 Config 参数。

3. 将云 API 的 SecretId 和 SecretKey 复制到config.secretId和config.secretKey中，SecretId 和 SecretKey 请妥善保存，避免泄露。

4. 将 Config 信息复制到 JSON 解析工具中，例如 JSONUtil，将 LLMConfig 对应的字符串值复制到config.llmConfig，将 TTSConfig 对应的字符串值复制到config.ttsConfig中。

注意：说明：

十二、步骤 3：结束 AI 对话

通过调用 stopAIConversation 接口结束 AI 对话，示例代码如下：

import UIKitimport AIConversationKitimport TUICoreclass YourAIViewController: UIViewController { // … 其他代码 … private func stopAIConversation() { conversationCoreView.stopAIConversation() { code, message in print("stopAIConversation code: \\(code), message: \\(message)") } }}

十三、步骤 4：显示 AI 对话字幕 (可选)

只需要将 AIConversationSubtitleView 添加到你的 ViewController 中，即可完成 AI 对话字幕的显示。

import UIKitimport AIConversationKitclass YourAIViewController: UIViewController { private let conversationCoreView = AIConversationCoreView() private let subtitleView = AIConversationSubtitleView() override func viewDidLoad() { super.viewDidLoad() view.addSubview(conversationCoreView) conversationCoreView.frame = view.bounds conversationCoreView.autoresizingMask = [.flexibleWidth, .flexibleHeight] // 添加字幕视图 view.addSubview(subtitleView) subtitleView.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ subtitleView.leadingAnchor.constraint(equalTo: view.leadingAnchor), subtitleView.trailingAnchor.constraint(equalTo: view.trailingAnchor), subtitleView.topAnchor.constraint(equalTo: view.topAnchor, constant: 120), subtitleView.bottomAnchor.constraint(equalTo: view.bottomAnchor, constant: -120) ]) }}

十四、步骤 5：控制麦克风开关 （可选）

只需要将 MicView 添加到你的 ViewController 中，即可点击开关本地麦克风。

import UIKitimport AIConversationKitclass YourAIViewController: UIViewController { private let conversationCoreView = AIConversationCoreView() private let micView = MicView() override func viewDidLoad() { super.viewDidLoad() view.addSubview(conversationCoreView) conversationCoreView.frame = view.bounds conversationCoreView.autoresizingMask = [.flexibleWidth, .flexibleHeight] // 添加 MicView view.addSubview(micView) micView.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ micView.widthAnchor.constraint(equalToConstant: 120), micView.heightAnchor.constraint(equalToConstant: 120), micView.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 48), micView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -32) ]) }}

十五、步骤 6：显示 AI 状态 （可选）

只需要将 AIStatusView 添加到你的 ViewController 中，即可显示当前 AI 状态。

import UIKitimport AIConversationKitclass YourAIViewController: UIViewController { private let conversationCoreView = AIConversationCoreView() private let aiStatusView = AIStatusView() override func viewDidLoad() { super.viewDidLoad() view.addSubview(conversationCoreView) conversationCoreView.frame = view.bounds conversationCoreView.autoresizingMask = [.flexibleWidth, .flexibleHeight] // 添加 AIStatusView view.addSubview(aiStatusView) aiStatusView.translatesAutoresizingMaskIntoConstraints = false NSLayoutConstraint.activate([ aiStatusView.widthAnchor.constraint(equalToConstant: 180), aiStatusView.heightAnchor.constraint(equalToConstant: 130), aiStatusView.centerXAnchor.constraint(equalTo: view.centerXAnchor), aiStatusView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -48) ]) }}

十六、调节对话效果

为了在 AI 对话中获得最佳体验，清晰的声音采集至关重要。我们提供多种参数设置，帮助你在不同环境下都能获得清晰的语音交互效果。

十七、vadLevel 远场人声抑制

在多人交谈的环境中，其他人声可能会干扰 AI 对你声音的识别。通过调整人声抑制级别，我们可以有效过滤环境中的其他人声干扰，让 AI 更准确地专注于你的语音；你可以通过设置 config 中的 sttConfig.vadLevel 参数来达到期望的效果。

代码配置示例

var config = AIConversationConfig()config.sttConfig?.vadLevel = 3conversationCoreView.startAIConversation(config: config, completion: nil)

十八、interruptMode 打断模式

根据你的使用习惯，可以设置不同的打断方式，在 AI 说话时进行打断，使对话交互更加自然流畅；你可以通过设置 config 中的 agentConfig.interruptMode 参数来达到期望的效果。

代码配置示例

var config = AIConversationConfig()config.agentConfig?.interruptMode = 1conversationCoreView.startAIConversation(config: config, completion: nil)

十九、language 语言识别

根据说话者使用的语言进行设置，AI 才能准确地将语音转换成对应的文字内容；你可以通过设置 config 中的 sttConfig.language 参数来达到期望的效果。

更多支持的语言，请参考 STTConfig 产品文档。

代码配置示例

var config = AIConversationConfig()config.sttConfig?.language = "en"conversationCoreView.startAIConversation(config: config, completion: nil)

21、pod install 执行后本地安装找不到 AIConversationKit 最新版本？

如果无法安装 TUILiveKit 最新版本，请按以下步骤操作：

1. 在 Podfile 所在目录下删除 Podfile.lock 和 Pods，你可以选择手动删除或终端执行以下命令

// cd 到 Podfile 所在目录下rm -rf Pods/rm Podfile.lock

2. 在 Podfile 所在目录下执行 pod install –repo-update

// cd 到 Podfile 所在目录下pod install –repo-update

22、每次进房都需要调用登录吗？

不需要。通常你只需要完成一次 TUILogin.login 调用即可，我们建议你将 TUILogin.login 和 TUILogin.logout 与自己的登录业务关联。

23、Podfile 文件有没有示例配置可以参考？

你可以参考 GitHub AIConversationKit Example 工程 Podfile 示例文件。

24、部署目标版本过低警告 ？

如果你遇到如下错误：

clang: error: SDK does not contain 'libarclite' at the path '/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/arc/libarclite_iphonesimulator.a'; try increasing the minimum deployment target部署目标版本过低警告：TXLiteAVSDK_Professional: iOS 8.0 → 需要 12.0+TXIMSDK_Plus_iOS_XCFramework: iOS 8.0 → 需要 12.0+TUICore: iOS 9.0 → 需要 12.0+

请参考 GitHub AIConversationKit Example 工程 Podfile 示例文件，添加以下代码：

post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO' config.build_settings['ENABLE_BITCODE'] = 'NO' config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = 13.0 end endend