接口适配 - 好签SDKO接口文档

针对OEM客户，好签sdko 添加了如下接口满足客户需求 ## 初始化OEM授权接口须在app冷启动时，调用授权方法，确保授权通过后，才可调用好签SDK 的API。请确保调用一次，以免造成不必要资源浪费。 **代码示例：** ``` ReturnResult returnResult =WSAuthManager.initOfflineOEMAuth(mContext,clientId,key); ``` **接口参数说明：** - clientId 类型：String 说明：OEM授权clientId,向服务提供商获取 - key 类型：String 说明：授权key **返回值说明：** - ReturnResult 参数：returnCode 类型：int 说明：授权结果码,详细参照下表参数：returnMessage 类型：授权信息说明：结果码和结果信息 returnCode详细信息如下 |Code值 |类型 |定义| |-|-|-| |0 |int| 初始化成功| |-1 |int| 授权信息为空或授权日期错误| |-2 |int| 模块名称错误| |-3 |int| 用户名错误| |-4 |int| 包名校验错误| |-5 |int| 解析数据错误| |-6 |int| OEM授权码错误| |-7 |int| APP名校验错误| |-8 |int| 设备平台不符| ## 设置签字人信息设置签字人身份后，系统自动将签名对象和身份进行绑定，并最终写入PDF文件中，用于验签信息显示。 **代码示例：** ``` WellSign.setHqSignerInfo(userId,userName,signDesc); ``` **接口参数说明：** - userId 类型：String 说明：当前用户ID(调用者系统内部用户唯一识别码) - userName 类型：String 说明：签字人名称，会在验签卡片中显示，建议写业务系统中用户名称 - signDesc 类型：String 说明：附加信息，不会在验签卡片信息中显示 ## 打开本地离线文件在用户界面，引入WSPDFView 控件（详细代码及布局文件可参照好签demo）打开本地离线文件。 **代码示例：** ``` mPdfView.openOfflineFile(localFilePath,pdfPassword pageViewMode, new OpenFileCallBack() { @Override public void result(boolean success, int error) { Log.e("SDKO","打开文件结果"+success+":"+error); //do something } }); ``` **接口参数说明：** - localFilePath 类型：String 说明：本地文件路径，确保文件路径正确，以及存在。 - pdfPassword 类型：String 说明：pdf文件密码，无密码传 "" 。 - pageViewMode 类型：int 说明：阅读文件时的翻页方式，目前支持两种翻页方式； **WSPublicConst.CONTINUOUS_PAGE**：垂直连续翻页（推荐） **WSPublicConst.SINGLE_PAGE**：单页左右翻页 - openFileCallBack 类型：OpenFileCallBack 说明：回调函数，返回打开文件结果 **回调说明：** - success 类型：boolean 说明：打开文件是否正常 - error 类型：int 说明：错误码 ## 保存文件将签字数据保存固化到对应pdf文件由于该接口是异步耗时操作，请自行添加进度条等遮罩直到回调返回。 **代码示例：** ``` mPdfView.solidFile(new WSProgressCallBack() { @Override public void onProgress(int progress) { } @Override public void result(boolean success, WSResult result) { Log.e("SDKO","固化结果："+success); if(!success){ return; } //do something } }); ``` **接口参数说明：** - WSProgressCallBack 类型：WSProgressCallBack 说明：回调函数，返回提交执行结果 **回调说明：** - onProgress 参数：progress 类型：int 说明：进度值，范围1~100 - result 参数：success 类型：boolean 说明：执行结果参数：result 类型：[WSResult](doc:cH4YGgz7) 说明：结果码和结果信息 ## 追加空白页在当前打开的pdf原文件末尾添加A4大小的空白页 **代码示例：** ``` mPdfView.appendPage(); ``` **接口参数说明：** -无