调用说明
### 版本介绍
- V2.7.0是好签SDKO之前经常使用的JSAPI,24年10月之前所有的用户都使用的此版本。
- V4.0.0是**2024年10月中旬**刚发布的新版JSAPI,所以需注意如果你的项目是24年10月之前部署的,则无法使用V4.0.0,需要更新好签服务后才可以使用。
### 新版V4.0.0有哪些新的改变
- **页面布局支持从好签控制台直接通过拖拽的方式实现自定义布局**
- 以往如果不想使用好签默认的UI布局,只能通过代码开发的方式实现修改布局,这种方式接入开发成本较高
- 举例说明:以前假如好签的签字功能,不想使用文本这个功能,那个需要自己重写整个底部的 bar
- 现在只需要在控制台自定义布局中将文本隐藏即可。![image.png](https://cos.easydoc.net/74177308/files/m24721lv.png)
- **配置参数支持从好签控制台直接修改**
- 以往同样需要进行代码层面配置,现在直接从控制台修改即可
- 举例说明:以前如果需求修改圈批笔的粗细,需要从代码层面 ctx.signboard.setSize(5) 如此设置;
- 现在只需要在好签控制台直接填修改即可。![image.png](https://cos.easydoc.net/74177308/files/m246y4d5.png)
- **功能层面的更新**
- 注释功能全面升级,支持书写、文本、各种常用图形等,且与 Adobe Acrobat、WPS等软件互通,可以看到在那些软件上看到使用好签签批的注释内容
- 圈批功能升级,圈批的笔迹支持手动拖拽移动,放大缩小等操作。
- 文本功能支持使用字体,系统默认集成四种字体,也可以后台上传自定义字体
#### 常见问题说明
- **更新新版后,是不是只能使用V4.0.0,之前的V2.7.0就不能再使用了?**
- 更新后之前接入的V2.7.0 不受影响,可继续使用。同时也可以继续接入使用 V4.0.0
- **更新新版后,如何将之前的V2.7.0升级成 V4.0.0的 JSAPI?**
- 方式1:代码修改,移动端 将之前引入 JSAPI 时的 `WSLoader.loadMobile` 更新为 `WSLoader.loadV4Mobile`,
PC端将 `WSLoader.loadPC` 更新为 `WSLoader.loadV4PC`。这样就走 V4.0.0 的 JSAPI了。
- 方式 2:直接在好签控制台修改。此种方式修改后,无需修改任何前端代码,页面将直接切换成 V4.0.0的 JSAPI 布局。所以此种方式切建议不要直接在生产环境使用,先在测试环境验证调试没问题后再上生产。![image.png](https://cos.easydoc.net/74177308/files/m24cj1gq.png)
- **更新新版后,如果配置参数既使用了 V2.7.0代码方式的接入,也同时在好签控制台相应的修改了,优先已哪个为准?**
- 优先已代码配置为准,然后再取控制台设置的。
- **V4.0.0是不是就不支持自定义页面布局了?**
- 目前V4.0.0 已经通过好签控制台支持绝大部分的自定义布局的需求,如仍然不满足,可继续沿用 V2.7.0 的自定义布局方式。
- 如想要自定义写 保存 按钮,可以通过好签控制台把好签默认布局中的 保存 按钮隐藏,然后沿用 V2.7.0的方式实现自定义布局。