Latest 1.3.1
Homepage https://github.com/w1090485608/MJAiSearchSDK
License MIT
Platforms ios 9.0
Authors

Version
Platform

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Installation

MJAiSearchSDK is available through CocoaPods. To install
it, simply add the following line to your Podfile:

platform:ios, '9.0'  # 仅支持iOS9.0及以上设备
target 'TargetName' do
pod 'MJAiSearchSDK'
end

如果搜索不到,请运行pod repo update --verbose更新cocoapods仓库。

更新描述


V1.3.1 移除GTMBase64依赖

V1.2.8 新增一言为定功能,便于在无vin的情况下快速将江湖名转换为明觉标准名

V1.2.3 在圈选区域偏小或者没有圈到车体时添加代理,修复其他bug

V1.2.1 可以自定义圈选线条颜色,优化圈选页面

V1.2.0 移除对Masonry的依赖,进一步缩小SDK体积,修复圈选bug

V1.1.9 移除依赖 更容易集成

V1.1.8 修复bug

V1.1.5 更新内容

1.可以自定义设置license位置
示例:

[[NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:@"MJResources" ofType:@"bundle"]]URLForResource:@"mj_license" withExtension:@"lic"]

2.可以自定义圈选页面的小汽车图片和小汽车上下位置的offset值
3.修复bug

V1.1.4 更新内容

移除圈选页面的切换车体按钮和文字label

教程


SDK简述

本SDK开发旨在提供方便快捷地获取汽车配件信息,通过VIN码或汽车品牌配置信息进行车辆定型后即可使用圈选或者配件名、OE等形式获取配件信息。

本SDK使用时需要获取license。商务合作请联系明觉科技,SDK仅提供合作客户使用,违用必究!


SDK分类

为方便用户使用SDK,根据自身需求选用功能模块,我们将其拆分成五大模块:

  1. MJVinParseLib.framework — VIN定型服务模块,提供VIN定型相关功能,原则上推荐所有用户选用。
  2. MJAreaSearchPartLib.framework — 圈选小汽车得到相应区域配件信息,推荐所有用户使用。
  3. MJSearchPartLib.framework — 配件搜索服务模块,提供配件名、配件OE搜索配件,推荐所有用户使用。
  4. MJSearchEPCPartLib.framework — EPC图选服务模块,提供查询周围配件功能。
  5. MJOrderServiceLib.framework — 定损推荐服务,提供定损工时和推荐工时服务。
  6. MJDataLib.framework — 基础通讯模块,原则上必须接入。

SDK集成步骤

  1. 使用cocoapods集成SDK
  2. 初始化SDK。userinfo格式请参考Demo工程。
[[MJDamageAssessmentManager sharedInstance] configureWithUserInfo:userInfo complete:^(BOOL success) {}];
  1. 愉快使用SDK其他功能。

SDK模块介绍

一、MJVinParseLib.framework — VIN定型服务

1.VIN定型接口,传入合法的VIN码,返回VIN解析结果。

+ (void)vinParseWithVinCode:(nonnull NSString *)vinCode completion:(_Nullable ServiceResponseBlock)completion;

2.检查VIN前三位,传入VIN前三位,快速得知是否可以解析

+ (void)checkVINTop3:(nonnull NSString*)vintop3 completion:(_Nullable
ServiceResponseBlock)completion;

3.获得授权可查询品牌列表

+ (void)getMyAuthBrandsCompletion:(_Nullable ServiceResponseBlock)completion;

4 . 获得PlanB数据- VIN无法定型时使用,传入上个接口中获得的可查询品牌。

+ (void)getPlanBBrandsWithBrand:(nonnull NSString*)brand completion:(_Nullable ServiceResponseBlock)completion;

5. 根据车辆品牌,制造商以及车型获取车辆的排量以及变速箱等信息

@param brand 车辆品牌 -从+ (void)getPlanBBrandsWithBrand:(nonnull NSString*)brand completion:(_Nullable ServiceResponseBlock)completion;接口中获取到的数据
@param maker 制造商 -从+ (void)getPlanBBrandsWithBrand:(nonnull NSString*)brand completion:(_Nullable ServiceResponseBlock)completion;接口中获取到的数据
@param vehicleChn 车型 -从+ (void)getPlanBBrandsWithBrand:(nonnull NSString*)brand completion:(_Nullable ServiceResponseBlock)completion;接口中获取到的数据
@param body 车体 -从+ (void)getPlanBBrandsWithBrand:(nonnull NSString*)brand completion:(_Nullable ServiceResponseBlock)completion;接口中获取到的数据
@param completion 返回数据
*/
+ (void)getPlanBBrandDetailWithBrand:(nonnull NSString*)brand maker:(nonnull NSString*)maker vehicleChn:(nonnull NSString*)vehicleChn body:(nonnull NSString*)body completion:(ServiceResponseBlock)completion;

6. OCR服务 识别行驶证(暂不提供服务)

+ (void)ocrServiceWithImage:(nonnull UIImage*)image completion:(_Nullable ServiceResponseBlock)completion;

二、MJAreaSearchPartLib.framework — 圈选配件服务

圈选配件服务使用方法

 MJDrawCircleSearchPartController* draw = [[MJDrawCircleSearchPartController alloc]initWithCanvasFrame:CGRectMake(0, 94, 240, 400)];
draw.delegate = self;
[self addChildViewController:draw]; 
[self.view addSubview:draw.view];
[draw didMoveToParentViewController:self];

上面方法将MJDrawCircleSearchPartController中的view添加到您自己的viewcontroller中,方便使用,在添加代理之后,圈选得到的配件会在代理方法中返回,代理方法如下:

- (void)canvasCircleSelectedPartsCompletion:(NSArray<MJPart *> *)parts;

当然,我们在请求开始以及结束的时候也提供了代理方法:

/**
圈选之后开始请求
*/
- (void)canvasCircleRequestStart;
 /**
圈选请求结束
*/
- (void)canvasCircleRequestEnd;

在需要查询底盘件的时候我们还提供了切换车体的方法,其中mode有两个值:
MJDrawModeBody //车身件
MJDrawModeChassis //底盘件
方法如下:

- (void)switchDrawSearchModeWithMode:(MJDrawMode)mode;

三、MJSearchPartLib.framework — 配件搜索服务

配件搜索服务提供以下方法:

1.首字母联想-传入需要联想的字符串(可以是英文可以是中文),即刻返回明觉标准配件名列表。

+ (void)firstLetterRecommendWithText:(nonnull NSString*)text completion:(_Nullable ServiceResponseBlock)completion;

2.搜索配件接口-传入需要搜索的关键字:可以是配件名也可以是OE号,可以是多个配件名加上工项(更换,维修,喷漆,钣金,拆装。。。)以及搜索渠道(语音,手动输入,首字母)即可搜索配件。

该接口提供语义定损服务,返回数据不仅包含配件数据,也将包含用户输入的语义工项
返回的数据是MJPart的对象

+ (void)searchPartWithKey:(nonnull NSString*)key query:(MJSearchQurey)query completion:(_Nullable ServiceResponseBlock)completion;
示例
    [MJSearchPartService searchPartWithKey:@"换前保险杠皮拆左前大灯壳右前大灯维修前盖更换发动机" query:(MJSearchQureyManuel) completion:^(id  _Nullable response, BOOL success, NSError * _Nullable error) {

    }];

3.二次推荐配件-每次搜索最多提供7个配件信息,当用户需要更多配件时,推荐调用此方法获得更多配件推荐。

该方法提供二次推荐:上拉加载更多配件

+ (void)researchPartCompletion:(_Nullable ServiceResponseBlock)completion;

3.1. 精准二次推荐配件 – 传入用户已选的配件来获取更加精准的二次推荐配件。

该方法提供二次推荐:上拉加载更多配件

+ (void)researchPartWithSelectedParts:( NSArray<MJPart *> * _Nullable )parts Completion:(_Nullable ServiceResponseBlock)completion;

4.获取配件图片

+ (void)requestImageWithImageName:(nonnull NSString *)imageName
completion:(_Nullable ServiceResponseBlock)completion;

4.1.根据MJPart获取配件图片

+ (void)requestImageWithPart:(nonnull MJPart*)part completion:(_Nullable ServiceResponseBlock)completion;

5.获取EPC图片

+ (void)requestImageWithImageName:(nonnull NSString *)imageName imagepath:(nonnull NSString *)imagepath
completion:(_Nullable ServiceResponseBlock)completion;

5.1.根据MJPart获取EPC图片

+ (void)requestEpcImageWithPart:(nonnull MJPart*)part
                       completion:(_Nullable ServiceResponseBlock)completion;

6.一言为定语义解析功能

根据传入的关键字key进行语义解析,返回明觉标准名,以及维修工项

+ (void)partAnalysisWithKey:(nonnull NSString*)key completion:(_Nullable ServiceResponseBlock)completion;

四、MJSearchEPCPartLib.framework — 周围配件搜索服务

1.根据OE号 EPC图片名和图片路径查询相邻配件:

+ (void)searchRelatedPartsWithImageName:(nonnull NSString *)imageName imagepath: (nonnull NSString *)imagePath oeNumber:(nonnull NSString *)oeNumber completion: (_Nullable ServiceResponseBlock)completion;

1.1.根据MJPart查询相邻配件

+ (void)searchRelatedPartsWithPart:(nonnull MJPart *)part
                             completion:(_Nullable ServiceResponseBlock)completion;

五、MJOrderServiceLib.framework — 定损服务

1.提供定损接口,传入用户已选择的配件信息,返回相应的估价单,其中包含配件的工项价格和配件关联关系

+ (void)assessmentWithParts:(nonnull NSArray *)parts  completion: (_Nullable ServiceResponseBlock)completion;

注意事项:
传入的MJPart需要设定工项为YES:

字段 描述
replaceStatus 更换状态,是否更换
paintStatus 喷漆状态,是否喷漆
fitStatus 拆卸状态,是否拆卸
panelStatus 维修状态,是否维修,注意维修状态需要同时设置damageDegree,可选值为:轻度、中度、重度 ,默认中度
auxiliaryStatus 维修状态,是否辅料
outRepairStatus 维修状态,是否外修
electroMechanicalStatus 维修状态,是否机电
accessoryStatus 拆装附件状态,是否拆装附件
返回为字典数组

其中estimateChooseList为已选配件的工时工项信息,estimateOtherList为推荐的工项工时信息,字典详细解释如下

key 解释
chooseList 已选工项
deleteList 推荐剔除工项
partId 配件ID
partName 配件名称
recommendList 推荐选择工项
labor 工时金额
option 工项

错误码介绍

ErrorCode ErrorDesc
9001 警告!非法请求!
50001 请先进行VIN定型
50002 VIN码错误
50003 请填入正确的搜索渠道
50004 OE号错误
50005 图片名错误
50006 请至少先进行圈选或者搜索
50009 请求出错
50010 没有配件
90001 传入非法的MJPart

Author

袁兴杨, [email protected]

Latest podspec

{
    "name": "MJAiSearchSDK",
    "version": "1.3.1",
    "summary": "u660eu89c9u7231u67e5u8be2SDK",
    "description": "TODO: u79fbu9664u5708u9009u9875u9762u7684u5207u6362u8f66u4f53u6309u94aeu548cu6587u5b57.",
    "homepage": "https://github.com/w1090485608/MJAiSearchSDK",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "u8881u5174u6768": "[email protected]"
    },
    "source": {
        "git": "https://github.com/w1090485608/MJAiSearchSDK.git",
        "tag": "1.3.1"
    },
    "platforms": {
        "ios": "9.0"
    },
    "resources": "MJResources.bundle",
    "ios": {
        "vendored_frameworks": [
            "MJDataLib.framework",
            "MJVinParseLib.framework",
            "MJAreaSearchPartLib.framework",
            "MJSearchPartLib.framework",
            "MJSearchEPCPartLib.framework",
            "MJOrderServiceLib.framework"
        ]
    },
    "libraries": "stdc++"
}

Pin It on Pinterest

Share This