云渲染 IOS SDK 产品介绍

最近更新时间:2026-06-01 16:53:00

我的收藏

系统要求

系统版本:支持 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()
完整接入步骤请参见 快速跑通云渲染 iOS SDK,全部 API 参数请参见 云渲染 iOS SDK 接口说明


开始使用:获取密钥与参数

接入前需要在数智人平台上创建或获取以下凭证:
参数
获取位置
说明
APP_KEY
数智人平台 > 资源管理中心 > 基本信息

数智人的唯一标识
ACCESS_TOKEN
数智人平台 > 资源管理中心 > 基本信息

访问令牌,用于 SDK 鉴权
VIRTUALMAN_PROJECT_ID
数智人平台 > 会话互动

注意:数智人类型和对话服务配置按实际情况来选择,图中仅为示例。

项目 ID,用于 Project 模式建流
ASSET_VIRTUALMAN_KEY
数智人平台 > 资源管理中心 > 形象资产

资产 Key,用于 Asset 模式建流(个人定制形象)
获取以上参数后,填入代码即可完成基础接入。