七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入

2.x 版本升级说明

温馨提示:由于 2.2.0 及以上版本进行了底层技术重构,若您在升级过程中遇到问题,可先固定版本号为 2.1.3(非重构版本) ,并联系七鱼技术支持进行反馈。

功能调整

2.x 版本在 API 设计上与 1.x 版本一致,部分功能有所调整,请参考以下文档说明

由于 2.x 版本插件在内部做了许多优化升级处理,以下 API 有所调整:

功能名称调整类型相关 API原因说明
视频客服暂不支持/2.x 版本插件暂不支持此功能(除 2.1.3)
文件消息处理废弃_$onFileOpenAction2.x 版本插件内部已处理文件打开事件
历史消息处理废弃_$setHistoryLimit2.x 版本访客历史消息调整为远程同步,不在需要此设置 API

常见问题

1、升级后样式布局错位问题

问题原因:

客户侧 app.wxss 全局样式中存在与插件同名的样式类,进而导致插件样式污染。

涉及版本:

2.0.0、2.0.1

解决方案:

方案一、版本号设置为 2.2.0 及以上版本

方案二、版本号设置为 2.1.3 非重构版本

2、调用插件 API 后,then 中无返回内容

问题原因:

API 不再区分同步或者异步,原异步接口默认 resolve()

解决方案:

以下 API 已调整至同步,原异接口仅返回 resolve()

_$configAppKey
_$setUserInfo
_$setVipLevel
_$configProduct
_$configStaffId
_$configGroupId
_$configShuntId
_$configTitle

这篇文档有帮助吗?

目录