产品授权常见问题
Q1.为什么要授权？
A：DUI系统的鉴授权服务由授权和鉴权两部分构成，其中：
- 授权是指为您的设备（用户）申请访问DUI系统语音技术的权利，并且给予您对应的凭证，用以证明您的身份；
- 鉴权是指验证您的设备（用户）通过向DUI系统提供授权凭证，并验证身份，确认是否拥有访问语音技术服务的权利。
如果您接入的是全链路技术语音产品，且需要大规模商用时，您需要购买语音技术服务，而通过鉴授权操作不但保证了您购买量和使用量数目一致，最大化确保您的利益；同时也提升了语音技术服务安全性和可靠性。另外，设备接入语音服务时，DUI系统会通过鉴授权服务确认发起请求的是哪个用户通过哪个设备来请求的，这样才可以更好的为您的用户服务，返回更适合您的用户的回复内容，更好的帮助他们得到想要的答案、完成想要完成的事情。
Q2.我要怎么选择Device name三种授权方式?
A：Device name有三种授权方式：
- 预烧录：产线上将设备授权证书device profile写入设备制度存储区的一种授权方式；
- 预登记：预先登记设备白名单，以用户设备注册激活的一种授权方式；
- 动态注册：使用设备唯一标识，在设备首次启动时动态注册设备信息的一种授权方式。
如果您的设备因为某些原因不能联网注册，或者您的设备不能联网有需要对某些离线语音服务进行测试，您可以选择预烧录方式；在此种情况下，DUI系统鉴授权服务会按照您申请的数量，生成同数量的设备名和对应的设备证书，您需要将设备名和设备证书一同烧录到设备上。
如果您预先知道需要授权的设备的标识，那么您可以采用预登记方式，将需要授权的设备列表告知DUI系统鉴授权服务，鉴授权服务按照您提供的设备列表进行授权验证；在此种情况下，您需要自己维护这个授权设备列表。
如果您知道设备的唯一标识，但是不确定需要给多少设备进行授权，又不想费力去维护授权设备列表，您可以采用动态注册的方式，先注册设备，在根据需要授权的设备量购买使用量；在此种情况下，如果您需要授权的设备量超过了您购买的使用量，您就需要购买新的使用量。
三种授权方式区别如下：
|
对比项 |
预烧录（device profile） |
预登记（deivce name） |
动态注册 |
|---|---|---|---|
| 联网注册要求 | 不需要 | 需要 | 需要 |
| 产线烧录要求 | 是 | 否 | 否 |
| 文件系统/存储要求 | 不需要，已固化 | 需要有地方保存设备密钥 | 需要有地方保存设备密钥 |
| 支持的客户端类型 | 所有类型, 一般是嵌入式硬件产品 | 所有类型, 一般是嵌入式硬件产品 | Android, iOS,嵌入式设备 |
| 在控制台上批量生成设备密钥 | 需要 | 不需要 | 不需要 |
| 在控制台上预登记设备标识 | 可选 | 需要 | 不需要 |
| Device Secret是否可变 | 不可变 | 可变, 如下 | 可变, 如下 |
| 防止多设备共用同一个DeviceName | 服务端风控机制 | 客户端检查设备信息是否区配 同一Device Name, 每次注册都生成一个新的Device Secret, 旧的失效 |
客户端检查设备信息是否匹配 同一Device Name, 每次注册都生成一个新的Device Secret, 旧的失效 |
| 在服务端禁止某些设备使用 | 支持 | 支持 | 支持 |
| 需要SDK配合 | 需要 | 需要 | 需要 |
Q3.产品的授权计费方式？
产品授权计费方式类型分为 如下两种：
- 激活数：如果您接入的是全链路语音技术产品，那么按照您设备的激活数进行授权；
- 调用数：如果您接入的是单项语音技术产品，那么按照您接入的语音技术调用次数进行授权。（点此了解语音识别、合成、唤醒每天调用限额是多少？如何申请提高限额？）
Q4.在控制台上完成授权申请后做什么？
A：授权整个流程如下：
- 创建产品：DUI系统鉴授权服务根据产品的类型和操作系统约定好鉴授权方式和对应的一套密钥，在控制台创建产品后，鉴授权服务根据您创建的产品的信息拿到约定好的鉴授权方式和密钥格式；
- 申请授权：您在控制台上，为该产品向DUI系统鉴授权服务申请所需的授权证书，或者向DUI系统提供需要授权的设备标识；
- 设备注册：设备证明自己属于该产品，并提供自己的设备标识，取得设备授权证书
- 设备登录：通过登录验证设备授权证书是否有效
- 授权验证：设备需要证明自己知道设备授权证书中的设备密钥，从而证明已获得了授权，此时DUI系统允许设备访问语音服务。
其中，1~2步在控制台上完成，3~5步在本地开发时进行；
如果您已经完成了控制台上的步骤，您可以参照文档《嵌入式授权说明》在本地进行后续授权操作。
Q5.申请了动态注册授权方式后下一步怎么做？
A：动态注册授权方式无需在控制台上申请授权文件或者登记需要授权的设备信息（了解Device name三种授权方式区别），您只需要：
- 在控制台上选择授权方式为：动态注册；
- 客户端第一次运行时注册设备，请求里带上详细设备信息；
- DUI服务端会生成DeviceName并返回DeviceProfile；
- 客户端将DeviceProfile写入文件系统或指定的存储区域。
Q6.授权方式选错了，我要怎么办？
A：如果您的产品是Android和IOS操作系统或以server服务接入的，那么授权方式为APII KEY授权，暂不支持更换；
如果是嵌入式操作系统的产品，可选三种授权方式：预烧录、预登记、动态注册；如果您：
1）选择了动态注册，那么选择后不可更改，您可以创建一个新产品，选择其他授权方式；
2）选择了预烧录，在您还没有申请授权证书的情况下，您可以切换授权方式；如下图：
3）选择了预登记，在您还没有登记设备的情况下，您可以切换授权方式；如下图：
请注意，如果您选择了预烧录且已经申请授权证书，或者是选择了预登记且已经登记了设备，那么您无法更换授权方式，只能创建新设备，选择其他授权方式。
Q7.在什么阶段需要购买产品用量？
A：如果您接入的是单项语音技术，SDK每天都一定免费额度，如果您需要提升额度，您需要联系我们购买用量。
如果您接入的是全链路技术产品，您需要为产品购买使用量，只要使用此产品的设备激活数目<您购买的使用量，您就无需购买用量；
在您的空余使用量还有一定额度时，DUI系统会以邮件的形式通知到您，此时您可以选择是否去购买用量。
Q8.购买产品用量有什么方式？
A：目前暂时不支持在控制台上购买产品用量，您需要通过如下方式联系我们，购买产品用量：
渠道一：拨打400-006-1314；
渠道二：邮件至marketing@aispeech.com；
您可以在邮件里附上您的姓名、手机号或座机、公司信息、产品领域、需求描述等信息，我们在收到您的邮件后会尽快与您取得联系。
渠道三：提交工单：
您可以在控制台（还没有账号的话可以先注册哦）反馈问题里选择问题类型为“商务合作”，我们在收到您的反馈后会尽快与您取得联系。我要怎么反馈问题？
*为了我们的商务同事能尽快了解到您的需求并与您联系，您给我们提供的信息可以参照以下模板：
|
姓名 |
手机号/座机 |
公司名称 |
所在领域 |
产品形态 |
需求描述 |
|---|---|---|---|---|---|
| 张三 | 18800000000 | 张三有限公司 | 儿童教育 | 故事机 | 购买授权量 |
Q9.Android设备授权时，没有keystore文件而无法获取SHA256，如何授权？
A：在版本V1.1.4.1之后的SDK中，有开放一个工具类, 可以在运行时获取SHA256值，然后在控制台上使用SHA256来进行授权APIKEY的申请。（下载SDK）
SDK中获取SHA256接口为： String sha256 = AuthUtil.getKeyHash(this); //详细操作见《Android SDK集成说明》
Q10.SDK的授权文件，是一个项目一个吗？在哪有整体的介绍？
A：每一台集成了DUI SDK的移动设备，都需要有一个与之deviceId唯一匹配的授权文件，文件生成的方式可参考我要怎么选择DeviceName三种授权方式?