授权说明
本文档主要说明了数智人端渲染 SDK Windows 的授权管理,如何申请授权和使用授权。
端渲染 SDK 是按设备授权方式,授权绑定特定机器设备,如更换了渲染设备,或更换了渲染设备的 CPU、主板等主要配件,需要重新授权。
授权方式分为在线和离线两种方式,对应客户机器是否能连接外网。
获取授权
客户请联系腾讯侧对接人。腾讯侧架构师参考如下流程申请。
1. 进入 优图离线 SDK 申请 页面,单击申请离线 SDK 按钮。
2. 在申请 SDK 下选择其他 > 数智人客户端渲染v1。
其他内容填写请咨询产品经理或行业架构师。
待审核通过后,可以拿到 AppID 和 SecretKey 会在后续步骤使用。
在线授权
如果渲染机器能够连接外网, 激活程序会自动提取机器指纹,自动向授权服务器获取授权,自动保存授权文件。
在线授权可以使用配置工具或命令行参数激活, 二选一即可。
使用配置工具激活授权
1. 打开数智人配置工具, 选择端渲染授权菜单。
配置工具中会显示当前产品的激活状态和授权到期时间。2. 如需要激活数智人 Windows 端渲染 SDK, 可将上一步骤获得的 AppID 和 SecretKey 填入输入框中,单击激活产品。即可完成激活。
使用命令行参数激活授权
在启动端渲染 SDK 程序 VirtualHumanUE51.exe 时, 将参数传入。
传入方式示例:
VirtualHumanUE51.exe -TencentLicenseAppID=xxxxxxxxxx -TencentLicenseSecretKey=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
其中各参数说明:
参数名称 | 必选 | 类型 | 描述 |
TencentLicenseAppID | 是 | String | 授权获取到的 AppID |
TencentLicenseSecretKey | 是 | string | 授权获取到的 SecretKey |
TencentLicenseFile | 否 | string | 授权文件保存的路径, 如果不填 默认为 c:\\TencentLicense\\virtual_human.lic |
离线授权
我们强烈建议您使用在线授权, 只有当渲染机器不能访问外网的情况下, 才使用离线授权方式。
提取机器指纹 (在渲染机器上操作)
在 Windows 进入命令行窗口 (单击开始 > 运行 > 输入 cmd > 单击运行)
进入授权工具目录,执行:
auth_tool.exe info
执行后,会在当前目录生成
device_info_win_xxxxxxxxxx.txt
文件。 将此文件拷贝到可以联网的电脑上。
获取授权文件 (在另外一台能联网的电脑上操作)
拿到从渲染机拷贝过来的
device_info_win_xxxxxxxxxx.txt
文件,并和授权工具放在同一个目录。在 Windows 进入命令行窗口 (单击开始 > 运行 > 输入 cmd > 单击运行)
进入授权工具目录,执行:
auth_tool.exe fetch [AppID] [SecretKey] [device_info 文件]
例如:
auth_tool.exe fetch xxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx device_info_win_xxxxxxxxxx.txt
执行后,会在当前目录生成授权文件
license_win_xxxxxxxxxx.lic
。将授权文件拷贝到渲染机。
放置授权文件 (在渲染机器上操作)
将授权工具获取的授权文件
license_win_xxxxxxxxxx.lic
, 改名为 virtual_human.lic
,并拷贝到 c:\\TencentLicense\\
目录下。如果在启动端渲染 SDK 时传出人
TencentLicenseFile
启动参数, 则将授权文件拷贝到对应的目录,并确认文件名是否与传入参数一致。