一、产品简介
腾讯云智能 2D 小样本数智人客户端渲染 SDK（以下简称 2D 端渲染 SDK）是一款高效的数智人终端集成解决方案。该 SDK 支持在终端设备上完成数智人的实时驱动与渲染；集成后，人像和口型渲染可以在用户终端设备上完成，适合并发量大的数智人交互场景。
核心特性：
终端渲染： 人像与口唇驱动渲染均在用户设备本地完成。
实时驱动： 通过输入流式音频，可实时驱动数智人口型。
灵活集成： 提供透明背景的视频流输出，便于客户端自定义背景与布局。
授权模式概览：
授权模式 | 2D 端渲染 SDK 授权使用年包-按应用 | 2D 端渲染 SDK 授权使用年包-按设备 |
适合设备 | 支持移动端（Android/iOS），建议设备： 1. 智能手机 2. 平板电脑（8 - 13英寸） 3. 小尺寸智慧屏（16英寸以下） | 支持大屏端（Android） 设备，建议设备： 1. 智慧大屏 2. 大屏广告机 |
支持的分辨率 | 540P、720P | 1080P |
支持的设备数 | 购买1个授权，即可覆盖一个应用（Bundle ID/Application ID）在 Android 与 iOS 双端不限设备数 的使用。 | 根据实际部署的终端设备数量按需购买，1个授权对应1台设备。 |
说明：
该SDK授权不包含TTS（语音合成）服务。可接入第三方音频以驱动数字人；如需使用数字人音色，需额外购买“通用音频合成资源”。（接入方式详见 TTS SDK 接入）
2D 端渲染 SDK 年包（按应用）在移动端使用时，可额外购买“轻量版云端服务小时包”，在设备性能不足时，使用云端渲染服务，扩展对低性能设备的兼容性。（接入方式详见 端云混合渲染方案）
二、核心功能
功能 | 功能描述 |
数智人口型驱动 | 支持输入流式 PCM 音频，实时驱动数智人口型。 |
数智人渲染 | 1. 在客户端加载并渲染数智人模型，输出带透明通道的视频流，便于与任意背景融合。 2. 支持在客户端灵活设置数智人背景、位置，并可自由缩放数智人大小，适配多样化的UI界面。 |
三、购买及接入流程
1. 购买授权
2）找到“2D 端渲染 SDK 授权使用年包”的资源包，选择合适的授权模式后，单击立即购买，如下图所示：
2. 获取 License 与 SDK
1）按照“资产管理中心 > 服务资产 > 未激活”步骤找到对应的订单信息，如下图：
2）根据您购买的授权模式，操作流程有所不同：
按设备授权模式：
系统将自动生成 licenseID 和 secretKey，您可直接复制这些信息，或通过复选框批量操作。如下图：
激活机制：License 的激活状态由设备端在联网状态下首次使用SDK时触发，平台端无需手动操作。激活后，可在已激活页面查看有效期等信息。
激活机制：License 的激活状态由设备端在联网状态下首次使用SDK时触发，平台端无需手动操作。激活后，可在已激活页面查看有效期等信息。
按应用授权模式：
您需要主动提交应用信息以供审核。
具体流程：单击去激活 > 填写应用信息 > 提交审核（如下图）。
审核通过后（通常为1个工作日内），平台将生成 LicenseID 和 SecretKey。
获取路径为：资产管理中心 > 服务资产 > 已激活。如下图：
3. 测试授权申请
在测试阶段，您可通过邮件申请测试授权。
测试 License 授权申请流程（邮件）
邮箱地址：
txc_avatar@tencent.com邮件主题：2D 端渲染 SDK 申请-按应用（测试）或 2D 端渲染 SDK 申请-按设备（测试）
邮件内容：
腾讯云主账号：
使用场景：
iOS 设备请填写 Bundle ID：（按设备授权时，可为空）
Android 设备请填写 Application ID：（按设备授权时，可为空）
测试授权说明：测试授权分为两种模式，请注意其规则：
按应用授权：
有效期：自发放之日起 30天。
部署限制：允许同时部署在 10台设备 上。
按设备授权：
有效期：自单台设备首次激活之日起 30天。
数量：每次申请默认提供 10台设备 的授权信息。
重要提示：授权失效后，如需继续测试，请重新按上述流程申请。
4. 快速接入
获取授权和 SDK 文件后，请参考对应的接入文档进行集成开发：
移动端 Android SDK 接入指南：移动端 Android SDK 接入
移动端 iOS SDK 接入指南：移动端 iOS SDK 接入
大屏端 Android SDK 接入指南：大屏端 Android 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.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 级别日志，复现问题后上报日志文件。
日志收集：请实现日志上传功能，在用户反馈问题时，可自动或引导用户上报日志文件至后台进行分析。
