开发指南

# 更新说明

V9.0.1 (2024-02-19)

修改

  1. 优化麦克风权限的获取时机。
  2. 优化LBS上传的Key，与云信进行区分。

V9.0.0 (2024-01-31)

新增

  1. 新增融合模式支持离线推送。

修改

  1. 优化敏感词功能。

V8.12.1 (2024-01-16)

新增

  1. 新增访客端灵活配置1.0之标题栏配置。

V8.12.0 (2023-12-28)

新增

  1. 新增机器人埋点。

修改

  1. 适配Android14广播机制。
  2. 优化图片和视频存储。

V8.11.1 (2023-12-07)

修改

  1. 移除androidx.legacy:legacy-support-v4库。
  2. 移除org.slf4j:slf4j-api和com.github.tony19:logback-android库。
  3. 优化日志库。

V8.11.0 (2023-11-30)

修改

  1. 优化海外版本网络流向合规问题。
  2. 优化已知问题。

V8.10.1 (2023-11-10)

修改

  1. 优化再次评价的问题。
  2. 优化大图展示不清晰的问题。

V8.10.0 (2023-11-01)

修改

  1. 优化留言状态下，客服头像的显示问题。
  2. 优化大图展示不清晰的问题。
  3. 优化存储代码。

V8.9.0 (2023-09-27)

修改

  1. 修复留言表单字段标题最多展示4个字符的问题。
  2. 修复自定义评价无法点击的问题。
  3. 修复常见问题分类最多展示10条的问题。
  4. 优化消息流查看大图耗时的问题。

V8.8.0 (2023-09-07)

新增

  1. 新增留言表单支持时间控件。
  2. 新增创建工单和工单补充信息支持上传自定义附件。
  3. 新增清空本地CRM信息的方法。

修改

  1. 修复可以拉取到隐藏的商品卡片的问题。
  2. 修复在小米手机部分机型上遇到图片超过100m时闪退的问题。
  3. 修复云信数据库打开失败报错的问题。
  4. 修复七鱼demo,创建权限弹框时，Activity的token为null的问题。

V8.7.0 (2023-08-11)

新增

  1. 新增机器人回复超长消息折叠, UICustomization.isRobotMessageFold设置为true生效。
  2. 新增工单筛选功能。
  3. 新增工单详情补充信息。

修改

  1. 修复平台企业客服头像展示错乱的问题。

V8.6.2 (2023-07-31)

修改

  1. 修复横竖屏切换后，多语言配置失效的问题。

V8.6.1 (2023-07-18)

修改

  1. 优化MIUI系统自启动的问题。
  2. 优化机器人阶段横滑卡片UI的展示问题。
  3. 优化语音转文字界面，无法返回的问题。
  4. 优化设置键盘不可用，不请求客服时无法输入的问题。

V8.6.0 (2023-07-13)

新增

  1. 新增询前表单支持关闭功能。
  2. 新增进入聊天界面时键盘不可用设置。
  3. 新增评价次数限制。

V8.5.1 (2023-07-10)

修改

  1. WRITE_EXTERNAL_STORAGE去掉maxSdkVersion="29"配置。

V8.5.0 (2023-06-30)

新增

  1. 新增支持葡萄牙语和西班牙语。

修改

  1. 优化存储权限管理，WRITE_EXTERNAL_STORAGE增加maxSdkVersion="29"配置。
  2. 适配Android 13手机，相册没有图片的问题。

V8.4.0 (2023-05-11)

新增

  1. 支持会话关闭时弹出满意度评价。

修改

  1. 解决广播静态代码注册不合规的问题。
  2. 优化一触即达UI展示效果。
  3. 解决留言不展示企业头像的问题。

V8.3.1 (2023-04-19)

新增

  1. 新增支持再次邀请评价。

修改

  1. 优化未读消息交互体验。
  2. 优化评价标签显示不全的问题。

V8.3.0 (2023-03-31)

新增

  1. 新增支持客服名称。
  2. 新增常见问题支持分类。

修改

  1. 优化漫游消息下商品卡片UI展示的问题。
  2. 优化海外版发送语音，客服端不能解析的问题。
  3. 优化第一次打开SDK，序列化错误提示的问题。

V8.2.0 (2023-03-03)

新增

  1. 新增丰富转人工条件，交互一定轮次后展示常驻转人工入口和常驻转人工入口位置设置 。
  2. 新增上报手机型号。
  3. 新增工单查看座席内容回复。

修改

  1. 优化商品查询界面UI展示。
  2. 修复一触及达多选问题。

V8.1.1 (2022-02-10)

新增

  1. 新增询前表单。
  2. 新增适配土耳其语。

修改

  1. 修复在在部分手机上文字展示不全的问题。
  2. 修复低版本手机上图片不能保存的问题。
  3. 移除sentry。

V7.12.0 (2022-12-29)

新增

  1. 新增视频客服的屏幕共享功能。
  2. 新增适配Android 13。
  3. 新增商品卡片intent参数。

修改

  1. 默认关闭行为轨迹。
  2. 表情面板增删个别表情。

V7.11.0 (2022-11-29)

新增

  1. 新增用户拒绝权限的回调。
  2. 新增横屏下的全屏模式。
  3. 新增SDK自启动配置，默认不自启动。
  4. 新增适配对话框样式模板ID。
  5. 新增七鱼与云信融合模式。

修改

  1. 优化横屏适配。
  2. 优化无权限提示语，增加“请前往系统设置中打开相应权限”提示。

V7.10.0 (2022-11-02)

新增

  1. 新增机器人一触即达支持时间选择。
  2. 新增座席辅助，一触即达自动回复。

修改

  1. 优化商品卡片，新增商品ID等字段。
  2. 优化填写手机号支持国际号码。

V7.9.1 (2022-10-13)

新增

  1. 新增视频客服SDK。

V7.9.0 (2022-09-28)

修改

  1. 优化答案满意度样式。
  2. 优化售后宝工单展示，默认使用系统WebView。

V7.8.0 (2022-08-29)

新增

  1. 新增海外版。
  2. 新增售后宝工单系统展示。

V7.7.1 (2022-08-01)

修改

  1. 去掉安装APP信息getPackageInfo方法的调用。
  2. 去掉AndroidManifest文件中BOOT_COMPLETED的配置。

V7.7.0 (2022-07-28)

修改

  1. 机器人答案评价按钮适配主题色。
  2. 修复客服撤回消息还显示的问题。
  3. 修复由于CONNECTIVITY_SERVICE导致的内存泄漏。
  4. 最近一条消息的缩略内容增加卡片消息，工单消息，留言消息。
  5. 修复相同foreignId下数据库的复制迁移问题。

V7.6.0 (2022-06-30)

修改

  1. 修复Https检测认证风险问题。
  2. 修改语音发送最大时长为60秒。
  3. 修复工单内容不展示的问题。
  4. 解决Demo不能正常安装的问题。
  5. 去掉sentry中温度传感器的获取。

V7.5.0 (2022-05-31)

修改

  1. 升级七鱼日志库，解决与客户日志库冲突的问题。
  2. 多语言设置新增支持俄语、阿拉伯语。
  3. 修复sentry报错。

V7.4.0 (2022-05-06)

新增

  1. 增加多语言设置，支持中、繁、英、日、韩、德、法、泰、印尼语、越南语、菲律宾语。
  2. 不支持1秒以内的语音发送。
  3. 增加关闭通知栏消息提醒。
  4. 增加demo私有化配置项。

修改

  1. 优化调用requestStaff请求客服方法，增加返回值判断。
  2. 优化authToken校验。

V7.3.0 (2022-04-01)

修改

  1. 修改头像优先级设置，支持本地优先和后端配置优先。
  2. 修改状态栏默认颜色为白色，支持修改状态栏颜色。
  3. 修改快捷短语内容发送问题。

V7.2.0 (2022-03-08)

新增

  1. 新增机器人阶段快捷短语用户行为统计。
  2. 新增机器人阶段拍照按钮配置项。

修改

  1. 修改已知问题。

V7.1.3 (2022-02-24)

修改

  1. 优化传感器的调用频率。
  2. 修改已知问题。

V7.1.2 (2022-02-22)

修改

  1. 优化隐私权限问题，去掉敏感权限的调用。
  2. 修改已知问题。

V7.1.1 (2022-02-17)

修改

  1. 优化隐私权限问题，去掉AndroidId的使用。

V7.1.0 (2022-02-10)

修改

  1. 用户信息上报优化。
  2. 非中文的默认语言修改为英文。

V7.0.0 (2022-01-14)

新增

  1. 新增快捷入口订单、商品查询。
  2. 新增获取会话状态方法。

V6.11.1 (2021-12-23)

修改

  1. 优化获取AndroidId的场景
  2. 修改已知问题

V6.11.0 (2021-12-20)

新增

  1. 新增引用消息展示

修改

  1. 修改已知问题

V6.9.2 (2021-10-21)

修改

  1. 修复平台商家转接企业客服不能点击的问题

V6.9.1 (2021-10-13)

修改

  1. 修复二次转接企业客服未断开问题
  2. 修复编译时AndroidManifest文件冲突的问题（去除app.build中packagingOptions多于的配置）
  3. 修复编译时根据资源名称未找到资源的问题

V6.9.0 (2021-09-27)

新增

  1. 新增平台版企业转接至子企业功能

修改

  1. 修改已知问题

V6.8.0 (2021-09-02)

新增

  1. 新增机器人消息支持快捷标签
  2. 新增常见问题卡片样式
  3. 新增常见快接入口功能

修改

  1. 修改已知问题

V6.6.0 (2021-07-12)

修改

  1. 修改“会话结束”toast提示都在七鱼聊天框内展现的问题
  2. 修复一些其他已知问题

V6.5.0 (2021-06-03)

修改

  1. 修改已知问题

V6.4.0 (2021-05-10)

修改

  1. 修复已知 crash

V6.3.0 (2021-04-13)

新增

  1. 提升 SDK 兼容性
  2. 修复已知 crash

V6.2.0 (2021-03-16)

新增

  1. 完全兼容多语言功能
  2. 优化通知栏展示样式
  3. 修改不安全的加密方式
  4. 增加混淆配置，升级此版本需要重新配置混淆文件

修改

  1. 解决七鱼 SDK 与云信 SDK不能共同使用的问题
  2. 优化通知栏展示样式
  3. 优化已知问题

V6.1.0 (2021-02-20)

新增

  1. 修改开放 Api 中的包名，从 com.netease.xxx 切换到 com.qiyukf.xxx
  2. 增加切换 FromPage 参数重新请求客服的功能
  3. 新增机器人快捷入口工单操作
  4. 新增机器人快捷短语高亮功能

修改

  1. 解决七鱼 SDK 与云信 SDK不能共同使用的问题
  2. 优化通知栏展示样式
  3. 优化已知问题

V6.0.0 (2021-01-14)

新增

  1. 增加一触即达多选功能
  2. 增加 App 访客多模版功能
  3. 增加咨询界面公告展示

修改

  1. 修改已知 crash 问题

V5.16.0 (2020-12-04)

新增

  1. 增加机器人转接功能
  2. 增加 logout 方法回调

修改

  1. 优化 setUserInfo 方法，目前通过带有 callback 参数的方法可以确定是否设置信息成功
  2. 删除 SDK 中获取 imei 和 mac 信息的代码

V5.15.0 (2020-10-22)

新增

  1. 增加申请权限事件
  2. 增加默认不好评功能
  3. 提升 SDK 性能体验
  4. 修改已知问题

V5.14.0 (2020-09-09)

新增

  1. 开放头像点击事件
  2. 修改商品重复发送问题
  3. 修复已知问题

V5.13.0 (2020-08-06)

新增

  1. 新增配置访客分流模版功能
  2. 新增选择客服分流入口时效功能
  3. 兼容 Android 10

修改

  1. 修改通过 getApplicationInfo().labelRes 获取 App 名字获取失败的问题
  2. 其他已知问题

V5.12.0 (2020-07-13)

新增

  1. 新增访客查询工单功能
  2. 新增 UnicornMessageBuilder.buildFileMessage 方法
  3. 新增部分功能 demo 代码

修改

  1. 修复已知问题

V5.11.0 (2020-06-03)

新增

  1. 富文本附件查看功能
  2. 机器人满意度评价功能

修改

  1. 修复已知问题

V5.10.0 (2020-04-27)

新增

  1. 新增 HttpDns 的功能
  2. 新增排队引导语设置多模版的功能
  3. 新增客服邀请填写工单的功能

修改

  1. 升级 Android Support 到 Android X
  2. 修改选择客服组之后消息展示样式
  3. 修改 bot 多行文本展示样式

V5.7.0 (2020-01-14)

新增

  1. 人工会话提工单的功能
  2. Bot 订单列表样式优化
  3. 新增 Bot 节点按钮的类型

修改

  1. 修改已知问题

V5.6.0 (2019-12-25)

新增

  1. 新增文件选择功能
  2. 新增机器人转人工可以选择分组的功能
  3. 修改对话节点按钮样式
  4. 修改已知问题

V5.5.0 (2019-12-12)

新增

  1. 增加后台设置主题色的范围
  2. 增加自定义商品消息的功能
  3. 增加设置机器人欢迎语的功能
  4. Android 10 全面适配
  5. 修改已知问题

V5.4.0 (2019-11-19)

新增

  1. 增加退出排队方法
  2. 增加 Fragment 接入方式启动 SDK 拍照和视频相关界面的方法
  3. 增加右上角按钮读取后台配置的功能
  4. 增加切换客服入口提示用户的功能

修改

  1. 修改快捷入口为不能重复点击
  2. 修复已知问题

V5.3.1 (2019-10-21)

修改

  1. 修改输入框上方按钮的效果
  2. 修复已知问题

V5.3.0 (2019-09-23)

新增

  1. 新增富文本中播放视频的功能
  2. 新增存储消息到本地的方法

修改

1.修改已知问题

V5.2.0 (2019-08-22)

新增

  1. 新增选择视频、拍视频、评价、结束会话的 Action
  2. 新增在机器人会话中提交工单的功能
  3. 新增读取后台设置，配置 SDK UI 的功能

修改

1.修改已知问题

V5.1.0（2019-07-25）

新增

  1. 新增评价气泡样式
  2. 新增评价四级模式

修改

  1. SDK 样式升级，修改大部分图标和颜色，使界面更美观
  2. 修改已有评价展示样式
  3. 修复已知问题

V5.0.0（2019-06-27）

新增

  1. 新增一触即达新样式
  2. 新增机器人消息气泡自定义功能
  3. 新增头像展示逻辑自定义
  4. 新增自定义评价接口
  5. 新增聊天界面 loading 动画自定义

修改

  1. SDK 消息气泡样式
  2. 引导语样式调整
  3. 修复已知问题

V4.12.0（2019-05-16）

新增

  1. 新增发送本队视频的功能
  2. 新增留言上传附件的功能
  3. 新增客服安抚语的功能

修改

  1. 修复已知问题

V4.11.0（2019-04-16）

新增

  1. 新增留言模板的功能
  2. 提高 SDK 中的图片的清晰度
  3. 新增客服正在输入的功能
  4. 增加会话提示文案和超时结束会话的文案
  5. 新增设置机器人按钮 UI 和一触即达 UI 的相关 API

V4.10.0（2019-03-19）

新增

  1. 兼容富文本标签
  2. 输入联想功能增加动画

修改

  1. 修改连接文案
  2. 修复已知问题

V4.9.0(2019-02-14)

新增

  1. 新增评价按钮隐藏的功能
  2. 新增再次评价的功能
  3. 新增自定义表情功能

修改

  1. 满意度评价入口支持隐藏及回合数设置
  2. 优化账号登录及登出逻辑

V4.8.0(2019-01-03)

新增

  1. 新增差评转人工功能
  2. 开放 bot 点击事件的功能

V4.7.1(2018-12-18)

新增

  1. 修复已知问题

V4.7.0(2018-12-05)

新增

  1. 新增转接客服接口
  2. 新增会话开始收起历史消息
  3. 新增会话界面顶部自定义区域
  4. 富文本兼容 <span> 标签

V4.6.0(2018-11-15)

新增

  1. 新增消息撤回的功能
  2. 新增 SKD 自定义接入客服信息的功能
  3. 开放连接客服结果事件的监听

V4.5.0(2018-10-09)

新增

  1. 新增录制和发送小视频的功能
  2. 兼容低版本不能识别 SVG 图片的问题

V4.4.0(2018-09-06)

新增

  1. 新增请求客服事件 App 方拦截的功能
  2. 新增机器人发送卡片的功能
  3. 新增卡片底部重新选择按钮的功能
  4. 新增消息已读未读的功能
  5. 新增用户行为轨迹的功能
  6. 修复了 ServerEnvs 文件的空指针问题
  7. 修复服务直达没有存储到本地的问题
  8. 增加是否拉取已读未读消息的开关

V4.3.0(2018-08-08)

新增

  1. 新增自定义消息处理的接口
  2. 新增商品消息新样式
  3. 新增客服界面右上角按钮自定义
  4. 新增用户进入人工客服界面可以手动发送商品的功能
  5. 新增客服界面输入框相关内容自定义
  6. 优化用户输入联想功能，根据用户输入的消息与企业知识库进行匹配
  7. 新增了创建 IMessage 和发送 IMessage 的接口
  8. 修改了 sendProductMessage 的逻辑，使 show 参数生效

V4.2.2(2018-07-12)

新增

  1. 增加用户切换账户之后未读消息的拉取功能

V4.2.1(2018-06-21)

新增

  1. 支持 bot 富文本的功能
  2. 支持客服端发送的自定义商品信息

V4.1.0(2018-05-17)

新增

  1. 新增用户输入联想，访客输入内容可与企业知识库进行实时匹配
  2. 新增对服务器端主动发送消息方案的支持
  3. 商品链接增加tags字段，用于提供操作入口
  4. 优化长消息阅读体验

V4.0.0(2018-04-08)

新增

  1. 支持 App 访问轨迹
  2. 访客排队过程中可退出排队
  3. 访客排队过程中可与机器人继续会话
  4. 对机器人回答差评后可填写差评原因
  5. 接入反垃圾系统，垃圾消息将被禁止发送

V3.14.0(2018-02-06)

新增

  1. 满意度评价支持添加标签
  2. 满意度评价支持自动弹出

V3.13.0(2017-12-26)

新增

  1. 增加人工客服模式下的订单选择入口

V3.12.0(2017-11-16)

新增

  1. 增加指定机器人客服
  2. 增加发送正在输入的内容到客服端
  3. 支持 Android 8.1

修改

  1. SDK 改为异步初始化，提升启动速度

V3.11.1(2017-10-17)

新增

  1. 添加静默访客结束会话提示

V3.10.0(2017-09-07)

新增

  1. 增加会话超时提醒
  2. 一触即达增加卡片模板

修改

  1. 修复用户评价时可能会FC的问题
  2. 修复平台商户的名字包含'时会FC的问题
  3. 修复使用 Android Studio 3.0 测试版本时编译失败的问题

V3.9.5(2017-08-15)

新增

  1. 增加对客服主动邀请评价的支持
  2. 增加对自定义文案的支持

V3.9.0(2017-07-20)

新增

  1. 增加对留言功能可关闭的支持。
  2. 一触即达增加自动生成工单和图文混排等模板。
  3. UI自定义中增加标题文字居中选项。

V3.7.1(2017-06-22)

修改

  1. 修复在 OPPO 手机上后台自启动时因为 startService 抛出异常导致初始化失败的问题。
  2. 修复在小米手机上因为 AlarmManager.set 接口抛出安全异常导致崩溃的问题。
  3. 修正 App 使用 360 加固后初始化时调用 getAnnotation 接口可能会失败，进而导致崩溃的问题。
  4. 修正 OPPO 手机上 bindService 可能会失败的问题。
  5. 修正在某些网络环境下，底层网络解包会抛出异常，导致崩溃的问题。

V3.7.0(2017-05-24)

新增

  1. 增加对富媒体消息的支持。
  2. 增加对机器人回答评价功能。

V3.6.1(2017-05-10)

修改

  1. 修复在系统版本低于 7.0 的手机上可能无法正常拍照的问题。

V3.6.0(2017-04-27)

修改

  1. 修复部分手机写 log 可能造成崩溃的问题。

V3.5.5(2017-04-10)

新增

  1. 增加访客端主动退出会话和退出排队的设置。

修改

  1. 打开会话时无需传入 authToken 字段。
  2. 汇报用户信息增加回调接口，用于确认设置是否成功。
  3. 修正在 targetSdkVersion 大于等于24时，系统版本大于等于 7.0 的手机不能打开拍照页面的问题。

V3.5.0(2017-03-28)

新增

  1. 增加服务直达功能。
  2. 增加 VIP 等级设置。
  3. 请求客服和汇报用户信息增加 authToken 校验字段。
  4. 增加崩溃和异常后的日志反馈功能。

V3.4.0(2017-02-21)

新增

  1. 增加对文件类型消息的支持。
  2. 增加清除缓存的接口。

修改

  1. 修正写 log 时可能的崩溃。

V3.3.0(2017-01-20)

新增

  1. 会话列表中增加会话状态。

修改

  1. 使用 MappedByteBuffer 替代直接文件写入，优化 log 性能。
  2. 修复一些非常偶现的崩溃，包括：从老版本升级并关闭 sdkIconContainer 导致的崩溃，因线程竞争导致的登录状态报告时候的崩溃等。
  3. 进程间唤起方式由 Broadcast 改为 Service，避免极个别机型上收到消息不能唤起 UI 进程的问题。

V3.2.0(2017-01-04)

新增

  1. 新增平台电商企业接入控制，增加 POPManager 接口，增加获取访客会话列表功能。

←