本文档旨在指导车厂完成autoSDK服务类商品（如ehpv2、车道级数据服务等）的购买、鉴权流程的开发对接。

方案概述：

关键环节介绍：

商品下单：支持2种方式

云对云下单：需要车厂订单后台对接高德订单后台的云对云下单接口，可以随时下单和查询订单生产结果，可以实现车主对增值服务的按需开通订阅；
商务邮件下单：一般是批量下单，人工将一批设备的id邮件发送给高德商务进行下单。

SDK获取服务授权：

涉及付费服务的购买和激活，需要hmi将SDK的“鉴权服务”接口初始化，这样SDK会在联网条件下自动向授权后台更新服务授权许可信息。
只有为设备下单购买了付费服务商品，SDK才能获取到后台的服务授权许可信息，付费服务才能正常访问。

1、SDK服务鉴权功能开发：

1.1 鉴权服务初始化：

1.2 鉴权失败的处理：

2、云对云下单对接

车厂可以通过云对云下单的方案，来实现随时按需开通服务。

如果项目打算只采用人工邮件下单，可以不用对接本章节内容。

高德提供2个接口：

1、下单接口：会实时返回订单的受理情况

2、订单生产结果查询：车厂可以在下单后，主动来查询订单生产情况（服务类商品稍候即可查询，license类商品下单后5分钟可查）

下单接口关键字段介绍：

1、权限校验字段：

AccessKeyId	String	是	访问服务使用的密钥ID
Signature	String	是	签名结果串

2、订单业务字段：

补充说明：

以上提及的权限校验字段（AK\\SK）、商品id（cid）字段，可联系高德项目对接人获取；
下单的设备id（vid）必须跟端上鉴权使用的vid保持一致；

云对云下单接口文档：

https://commerce-infra.amap.test/ws/commerce-infra/docs/out.html

如果无法访问，请联系项目对接人获取离线文档。

3、鉴权功能测试

SDK鉴权对接和云对云下单对接完成后，可以进入付费服务的鉴权流程测试；

将SDK环境切换到测网，提供测试设备的设备id给高德对接人下单购买付费服务。（如果项目有对接云对云下单，也可以直接通过云对云下单接口为测试设备下单）
确保覆盖以下的测试case：

测试设备未下单购买服务，预期：鉴权功能初始化成功，且付费服务（如ehpv2）不可用；
测试设备已下单购买服务后，预期：鉴权功能初始化成功，付费服务可用；
测试设备的服务权限过期后（可以提供pid+vid，让高德人员模拟服务过期），预期：付费服务不可用；
对过期设备进行续费后，预期：服务恢复可用；

以上4个测试case，需要记录日志给高德进行校验，确认对接的结果符合预期。日志类型包括：SDK基本日志、gnet日志、付费服务模块的日志（如ehp日志），日志要从SDK初始化前就开始记录。gnet日志的开启方法可以本文最后一个章节。

如何检查SDK鉴权功能是否初始化成功？

按照1.1章节对接鉴权服务初始化接口后，初始化，检查onRecvAuthcarServerlist回调的内容，如果这个回调内容包含【"code":1】，说明鉴权功能初始化成功。
对测试设备下单后，初始化SDK，检查onRecvAuthcarToken回调的内容，如果这个回调内容包含【"code":1】，说明鉴权功能初始化成功，且测试设备已获得付费服务的权限。
鉴权成功后，会在鉴权文件保存路径下生成authentication.db文件；

4、鉴权问题调查

1、HMI先排查：

SDK鉴权服务已正确初始化，并检查pid、vid传参是否正确

确保SDK鉴权功能初始化成功，且鉴权成功。（检查onRecvAuthcarServerlist和onRecvAuthcarToken这2个回调是否都包含【"code":1】）
注意初始化接口的vid传参要求跟下单的设备id保持一致；

确认测试设备的付费服务商品已下单成功；

2、若自查没有问题，再提交bug工单给高德；

创建工单，附带调查问题所需的关键线索：

测试环境：测试网 or 正式网；
测试设备的pid和vid；
SDK的基本日志；（要在SDK初始化前开启，初始化的日志很重要）
SDK的gnet日志（开启方式：手动创建gnet_stat_a.txt空白文本文件在SDK日志目录下，重新初始化，触发一下功能场景，gnet日志会生成在SDK日志目录/gnet_stats/）
问题时间点和现象描述；
云对云下单的记录（如果有的话）：包括下单时间、订单号、商品id、vid；