{"version":"0.1.0","code":"0000","result":true,"message":"处理成功","errdetail":"","timestamp":1671518303503,"data":{"id":71712323,"title":"SDK license激活","slug":"wcy7ll","format":"lake","bookId":26046811,"body":null,"body_draft":null,"body_html":"

1 功能概述

激活是向BL SDK的使用者赋予软件的使用权限，保证SDK只能在被授权的设备上进行使用。在商业合作模式上针对设备收取license费用时，SDK需要激活后才能使用。

SDK激活的前提：需要先提供设备id购买指定设备的激活许可。

2 如何下单购买激活许可？

方式1：商务邮件人工下单。客户提供设备的设备号清单给到高德商务（下单），高德接到订单后生成序列号和激活码，客户就可以在对应的设备上激活。商务同学通过客户下单的数量进行结算。
方式2：云对云下单购买。车厂订单后台对接高德订单后台，基于高德提供的《云对云下单接口文档》的规范下单购买（下单接口关键传参：安全校验码、商品id、设备id清单）。下单后，可以通过订单查询接口获取订单的生产结果（成功/失败，以及激活码信息）。订单生产成功后，就可以通过下文介绍的SDK激活接口完成激活。

SDK采用一次性激活，正式激活成功后，升级软件版本或地图数据，只要保障激活文件保存路径的备份文件不丢失，sdk就无需再次激活。

3 激活方式介绍

批量激活：高德向某车厂客户提供auto相关产品，车厂需要对1000台汽车进行装车并激活。车厂对接人向高德商务同学进行下单，将1000台车的设备ID导入。高德激活平台生成了1000个设备ID对应的激活文件，交付客户。客户将激活文件放到约定好的每台车机目录下后，启动时激活模块会自动读取激活文件，完成激活。即可分别完成1000个设备的激活。
网络激活：某车厂觉得使用批量激活方式太麻烦，可以让客户端通过网络激活完成激活验证，省去灌装激活文件的流程。车厂对接人向高德商务下单后，高德激活后台会存储对应设备ID的序列号和激活码，在对应前端来请求时下发，完成激活。
手动激活：批量激活失败后，客户端可以弹出用户手动输入的界面，完成手动激活。（一般作为上述2种激活方式的补充方案）

4 激活流程描述

如下图描述了客户端激活流程。其中批量激活BatchActivate接口有两个功能。

1，判断传入的路径是否有value.dat文件，确认是否已经激活。

2，如果未激活，会寻找同路径下激活的csv文件，进行批量激活

特别说明1：

若未调用IServiceMgr::InitBaseLibs接口的情况下，调用IActivationModule::NetActivate网络激活接口请求网络会失败。

（InitBaseLibs接口，参考文档，二、入门指南中的3.5.3初始化）

特别说明2：

激活失败就进入地图，异常表现：

1）未激活情况下，在线请求地图图块数据，在线算路等所有网络请求都被禁止

（除网络激活接口IActivationModule::NetActivate外）

2）未激活情况下，若本地也无离线地图数据情况下，地图显示空白（黑屏），算路、巡航、失败,

模拟导航、真实导航等所有服务都异常；

3）未激活情况下，若是存在离线地图数据，地图可以显示，也可离线巡航、离线算路、

离线导航

5 对应技术模块文档

详细接口和开发指南，查阅：

激活服务初始化

3种激活场景

","body_lake":null,"pub_level":null,"status":"0","updated_at":"2022-06-29 09:03:31","deleted_at":null,"nameSpace":"mnlcaa/v610","browseCount":193,"collectCount":5,"estimateDate":3,"docStatus":0,"permissions":true,"overView":false}}