一、产品简介
2D 小样本数智人客户端渲染 SDK 是腾讯云智能提供的数智人开发解决方案，支持低成本快速集成在终端上，可通过语音对数智人进行实时驱动；集成后，人像和口型渲染可以在用户终端设备上完成，适合并发量大的数智人交互场景。
目前提供两种授权模式：
授权模式 | 2D 端渲染 SDK 授权使用年包-按应用 | 2D 端渲染 SDK 授权使用年包-按设备 |
适用场景 | 支持移动端 Android 和 iOS 设备，建议设备： 1. 智能手机 2. 平板电脑（8 - 13英寸） 3. 小尺寸智慧屏（16英寸以下） | 支持大屏端 Android 设备，建议设备： 1. 智慧大屏 2. 大屏广告机 |
支持的分辨率 | 540P、720P | 1080P |
支持的设备数 | 购买1个“2D 端渲染 SDK 授权使用年包-按应用”，即可覆盖 Android + iOS 双端，支持不限设备数使用。 | 购买n个“2D 端渲染 SDK 授权使用年包-按设备”，根据终端使用数量来按需购买，n 等于终端设备数。 |
该 SDK 授权不包含 TTS 服务，若需使用数字人音色，需要购买通用音频合成资源；也支持通过三方音频输入使用 SDK。
二、核心功能
功能 | 功能描述 |
数智人口型驱动 | 支持输入流式 PCM 音频，实时驱动数智人口型。 |
数智人渲染 | 1. 支持在客户端对数智人模型加载渲染，输出透明背景的数智人视频流。 2. 用户可根据自身场景，自行在客户端灵活设置数智人背景，调整数智人的位置，对数智人大小进行自由缩放。 |
三、下单流程及接入说明
官网下单
1. 目前可在 2D 形象界面 > 选择配置 2D 端渲染。
2. 找到“2D 端渲染 SDK 授权使用年包”的资源包，选择合适的授权模式后，单击立即购买，如下图所示：
通用音频合成资源的购买方式
获取授权和 SDK 文件
授权文件获取流程，根据测试场景和正式场景有所不同。
测试场景
由于测试场景下，没有订单信息，故需要通过线下邮件形式，发送相关信息，我们会在收到邮件的第一时间给您配置授权文件并回复邮件。
测试场景下，按应用授权时，默认有效期为30天（允许同时部署在10台设备上），自发放之日起计算；按设备授权时，申请一次会提供10台设备的授权信息，默认有效期为30天，自设备主动激活之日起计算。有效期失效后，需重新申请。
邮件申请格式参考如下：
测试 License 授权申请流程（邮件）
邮箱地址：
txc_avatar@tencent.com邮件主题：2D 端渲染 SDK 申请-按应用（测试）或 2D 端渲染 SDK 申请-按设备（测试）
邮件内容：
腾讯云主账号：
使用场景：
iOS 设备请填写 Bundle ID：（按设备授权时，可为空）
Android 设备请填写 Application ID：（按设备授权时，可为空）
正式场景
1. 根据“官网下单”指引，完成下单后，登录 数智人平台，按照“资产管理中心 > 服务资产 > 未激活”步骤找到对应的订单信息，如下图：
2. 选择不同的授权模式，请参考以下操作：
当选择按设备授权模式时：
按设备授权时，会自动生成 licenseID 和 secretKey，可直接复制下载；也可以通过复选框，批量复制下载。如下图：
激活状态由设备端联网触发，平台上无需额外操作。设备激活后，可以在已激活页面查看有效期等信息。
当选择按应用授权模式时：
按应用授权时，需要用户自主上传应用信息，审核通过后方可生成 licenseID 和 secretKey。具体流程为：单击去激活 > 填写应用信息 > 提交审核（如下图）。
待审核通过后（正常情况下，1个工作日内处理完成），平台会自动生成密钥信息。用户自行复制下载密钥信息。路径为：资产管理中心 > 服务资产 > 已激活。如下图：
快速接入
获取授权和 SDK 文件后，可以参考如下文档集成开发：
移动端 Android SDK：移动端 Android SDK 接入指南
移动端 iOS SDK：移动端 iOS SDK 接入指南
大屏端 Android SDK：大屏端 Android SDK 接入指南
四、包体大小明细
1. 基础包体（渲染引擎）
需集成到代码中，直接影响安装包体积
平台 | 压缩前大小 | 压缩后大小 | 说明 |
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 升级记录
SDK 版本 | 升级点 | SDK 名称及形象包版本 |
V1.0 | 1. 能力新增 | SDK 版本以1.0.*结尾；适配的形象包版本以 V1 结尾 |
V1.1 | 1. 提升 SDK 稳定性 | SDK 版本以1.1.*结尾；适配的形象包版本以 V2 结尾 |
V1.3 | 1. 首帧延迟由1450毫秒降低到450毫秒 2. 基础包体和模型包大小降低一半 | SDK 版本以1.3.*结尾；适配的形象包版本以 V3 结尾 |
六、常见问题
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 日志管理及问题排查指南
为便于客户集成与问题排查，数智人端渲染 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 级别日志，复现问题后上报日志文件。
日志收集：请实现日志上传功能，在用户反馈问题时，可自动或引导用户上报日志文件至后台进行分析。
