本SDK开发旨在提供方便快捷地获取汽车配件信息，通过VIN码或汽车品牌配置信息进行车辆定型后即可使用圈选或者配件名、OE等形式获取配件信息。
本SDK使用时需要获取正式授权的license文件。商务合作请联系明觉科技，SDK仅提供合作客户使用，违用必究!
| 时间 | 版本 | 更新内容 |
|---|---|---|
| 2018年11月19日 | mjsdk:1.0.19 mjthinkkey:1.0.1 mjspeech:1.0.1 |
1.修复获取TopN无数据的bug 2.添加设备唯一标识UUID 3.规范上传字段 |
| 2018年11月27日 | mjsdk:1.0.29 mjthinkkey:1.0.1 mjspeech:1.0.1 |
1.添加授权自动续约，解决授权到期后需要重新初始化的问题 2.SDK代码深层加密 3.加密网络数据交互（有效防止抓包，修改报文等中间人攻击） 4.初始化更灵活，添加了一种初始化的时候调用license文件的方式 |
| 2018年12月25日 | mjsdk:1.0.30 mjthinkkey:1.0.1 mjspeech:1.0.1 |
1.新增语义解析功能 2.优化圈选定位的准确性 |
| 2019年1月21日 | mjsdk:1.0.30 mjthinkkey:1.0.1 mjspeech:1.0.2 |
1.修改语音单次录入时长为30，静音等待时间调整为5秒 |
| 2019年9月26日 | mjsdk:1.0.50 mjthinkkey:1.0.2 mjspeech:1.0.3 |
1.初始化加入userKey必填字段（用户的唯一标识） 2.优化升级内部调用库(armeabi升级为armeabi-v7a) 3.修复语音识别功能最后一个词不识别的bug |
| 2019年11月27日 | mjsdk:1.0.50 mjthinkkey:1.0.3 mjspeech:1.0.4 |
语音搜索和首字母功能去掉v7:28.0.0,兼容低版本编译 |
在工程build.gradle配置脚本中buildscript和allprojects段中添加【明觉科技SDK】 新maven仓库地址
allprojects {
repositories {
maven {
url 'https://dl.bintray.com/dataenlighten/MJSDK'
}
}
}在项目module build.gradle配置脚本中dependencies添加
android {
...
defaultConfig {
...
ndk {
abiFilters "armeabi-v7a"
}
}
}
dependencies {
...
//SDK依赖
implementation 'com.mingjue.sdk:mjsdk:1.0.50'
implementation 'com.mingjue.sdk:mjthinkkey:1.0.3'
implementation 'com.mingjue.sdk:mjspeech:1.0.4'
} <!-- 网络状态 -->
<uses-permission android:name="android.permission.INTERNET" />
<!--获取网络状态，请求网络前判断是否有网络-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 获取手机录音机使用权限（此权限为敏感权限，请在使用时动态申请），听写、识别、语义理解需要用此权限（不用mjspeech功能可以不加此权限） -->
<uses-permission android:name="android.permission.RECORD_AUDIO" /> /**
* 服务初始化。
*
* @param ctx android 上下文
* @param userKey 用户唯一标识
* @param onSdkInitLisener 初始化回调
* @throws LicenseNotFoundException 未发现license异常
*/
void init(Context ctx,String userKey, OnSdkInitLisener onSdkInitLisener) throws LicenseNotFoundException; /**
* @param ctx android 上下文
* @param userKey 用户唯一标识
* @param licenseContent license文件内容
* @param onSdkInitLisener 初始化回调
*/
void init(Context ctx, String userKey,String licenseContent, OnSdkInitLisener onSdkInitLisener);/**
* VIN解析，返回对应VIN码的车辆信息
* @param vin VIN码
* @param partList 获取常用配件个数（0不获取[默认]，1获取top300，2获取top600，3获取topAll）
* @param queryCallBack 请求回调。
*/
void VINQuery(String vin,int partList, QueryCallBack queryCallBack);详细信息.
/**
* 语义解析，将一段文字转化为 配件带工项的形式
* @param vinCode vin码（大写），没有VIN码时传空字符串
* @param key 要解析的文字信息
* @param queryCallBack
*/
void queryPartAnalysis(String vinCode, String key, QueryCallBack queryCallBack);/**
* 智能推荐接口
* @param params 智能推荐参数（RecommendPartsRequesParams中的selectedPartNameList为null的时候为依照车身部位浏览配件，selectedPartNameList如果有值会根据这些值进行推荐）
* @param queryCallBack
*/
void queryRecommendPartsBySelected(RecommendPartsRequesParams params, QueryCallBack queryCallBack);详细信息.
/**
* 查询关联配件（又名查询相邻配件）
* @param params 关联配件查询参数
* @param queryCallBack
*/
void queryRelatedParts(RelatedPartsRequesParams params, QueryCallBack queryCallBack);详细信息.
/**
* 根据关键字查询配件。
* @param params 关键字查询参数。
* @param queryCallBack
*/
void queryPartsByKey(QueryPartsByKeyRequesParams params, QueryCallBack queryCallBack);详细信息.
/**
* 获取配件EPC装配图
* @param imageName 配件图片名
* @param imagePrefix 车辆图片前缀 ，在VIN定型接口中获取。
* @param queryCallBack
*/
void queryPartEPCImg(String imageName,String imagePrefix, QueryCallBack queryCallBack);详细信息.
第一种方式---直接使用返回的DrawPartView动态填充界面
/**
* 生成圈选小汽车 View
* @param context Android上下文
* @param carInfo 车辆信息。
* @param onDrawQueryListener
* @return DrawPartView 圈选的view
*/
DrawPartView createDrawPartView(Context context,CarInfo carInfo, OnDrawQueryListener onDrawQueryListener);第二种方式---布局xml文件种直接引用DrawPartView，并且设置车辆信息以及回调
//先设置车辆信息
DrawManager.getInstance().init(carInfo);
DrawManager.getInstance().setOnDrawQueryListener（listener）
//再初始化DrawPartView注：turnSurfaceChassis方法为切换全车件和底盘件
drawPartView.turnSurfaceChassis(boolean flag);添加依赖：
implementation 'com.mingjue.sdk:mjspeech:1.0.1'接口定义：
/**
* 语音定损服务。
* @param context android上下文，建议用app的context
* @param touchView 长按说话的view
* @param speechListener 语音回调
*/
SpeechService speechService = SpeechService.getInstance(context);
speechService.init(View touchView, SpeechListener speechListener);/**
* 通过已选配件智能定损
* @param params 定损的参数。
* @param queryCallBack
*/
void estimateByParts(EstimateByPartsRequestParams params, QueryCallBack queryCallBack);参数说明：
/**
* 智能定损接口参数
*/
public class EstimateByPartsRequestParams {
/** 车辆信息*/
private CarInfo carInfo = null;
/** 修理厂id*/
private String repairer = null;
/** 维修类型 如"送修" */
private String repairType = null;
/** 保险公司id*/
private String insurer = null;
/** 选择的配件工项信息列表 */
private List<DamageInfo> damageInfoList = null;
}public class DamageInfo {
/** 配件选择的工项 */
private String operation = null;
/** 配件Id */
private String partId = null;
/** 配件标准名称 */
private String standardPartName = null;
/** 配件损伤程度 */
private String severity = null;
/** 配件价格 */
private String partPrice = null;
/** 工时价格 */
private String laborCost = null;
}添加依赖：
implementation 'com.mingjue.sdk:mjthinkkey:1.0.1'接口定义：
/**
* 首字母关联配件名
* @param input 用户输入的首字母串
* @param names VIN定型里面返回的top1000 配件名称数组
* @param callBack 查询回调
*/
void queryThinkedKeys(String input, String[] names, QueryThinKedKeysCallback callBack)接口调用：
MJInitialService.getInstance().queryThinkedKeys(input,names,queryThinKedKeysCallback） #-libraryjars libs/okhttp3
-dontwarn okhttp3.**
-keep class okhttp3.** { *; }
#-libraryjars libs/okio
-dontwarn okio.**
-keep class okio.** { *; }| 错误码 | 描述 |
|---|---|
| 0000 | 成功 |
| 1001 | VIN不合法 |
| 1002 | VIN不支持 |
| 1003 | 非乘用车 |
| 1004 | VIN错误 |
| 1005 | VIN无法解析 |
| 1006 | 无权查看该品牌数据 |
| 1011 | 请求VIN的配件数据不存在 |
| 1012 | 该车无此配件 |
| 1013 | 请求图片不存在 |
| 1014 | 推荐配件数据不存在 |
| 1015 | 该车型查不到配件 |
| 9007 | 后台API异常 |
| 8000002 | 系统验证：成功退出系统！ |
| 0000 | 系统验证：成功刷新访问票据！ |
| 8000004 | 系统验证: 账号不存在或无权限! |
| 8000005 | 系统验证：需要进一步鉴权. |
| 9999999 | 其他错误，请联系技术支持！ |
| 9000001 | 系统验证：请求参数不完整或者有错误！ |
| 9002 | 系统验证：访问票据非法或已过期！ |
| 9000004 | 系统验证：权限不足，无权访问该产品. |
| 9000005 | 系统验证：权限不足，无权访问该资源. |
| 9006 | 系统验证：认证失败！ |
| 9000007 | 系统验证：请求验证码过于频繁 请稍后重试. |
| 9000008 | 系统验证：访问过于频繁 请稍后重试. |
| 9000009 | 系统验证：权限不足. |
| 9000010 | 服务响应超时 请稍后重试. |
| 9000011 | 请输入用户组名称 |
| 9000012 | 外键错误 |
| 9000013 | 手机号码格式错误 |
| 9000014 | 列名部分有问题，请再次确认 |
| 9000015 | 手机号已注册 |
| 9000024 | 用户不存在 |
| 9000016 | 用户名已注册 |
| 9000017 | 分组已存在 |
| 9000018 | 分组公司关系已存在 |
| 9000019 | 请输入分组ID |
| 9000020 | 请选择分组 |
| 9000021 | 请选择公司 |
| 9000022 | 组织信息未填写，请确认 |
| 9005 | 服务器升级中! |