系统要求
系统版本:支持 iOS 13+。
产品架构简介
云渲染(Cloud Rendering)是一种将图形渲染和 AI 计算从本地设备迁移到云端执行的技术方案。在数智人场景中,数字人的形象渲染在云端 GPU 集群上完成,处理好的视频流通过腾讯云 TRTC 实时音视频通道低延迟推送到 iOS 端展示。
┌──────────┐ ┌────────────────┐ ┌─────────────────────┐│ iOS App │ ◄──TRTC─│ 云端 GPU 集群 │◄──WS── │ 数智人平台服务 ││ (拉流展示)│ 音视频流 │ (3D 渲染) │ 指令 │ (LLM/技能/形象管理) │└──────────┘ └────────────────┘ └─────────────────────┘
核心能力
多模态驱动
SDK 支持多种驱动方式,适配不同的接入形态:
驱动方式 | 接口 | 适用场景 |
纯文本 | sendText() | 固定话术播报:欢迎语、营销通知 |
流式文本 | sendStreamText() | 接入外部 LLM 流式输出,边生成边播报 |
音频 | sendAudio() | 已有 ASR 引擎时,PCM 数据直接驱动口型 |
所有驱动均支持
stop() 打断,以及通过 SEI 在视频流中携带业务数据。
透明通道(Alpha)
开启后视频流包含 Alpha 通道数据,客户端可将数字人与任意背景合成——图片、视频、AR 场景均可,实现沉浸式融合效果。
自动重连与状态感知
内置 WebSocket 断线重连(45s 心跳)和网络质量感知机制。通过
VirtualmanWsDelegate 可实时获知连接状态,用于 UI 展示"在线 / 重连中 / 断开",提升用户体验。
快速体验
// 1. 创建视图let virtualman = Virtualman(frame: view.bounds)view.addSubview(virtualman)// 2. 初始化(填入从平台获取的凭证)virtualman.initSDK(params: VirtualmanParams(appkey: "你的 APP_KEY",accesstoken: "你的 ACCESS_TOKEN",virtualmanProjectParams: VirtualmanProjectParams(virtualmanProjectId: "你的 PROJECT_ID")))// 3. 建流virtualman.open { sessionId, error in ... }// 4. 对话virtualman.chat(ChatParams(text: "你好"))// 5. 页面销毁时关流virtualman.close()
开始使用:获取密钥与参数
接入前需要在数智人平台上创建或获取以下凭证:
获取以上参数后,填入代码即可完成基础接入。




