sidebar_position: 1

IOS

1 需要提供给我们的信息

应用id IOS Bundle ID ， 例如 com.example.test

2 SDK接入

framework中包含动态库，集成到项目中时请选择 < Embed&Sign >

3 代码编写

初始化SDK

//引入 JuDianOpenApi.framework
#import <JuDianOpenApi/JuDianOpenApi.h>
初始化sdk
[JuDianOpenApi initWithToken:Token];

建议在AppDelegate中引入 必须在查词前完成注册激活
Token：查词平台后台注册成功后给到的token，与bundle id对应，如果提示错误，请检查项目bundle id与token是否对应

调用查词方法一

查询词条，并在指定位置绘制结果视图 结果根据库查询返回

参数 
@param text :查询的字词 
@param direction ：页面绘制方向  
@param origin ：页面绘制起点 
@param Width ：绘制页面的宽度 
@param Height ：绘制页面的最大高度
[JuDianOpenApi showExplainViewWithWord:text direction:direction origin:origin viewWidth:Width maxHeight:300];

调用查词方法二

查询词条，返回结果数据，可以指定需要查询的类库

参数: 
@param text :查询的词组 
@param fields :查询时指定的类库，不传或为空时，默认搜索配置的所有库 
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi getExplainWithWord: text  fields:fields successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

success response:{
    code:200
    body:{
        font:{}//字体信息
        data:{}//词条数据
    }
}
failure response :{
    code:Integer //返回错误码
    body:{
        stauts:Integer //返回的错误码，为0时返回JuDianErrorInteger，具体错误可在SDK中进行查看
        detail:String //错误描述信息
    }
}

例如 语词库: yuci 百科库:baike 诗词库:shici 如果只查询百科 则传@[@"baike"] 同时查询语词与百科 则传@[@"baike",@"yuci"] 具体对应库名可以通过getAuthList 接口在app内获取，或在管理后台界面获取

查询词条，返回结果数据中包含的字体数据，可以使用一下方法注册使用

font:
{
    fontName = 字体包FontName;
    ttf = 字体包 .ttf下载地址;
    woff = 字体包 .woff 下载地址;
}

CFErrorRef error;

CGDataProviderRef fontDataProvider = CGDataProviderCreateWithURL((__bridge CFURLRef)fontUrl);
CGFontRef fontRef = CGFontCreateWithDataProvider(fontDataProvider);
CGDataProviderRelease(fontDataProvider);
bool isSuccess = CTFontManagerRegisterGraphicsFont(fontRef, &error);
if(!isSuccess){
    //如果注册失败，则不使用
    CFStringRef errorDescription = CFErrorCopyDescription(error);
    NSLog(@"Failed to load font: %@", errorDescription);
    CFRelease(errorDescription);
}
CGFontRelease(fontRef);

UIFont * font = [UIFont fontWithName:fontName size:size];

获取配置的可查询书籍列表与数据库

@param success 查询成功并返回结果
@param failure :查询失败返回错误信息
[JuDianOpenApi getAuthListSuccessBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

success response:{
    code:200
    body:{
        books:{}//返回的书籍数组
        fields:{}//返回的数据库数组
    }
}
failure response :{
    code:Integer //返回错误码
    body:{
        stauts:Integer //返回的错误码，为0时返回JuDianErrorInteger，具体错误可在SDK中进行查看
        detail:String //错误描述信息
    }
}

查询词条，返回结果数据，可以指定需要查询的书本id数组

参数: 
@param text :查询的词组 
@param books :指定的书籍id 不传或为空时，默认搜索所有书籍数据
@param isFast :ture为快速检索，no为普通查询，快速检索时仅返回第一条匹配数据，普通查询时返回查询到的所有数据
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi getExplainWithWord: text  books:books successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

例如 现代汉语大词典 id:40 辞海(第7版) id:98 如果只查询辞海 books:@[@"98"] 同时查询辞海与汉语大词典books:@[@"40",@"98"]或@[@40,@98]

获取单字信息

@param word 查询的单字
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi getStrokeOrderForWord:text successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

获取定性语信息,返回词条是否包含历史纪年、古今地名、中译英、英译中

@param word 查询的单字
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi cheackWordContainer:text successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

获取历史纪年

@param word 查询的字词
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息
  [JuDianOpenApi getHistoricalYearWithWord:text successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

获取古今地名

@param word 查询的字词
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi getAncientPlaceWithWord:text successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

英译中

@param word 查询的字词
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息

[JuDianOpenApi getEnglishExplainWithWord:text successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

汉译英

@param word 查询的字词
@param success :查询成功并返回结果
@param failure :查询失败返回错误信息
[JuDianOpenApi getChineseToEnglishWithWordtext successBlock:(void(^)(NSDictionary * response))success failureBlock:(void(^)(NSDictionary * response))failure];

错误码说明

SDK返回错误

错误信息已请求返回的code和detail信息为主，下列的为当code = 0时，主要异常信息

typedef NS_ENUM(NSInteger, JuDianError) { //网络请求异常，code = 0时，status返回下列错误枚举
    JuDianErrorRequestTimeOut       =   -1001,  //请求超时
    JuDianErrorNetworkOffline       =   -1002,  //网络已断开,请检查本地网络连接
    JuDianErrorCertificateInvalid   =   -1003,  //证书异常,请检查本机系统时间
    JuDianErrorUndefined            =   -1009,  //暂时未定位问题,请稍后再试,有问题请联系:https://judian.jdapi.com
};

服务器返回错误

服务器返回40X错误