打开文件相关
## 服务端文件
在用户界面,引入WSPDFView 控件(详细代码及布局文件可参照好签demo)打开文件,该方法会将服务端文件下载到本地,并拉取文件对应签字数据。由于该接口是异步耗时操作,请自行添加进度条等遮罩。
**PS:旧版activity控件已经停止使用,替代使用轻量灵活的view型控件**
**代码示例:**
```
mPdfView.openFile(fileId,buildNo,
readType,
fromSourceFile,signTogether,
new WSProgressCallBack() {
@Override
public void onProgress(int progress) {
Log.e("SDK","打开文件progress:"+progress);
//do something
}
@Override
public void result(boolean success, WSResult result) {
Log.e("SDK",success+":"+result.getMessage());
//do something
}
});
```
**接口参数说明:**
- fileId
类型:String
说明:后台服务器上已注册文件返回的唯一id
- buildNo
类型:int
说明:根据buildNo,获取对应的签字数据,可以使用WSPublicConst.LAST_NEW_BUILD_NO,获取最新的签字数据
- readType
类型:int
说明:阅读文件时的翻页方式,目前SDK支持两种翻页方式;
**WSPublicConst.CONTINUOUS_PAGE**:垂直连续翻页
**WSPublicConst.SINGLE_PAGE**:水平单页翻页
- fromSourceFile
类型:boolean
说明:是否从初试注册文件打开文件,一般为false
**false**:从最近更新的文件打开
**true**:从初试文件打开
- signTogether
类型:boolean
说明:是否以会签模式打开文件,一般为false
- WSProgressCallBack
类型:WSProgressCallBack
说明:回调函数,返回打开文件结果,以及打开进度
## 本地文件
打开本地文件,调用该接口,会将本地文件上传并注册到好签服务端(如果后面还需要打开该文件,请使用**服务端文件**接口,否则仍调用本接口会产生一条全新的文件记录),由于该接口是异步耗时操作,请自行添加进度条等遮罩。
**代码示例:**
```
mPdfView.openLocalFile(localFilePath,
readType,
fromSourceFile,
signTogether,
new WSProgressCallBack() {
@Override
public void onProgress(int progress) {
Log.e("SDK","打开文件progress:"+progress);
//do something
}
@Override
public void result(boolean success, WSResult result) {
Log.e("SDK",success+":"+result.getMessage());
//do something
}
});
```
**接口参数说明:**
- localFilePath
类型:String
说明:本地文件路径(具备读写权限)
- readType
类型:int
说明:阅读文件时的翻页方式,目前SDK支持两种翻页方式;
**WSPublicConst.CONTINUOUS_PAGE**:垂直连续翻页
**WSPublicConst.SINGLE_PAGE**:水平单页翻页
- fromSourceFile
类型:boolean
说明:是否从初试注册文件打开文件,一般为false
**false**:从最近更新的文件打开
**true**:从初试文件打开
- signTogether
类型:boolean
说明:是否以会签模式打开文件,一般为false
- WSProgressCallBack
类型:WSProgressCallBack
说明:回调函数,返回打开文件结果,以及打开进度
(WSResult的data为该文件在服务器文件id)
## 其他
### 设置签字人信息
在加载或保存签字数据时,需要提前设置调用者信息(便于验签等数据查看)
**代码示例:**
```
WellSign.setHqSignerInfo(userName,signDesc);
```
**接口参数说明:**
- userName
类型:String
说明:签字人名称
- signDesc
类型:String
说明:签字人本次操作的描述