一、产品简介
腾讯云智能 2D 小样本数智人客户端渲染 SDK（以下简称 2D 端渲染 SDK）是一款高效的数智人终端集成解决方案。该 SDK 支持在终端设备上完成数智人的实时驱动与渲染；集成后，人像和口型渲染可以在用户终端设备上完成，适合并发量大的数智人交互场景。
核心特性：
终端渲染： 人像与口唇驱动渲染均在用户设备本地完成。
实时驱动： 通过输入流式音频，可实时驱动数智人口型。
灵活集成： 提供透明背景的视频流输出，便于客户端自定义背景与布局。
授权模式概览：
授权模式 | 2D 端渲染 SDK 授权使用年包-按应用 | 2D 端渲染 SDK 授权使用年包-按设备 | 2D 端渲染 SDK 授权使用年包-按小程序 |
适合设备 | 支持移动端（Android/iOS），建议设备： 1. 智能手机 2. 平板电脑（8 - 13英寸） 3. 小尺寸智慧屏（16英寸以下） | 支持大屏端（Android） 设备，建议设备： 1. 智慧大屏 2. 大屏广告机 | iPhoneXS （不含）以上版本； 安卓端内测中 |
支持的分辨率 | 540P、720P | 1080P | 480P |
支持的设备数 | 购买1个授权，即可覆盖一个应用（Bundle ID/Application ID）在 Android 与 iOS 双端不限设备数 的使用。 | 根据实际部署的终端设备数量按需购买，1个授权对应1台设备。 | 1个授权对应一个小程序（AppId），不同的小程序即 AppId 不同时候，需要购买多个授权。 |
说明：
该 SDK 授权不包含 TTS（语音合成）服务。可接入第三方音频以驱动数智人；如需使用数字人音色，需额外购买“通用音频合成资源”。（接入方式详见 TTS SDK 接入）
2D 端渲染 SDK 年包（按应用）在移动端使用时，可额外购买“轻量版云端服务小时包”，在设备性能不足时，使用云端渲染服务，扩展对低性能设备的兼容性。（接入方式详见 端云混合渲染方案）
2D 端渲染 SDK 授权使用年包（按小程序），无需额外提供 License 信息，只需提交小程序 AppId（注意：小程序主体必须是企业）信息即可，云端会做校验绑定，详细 SDK获取流程详见：
二、SDK 主要信息及功能
功能 | 功能描述 | |
SDK 名称 | 2D 数智人客户端渲染 SDK | |
SDK 开发提供商 | 腾讯云计算（北京）有限责任公司 | |
SDK 功能 | 数智人口型驱动 | 支持输入流式 PCM 音频，实时驱动数智人口型。 |
| 数智人渲染 | 1. 在客户端加载并渲染数智人模型，输出带透明通道的视频流，便于与任意背景融合。 2. 支持在客户端灵活设置数智人背景、位置，并可自由缩放数智人大小，适配多样化的 UI 界面。 |
SDK 下载地址 | 安卓、ios：登录 数智人平台->创建会话互动项目->选择对应的数字人类型->选择“端渲染”及其他配置信息->确定后，调整“形象设置”及音色->SDK 接入->下载 SDK （注意：只有登录账号拥有数字人形象的前提下，才能创建会话互动项目） 小程序：登录微信小程序平台（注意：1. 要选择集成插件的小程序登录；2. 登录的小程序主体必须是企业，否则无法使用插件），登录后选择“管理-账号设置-第三方设置-插件管理”，点击“添加插件”，搜索“智能数智人端渲染引擎”后点击添加，待审核通过后即可使用。插件详情里可以查看开发文档。具体流程详见： | |
SDK 当前版本 | Android 1.7.x iOS 1.7.x 小程序插件0.1.0（智能数智人端渲染引擎） | |
个人信息处理规则 | | |
开发者合规使用指南 | | |
三、购买及接入流程
1. 购买授权
1.2 找到“2D 端渲染 SDK 授权使用年包”的资源包，选择合适的授权模式后，单击立即购买，如下图所示：
2. 获取 License 与 SDK
说明：
小程序端不需要获取 License 等信息，只需要提交 AppId 后审核通过即可。原理主要是小程序架构下，我们通过插件渲染数字人，数智人后端服务会跟小程序插件闭环完成校验鉴权工作，无需外部额外配置 License 等参数。其余激活流程同安卓、IOS一致。小程序端只需参考 微信小程序端 SDK 接入 对接即可。
2.1 按照“资产管理中心 > 服务资产 > 未激活”步骤找到对应的订单信息，如下图：
2.2 根据您购买的授权模式，操作流程有所不同：
按设备授权模式：
系统将自动生成 licenseID 和 secretKey，您可直接复制这些信息，或通过复选框批量操作。如下图：
激活机制：License 的激活状态由设备端在联网状态下首次使用 SDK 时触发，平台端无需手动操作。激活后，可在已激活页面查看有效期等信息。
按应用授权模式：
您需要主动提交应用信息以供审核。
具体流程：单击去激活 > 填写应用信息 > 提交审核（如下图）。
审核通过后（通常为1个工作日内），平台将生成 LicenseID 和 SecretKey。
获取路径为：资产管理中心 > 服务资产 > 已激活。如下图：
2.3 下载 SDK（安卓、iOS 参考这个流程，小程序接入可忽略）：
2.4 下载小程序插件（安卓、iOS 平台可忽略该流程）
注意：
要选择集成插件的小程序登录。
登录的小程序主体必须是企业，否则无法使用插件。
（2）登录后选择管理 > 账号设置 > 第三方设置>插件管理，单击添加插件，搜索“智能数智人端渲染引擎”后点击添加，待审核通过后即可使用。插件详情里可以查看开发文档，也可以参考 微信小程序端 SDK 接入。
请确保插件通过确认，否则在联调测试预览时候，会报80082错误，如下图。
2.5 模型下载
注意：
如果是小程序模式，还需要在小程序中对自有存储服务的下载模型地址进行加白处理，否则调试无法通过。
小程序模型下载入口暂时未提供，您可联系商务了解获取方式。
3. 快速接入
获取授权和 SDK 文件后，请参考对应的接入文档进行集成开发：
移动端 Android SDK 接入指南：移动端 Android SDK 接入
移动端 iOS SDK 接入指南：移动端 iOS SDK 接入
大屏端 Android SDK 接入指南：大屏端 Android SDK 接入
端云混合渲染方案接入指南：端云混合渲染方案
微信小程序端 SDK 接入指南：微信小程序端 SDK 接入
四、其他相关服务
根据您的业务需求，您可选购以下资源：
1. 通用音频合成资源
若需使用数智人专属音色进行播报，需要额外购买此项服务。具体如下图所示：
2. 轻量版云端服务小时包
为解决部分终端设备性能不足导致的渲染问题，我们提供端云混合渲染方案。当设备性能充足时，使用本地渲染；当设备性能不足时，可自动切换至云端 CPU 进行推理，此时需购买此小时包。具体如下图所示：
说明：云端 CPU 推理支持的分辨率为720P。
五、资源占用说明
1. 基础 SDK 包体（渲染引擎）
此部分需集成到应用安装包中，直接影响应用初始下载体积。
平台 | 压缩前大小 | 压缩后大小（下载体积） | 说明 |
Android（APK） | 24MB | ≈7.5MB | 经 ZIP 压缩优化，减少下载体积。 |
iOS（IPA） | 38.8MB | ≈12.5MB | |
2. 模型资源包
模型包为动态下载资源，按需加载至设备存储，不影响应用初始安装包的大小。
基础模型包（必备组件）
类型 | 压缩前大小 | 压缩后大小（下载体积） | 说明 |
2D 渲染引擎 | 82MB | ≈58MB | 支持所有数智人形象基础渲染能力的核心组件。 |
数智人形象包
形象类型 | 压缩前大小 | 压缩后大小（下载体积） | 分辨率 | 内容说明 |
照片数智人 | 38MB | ≈25MB | 540p | 基于1张静态照片建模生成的数字人形象。 |
SDK 默认形象 | 60MB | ≈43MB | 540p | 预置的公共形象，包含约1分30秒的动态视频素材。 |
用户定制形象 | 30 - 200MB | 依定制内容而定 | - | 大小与定制素材分辨率、时长正相关，每个形象独立成包。 |
六、版本更新记录
SDK 版本 | 主要优化与特性 | 适配说明 |
V1.7 | • 新增功能：支持 2D 精品数智人，可以自主插入动作 • 问题修复：修复稳定性和内存问题 • 功能变更：interrupt() 接口增加返回值，标识打断是否成功 | SDK 版本号以 1.7.*结尾；需搭配版本号以 V3 结尾的形象包使用。 |
V1.6 | • 新增功能： 支持性能更好的 480p 模型推理 基础模型包体积优化，基础模型包从 57.7MB 优化到 11.6MB • 问题优化：代码重构，解决了一些历史的崩溃和内存泄露问题 | SDK 版本号以 1.6.*结尾；需搭配版本号以 V3 结尾的形象包使用。 |
V1.4 | • 问题修复： - 修复音频播放被外界终止时不能恢复的问题 - 修复静默区间问题 | SDK 版本号以 1.4.*结尾；需搭配版本号以 V3 结尾的形象包使用。 |
V1.3 | • 性能提升：首帧渲染延迟从1450ms 大幅降低至450ms。 • 体积优化：基础包体和模型包体积减少约50%。 | SDK 版本号以 1.3.*结尾；需搭配版本号以 V3 结尾的形象包使用。 |
V1.1 | • 稳定性增强：显著提升了 SDK 的运行稳定性与兼容性。 | SDK 版本号以 1.1.*结尾；需搭配版本号以 V2 结尾的形象包使用。 |
V1.0 | • 基础功能：提供数智人驱动与渲染的基础能力。 | SDK 版本号以 1.0.*结尾；需搭配版本号以 V1 结尾的形象包使用。 |
七、常见问题（FAQ）
1. 如何获取 iOS 的 Bundle ID 和 Android 的 Application ID？
iOS 设备的 Bundle ID，可以在 Xcode 的 App 设置， Signing & Capabilities 中找到，如下图所示：
Android 设备的 Application ID, 可以在工程目录的 build.gradle 文件中找到，如下图所示：
2. 2D 小样本端渲染是否支持定制形象？
支持。目前以下3种定制类型均可用于端渲染 SDK：
2D 小样本通用口型
2D 小样本专属口型
2D 小样本照片
定制方式：
自助采购和定制 2D 小样本数字人：按 定制资产指引 完成形象定制。
定制完成后，可以通过发邮件（txc_avatar@tencent.com）线下获取形象模型包。
3. 如何进行日志管理以协助问题排查？
为便于客户集成与问题排查，数智人端渲染 SDK 提供了灵活的日志输出配置接口。请参考以下指南进行日志管理和问题排查：
日志等级说明
日志等级 | iOS 等级标识 | 安卓等级标识 | 适用场景 | 输出频率 | 存储占用 |
关闭日志 | TVHLogLevelOff | 0 | 不建议使用 | 无输出 | 无 |
错误日志 | TVHLogLevelError | 1 | 生产环境重大问题 | 极低 | 可忽略 |
警告日志 | TVHLogLevelWarn | 2 | 推荐生产环境默认级别 | 较低 | 可忽略 |
信息日志 | TVHLogLevelInfo | 3 | 推荐日常调试级别 | 适中 | <1MB/天 |
调试日志 | TVHLogLevelDebug | 4 | 开发阶段问题定位 | 较高 | 1-5MB/天 |
追踪日志 | TVHLogLevelTrace | 5 | 极端情况问题复现 | 极高 | >100MB/天 |
数智人 SDK 日志配置原则
初始化前必设：日志等级必须在 SDK 初始化前配置，运行时无法修改。
推荐级别：日常使用建议设置为 WARN 或 INFO 级别，在保证关键日志输出的同时避免输出过多日志。
慎用 TRACE：避免长期开启 Trace 级别，以防存储占用过大和性能下降。
禁止长期关闭：生产环境不建议长期设置为 OFF 级别，否则无法获取关键问题日志。
问题反馈：用户反馈问题时，请提供 INFO 级别日志，以便协助定位问题。
云控调试：特殊情况下，可通过云控临时开启 TRACE 级别日志，复现问题后上报日志文件。
日志收集：请实现日志上传功能，在用户反馈问题时，可自动或引导用户上报日志文件至后台进行分析。
