# 更新日志

观看页 SDK 遵循 [Semantic Versioning 2.0.0](https://semver.org/lang/zh-CN/) 语义化版本规范。

***

## v1.10.1(2024-10-25)

### Bug Fixes

* 修复开启后台素材库功能后，无法正常回放课件的问题
* 修复因接口缓存无法正常回调 `ChatEvents.CurrentUserRelogin` 的问题

### Features

* 核心模块(core) 支持外部调用 `setWeixinSdk` 来传入微信 SDK 实例
* 播放器模块(player) 支持直播播放器，在点击片头广告和暂停广告时，处理微信小程序跳转逻辑
* 播放器模块(player) 支持点播播放器响应后台开关，处理网页全屏和回放功能限制等逻辑
* 播放器模块(player) 支持根据后台开关处理循环播放逻辑
* 回放模块(playback) 支持配合素材库回放列表功能，通过 vid 观看纯回放直播间

### Optimizes

* 频道模块(channel) 更换直播流状态查询接口
* 一些小的细节优化(clientId)

### Build System

* 更新 `@polyv/emotion-sdk` 版本至 `3.0.0`
* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20241024`
* 更新 `@polyv/chat-sdk` 版本至 `0.26.0-rc.2`

***

## v1.9.2(2024-09-27)

### Features

* 任务奖励模块(task-activity) 新增领奖信息提交逻辑
* 播放器模块(player) 新增 webview 画中画功能相关的配置
* 回放模块(playback) 新增快进快退配置

### Optimizes

* 微信模块(weixin) 支持响应后台分享设置图标变更
* 文档模块(doc) 支持在视频回放时响应主次屏切换

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240926`

***

## v1.8.2(2024-09-20)

### Bug Fixes

* 修复在微信环境下或者传入自定义 `param4` 参数的情况下，sdk无法正常提供在线人数的问题

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240919`

***

## v1.8.0(2024-09-13)

### Deprecated

* 聊天室模块(chat) 旧的 `getOnlineUserList` 方法即将废弃，请改用 `getOnlineUserListNew` 方法

### Bug Fixes

* 提问模块(ask) 修复聊天室断开导致提问发送失败，消息状态错误回调的问题
* 聊天室模块(chat) 修复转换发言链接和 防 xss 注入冲突导致无法正常转换的问题

### Features

* 频道模块(channel) 增加多流轨配置获取，同时兼容旧逻辑
* 频道模块(channel) 增加在线列表配置获取
* 播放器模块(player) 支持无延迟双流直播
* 播放器模块(player) 支持暖场大图配置的获取

### Optimizes

* 核心模块(core) 支持更新 xAuthToken 同步更新互动功能相关的 token
* 聊天室模块(chat) 优化在线列表相关的功能
* 一系列小的细节修复和优化

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240912`
* 更新 `@polyv/live-low-latency-player` 至 `1.7.0`

***

## v1.7.0(2024-08-23)

### Deprecated

* 字幕模块(subtitle) 即将废弃 `SubtitleSetuped` 事件

### Features

* 字幕模块(subtitle) 支持实时字幕多种翻译语言处理，增加 `SubtitleListForceSync` 事件
* 播放器模块(player) 支持通过 `setPlayerReplaySubtitleSelectConfig` 方法来更改回放播放器的字幕选择组件
* 聊天室模块(chat) 支持请求聊天历史数据时过滤红包消息
* 回放模块(playback) 支持通过回放对象获取音频资源
* 任务奖励模块(task-activity) 支持提供奖励发放失败原因数据

### Code Refactoring

* 字幕模块(subtitle) 更改 setup 流程，之后不会在 setup 阶段自动请求实时字幕数据，需要外部手动调用 `initSubtitleList` 方法

### Optimizes

* 字幕模块(subtitle) 支持在无延迟场景下，响应频道配置实时字幕的延迟

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240815`

***

## v1.6.0(2024-08-02)

### Features

* 域名模块(domain) 新增 `processRandomHostname` 方法来处理随机域名（仅提供给 SaaS 泛域名客户使用）

### Optimizes

* 埋点模块(rtas) 支持 "订单页浏览事件"，减少已经废弃的事件
* 字幕模块(subtitle) 支持在无延迟场景下，根据后台配置来处理延迟
* 观看条件模块(auth) 支持在独立授权和外部授权时，对外暴露 "同个观众反复授权"的错误信息
* 连麦模块(connect-mic) 支持在摄像头异常的情况下也能正常上麦

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240801`

***

## v1.5.0(2024-07-12)

### Features

* 新增任务奖励模块(task-activity)
* 新增订单模块(order) 以支持商品订单功能
* 互动模块(interact-receive) 新增 `getAddressManagement` 和 `getOrder` 方法来支持商品支付相关功能
* 聊天模块(chat) 支持"消息/评论"上墙功能
* 邀请模块(invite) 支持邀请明细下载功能
* 观看条件模块(auth) 支持白名单观看会员码使用限制逻辑
* 频道模块(channel) 支持在平板设备下自动更换布局的功能（仅 SaaS 可用）
* 播放器模块(player) 支持自动清晰度处理（仅正常延迟播放器支持）

### Optimizes

* 优化聊天室人数获取逻辑

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `rc-20240711`
* 更新 `@polyv/chat-sdk` 版本至 `0.24.0-rc.1`

***

## v1.4.0(2024-06-21)

### Features

* 互动模块(interact-receive) 支持抽奖隐私协议逻辑

### Optimizes

* 优化外链脚本加载失败后的逻辑处理
* 优化移动端播放网页全屏逻辑
* 观看页只在 vid 入参时才设置直播播放器 `forceSessionId` 为 `false`

### Build System

* `interactions-receive-sdk` 更新至 `rc-20240620`

***

## v1.3.0(2024-05-24)

### Bug Fixes

* 聊天模块(chat) 修复观众自己点赞的消息重复累加的问题
* 聊天模块(chat) 和 连麦模块(connect-mic) 修复聊天室重连后观众昵称不正确的情况
* 修复部分 bug

### Features

* sdk 支持配合 [保利威 WebView SDK](https://help.polyv.net/#/live/webview/)，实现 Webview-Feed 流切换的能力（详情可咨询保利威技术人员）
* sdk 支持响应后台"素材库"相关功能配置
* 频道模块(channel) 和 观众模块(user) 支持响应主播信息
* 连麦模块(connect-mic) 增加新版连麦流程
* 聊天模块(chat) 和 提问模块(ask) 增加消息重发功能
* 互动模块(interact-receive) 支持热卖商品悬浮条，支持商品提示语配置
* 一客一码模块(sale-invite) 新增相关的数据采集功能
* 新增一系列相关参数的支持，具体可以看参数上对应的版本号

### Optimizes

* 支持加载内部外链 sdk 失败时改用备用地址的逻辑
* 频道模块(channel) 支持响应技术支持平台对网页 favicon 的配置
* 邀请模块(invite) 支持获取邀请榜相关的配置信息

### Build System

底层依赖版本更新，修复相关问题

* `@just4/load-script` 更新至 `1.2.0`
* `@polyv/player-module` 更新至 `1.18.0`
* `@polyv/chat-sdk` 更新至 `0.21.0-rc.1`
* `@polyv/live-low-latency-player` 更新至 `1.6.0`
* `interactions-receive-sdk` 更新至 `rc-20240516`

***

## v1.2.0(2024-03-22)

### Bug Fixes

* 聊天室模块(chat) 修复处理开播端发言时出现 `xss` 注入的问题
* 播放器模块(player) 修复移动端清晰度选项显示不正确的情况

### Features

* 从该版本开始，金融风险确认模块(finance-risk-confirm) 和 金融风险测评模块(finance-risk-evaluation) 开始接入使用
* sdk 新增观众身份认证模块(identify)，用于保利威的用户系统
* 核心模块(core) 新增 `getAccountInfo` 方法来获取当前频道对应的账号信息
* 聊天室模块(chat) 新增相关 api 支持消息重发相关功能
* 聊天室模块(chat) 和提问模块(ask) 新增对头衔和提问区标签的支持
* 播放器模块(player) 支持使用新的无延迟厂商(volc)
* 播放器模块(player) 支持使用后台相关的配置来控制回放视频的操作
* 文档模块(doc) 新增观看页翻页的权限控制
* 一客一码模块(sale-invite) 支持非微信环境使用

### Code Refactoring

支持暴露内部模块，现在可以在创建 `WatchCore` 实例前，就通过导入模块来生成相关的默认值，比如：

```js
import { PlvChannelModule } from '@polyv/live-watch-sdk'
const themeSetting = PlvChannelModule.generateDefaultThemeSetting();
console.warn('themeSetting', themeSetting)
```

### Optimizes

* sdk 兼容 PC 企微小程序
* 频道模块(channel) 新增观看次数相关 api，优化观看次数同步不及时的问题
* 连麦模块(connect-mic) 优化普通延迟频道连麦后， PPT 画面实时跟随处理
* 连麦模块(connect-mic) 优化上麦状态和连麦状态调用时机
* 播放器模块(player) 优化无延迟错误事件处理，便于外部在无延迟播放错误时能正常降级成普通延迟播放
* 观众模块(user) 完善实名认证相关判断
* 新增一系列相关参数的支持，具体可以看参数上对应的版本号

### Build System

* 更改加载播放器 SDK 和 PPT-SDK 的外链域名：从 `player.polyv.net`更改成 `websdk.videocc.net`
* 更改底层请求库：从 `@just4/ajax` 更改成 `@just4/request`
* 底层依赖版本更新
  * `@polyv/elog-sdk` 更新至 `2.2.1`
  * `@polyv/emotion-sdk` 更新至 `3.0.0`
  * `@polyv/player-module` 更新至 `1.17.0`
  * `@polyv/rtas-sdk` 更新至 `0.5.1`
  * `@polyv/live-low-latency-player` 更新至 `1.5.0`
  * `interactions-receive-sdk` 更新至 `rc-20240321`

***

## v1.1.0(2024-02-01)

### Bug Fixes

* sdk 修复在初始化 `watchCore` 时，在传入的观众昵称为手机号后无法正常设置昵称的问题
* sdk 修复内部模块浮点数计算精度问题，涉及提现模块(withdraw) 和红包模块(redpack)
* 播放器模块(player) 修复正常延迟直播播放时清晰度选项和配置不符合的问题
* 播放器模块(player) 修复在 PC 微信小程序上部分交互和样式异常的问题
* 报名模块(enroll) 修复在参与互动场景下，使用姓名作为聊天室昵称时没有及时同步的问题
* 连麦模块(connect-mic) 修复部分ios机型观看页点击申请连麦授权后无延迟播放没有声音的问题

### Features

* 互动模块(interact-receive) 支持自定义抽奖礼盒按钮文案
* 邀请模块(invite) 新增 `getInvitePosterUrl` 方法来获取保利威邀请海报链接
* 一客一码模块(sale-invite) 新增分享参数逻辑处理，支持响应后台相关配置
* 观众模块(user-module) 新增 `getUserSaleInfo` 方法获取当前一客一码跟进人信息
* 工具模块(utils) 新增生成保利威 PDF 预览地址和错误页地址的方法

### Optimizes

* sdk 优化内部判断移动端设备的逻辑，适配麒麟系统
* sdk 优化在移动设备使用正常延迟直播播放器时，直接加载对应的移动端播放器
* 观看条件模块(auth) 优化在外部授权条件下，跳转到失败授权地址时携带当前页面链接除保利威授权参数外的所有参数
* 频道模块(channel) 优化语言配置逻辑，增加 `getRecommendLangSetting` 方法来获取最优先的语言配置项
* 域名模块(domain) 新增 `watchPageDomain` 配置，并优化保利威业务页面跳转的域名处理逻辑
* sdk 内部一系列细节优化，包括微信快照页，分享参数等...

### Build System

* `@polyv/player-module` 更新至 `1.17.0` 版本，支持和优化弹幕相关逻辑
* `@polyv/interactions-receive-sdk` 更新至 `rc-20240201` 版本
* `@polyv/live-low-latency-player` 更新至 `1.4.0` 版本，优化退到后台恢复前台拉流逻辑

***

## v1.0.0(2023-12-29)

### Deprecated

* 播放器模块(player) 即将废弃 `playerInfo` 中的 `pcPlayerVersion` 中的字段

### Bug Fixes

* 连麦模块(connect-mic) 修复网络状况不佳且重复连麦时无法正常连麦的问题
* 聊天室模块(chat) 修复部分情况下当前观众发言后没有正常回调 `ChatEvents.SelfSpeak` 事件的问题
* 播放器模块(player) 修复无延迟直播时移功能和跑马灯功能冲突的问题

### Features

* 域名模块(domain) 新增相关的域名配置项，其余模块同步更改
* 工具模块(utils) 新增获取当前默认静态资源的方法
* 播放器模块(player) 增加暂停按钮样式开关
* 字幕模块(subtitle) 新增 `SubtitleSetuped` 事件回调来兼容获取历史消息逻辑
* 打赏模块(donate) 新增 `getDonateSvgaUrl` 方法来获取保利威默认的 `svga` 链接

### Optimizes

* 加载外部 SDK 时增加 `crossorigin=anonymous` 逻辑处理
* 观看条件模块(auth) 补充一客一码授权类型处理
* 弹幕模块(barrage) 优化显示逻辑，在弹幕数过多的情况下也不丢弃当前观众的弹幕
* 播放器模块(player) 兼容点播播放器在 PC 端小程序播放加密视频的逻辑
* 微信模块(weixin) 优化微信快照用户相关授权验证逻辑
* 频道模块(channel) 和播放器模块(player) 优化直播结束后自动切回放逻辑

### Build System

* SDK 正式版固定依赖库版本号，依赖的部分 beta 包更新至正式版
* `@polyv/interactions-receive-sdk` 更新至 `rc-20231228` 版本
* `@polyv/player-module` 更新至 `1.16.1` 版本，完善弹幕库支持
* `@polyv/live-low-latency-player` 更新至 `1.3.0` 版本

***

## v0.12.0(2023-12-08)

### Deprecated

* 互动模块(interact-receive) 即将废弃 `ProductEnabledChange` 事件，请改用 `InteractSettingUpdate` 事件处理

### Bug Fixes

* 修复频繁多次调用核心模块(watchCore) `setup` 方法报错的问题
* 修复播放器模块(player) 缺少清晰度选项的问题
* 修复字幕模块(subtitle) 获取历史实时字幕显示顺序可能反转的问题
* 修复互动评论抽奖时，自己发送的评论弹幕没显示
* 修复内部轮询器没有正常销毁的问题

### Features

* SDK 应用配置(appConfig) 更新
  * 新增 `saleInviteParams` 入参处理一客一码邀请参数
  * 原有 `sdkIntegration` 字段新增 `chatSdkScriptUrl` 入参支持传入自定义的聊天室 SDK JS 地址
* SDK 新增一客一码模块(saleInvite)，处理相关功能逻辑
* 邀请模块(invite) 新增邀请有礼相关功能逻辑
* 互动模块(interact-receive) 新增 `InteractSettingUpdate` 事件通知配置项同步
* 字幕模块(subtitle) 增加最大显示历史字幕条数限制
* 短信模块(sms) 新增全局配置，处理是否需要图片验证码逻辑

### Code Refactoring

* 优化 SDK 打包后的体积，减少至 `941KB` 左右
* 提问模块(ask-module) 对应的 `getAskSdk` 方法更改为异步逻辑

### Optimizes

* 完善销毁核心模块(watchCore)逻辑
* 文档模块(doc) 优化 PPT 初始化加载慢的问题

### Build System

* `@polyv/chat-sdk` 不再需要被打包到观看页 SDK 中，改成在执行核心模块(watchCore) `connect` 方法时通过 `umd` 外链方式引入，版本为 `0.19.0-rc.1`
* 升级`@just4/ua-info` 至 `1.2.0-beta` 版本完善设备类型判断
* 更新 `@polyv/interactions-receive-sdk` 版本至 `20231207`
* 更新 `rtcWebSDK` 至 `v1-latest`

***

## v0.11.0(2023-11-17)

> !! 注意：保利威企微相关服务从该版本开始才能正常使用 !!

### Bug Fixes

* 聊天室模块(chat) 修复获取特殊角色长文本发言异常的问题

### Features

* 核心模块(watchCore) 创建实例时，支持通过 `userInfo` 传入用户头衔 `actor` 字段，用户模块(user) 同步新增 `getUserActor` 方法
* 微信模块(weixin) 新增企微好友和企微营销相关处理
* 播放器模块(player) 新增时移打点功能兼容多码率的逻辑
* 播放器模块(player)和弹幕模块(barrage) 支持调整弹幕显示区域，调整弹幕透明度
* 聊天模块(chat) 支持优先插入本地打赏消息的方法
* 聊天室模块(chat)和提问模块(ask) 支持发言时携带用户头衔

### Code Refactoring

* 微信模块(weixin) 重构企微模块授权主流程
* 聊天室模块(chat) 移除旧版手动分房间逻辑

### Optimizes

* 优化 SDK 打包后的体积，减少至 `1.3M` 左右
* 观看条件模块(auth) 调整外部授权和独立授权逻辑，允许在参数支持的情况下进行二次授权来更改观众信息
* 播放器模块(player) 优化弹幕设置逻辑

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `20231102`
* 更新 `@polyv/rtas-sdk` 版本至 `0.4.3`
* 更新 `@polyv/player-module` 版本至 `1.15.0`，增加弹幕相关逻辑

***

## v0.10.0(2023-10-27)

### Deprecated

* 提问模块(ask) 对应的 `sendQuestion` 方法即将废弃，请用 `sendAskSpeak` 替代
* 聊天模块(chat) 对应的 `setChatMsgReplayPlaybackTarget` 方法即将废弃，请用 `watchCore.playback.setCurrentPlaybackTarget` 替代

### Bug Fixes

* 文档模块(doc) 修复双师功能切换大房间后，白板和 PPT 显示异常的问题
* 聊天模块(chat) 修复解析主播聊天信息链接后展示不全的问题

### Features

* 在 PC 端微信小程序使用时，SDK 内部会判断为移动端环境
* 新增 AI 模块(polyv-ai)，支持 AI 助手答疑业务功能
* 频道模块(channel) 新增 `getChannelAgreementConfig` 方法获取协议配置
* 播放器模块(player) 新增正常延迟播放器控制在直播时是否允许暂停直播的处理
* 连麦模块(connect-mic) 新增对 `agora` 服务商的支持
* 互动模块(interact-receive) 和用户模块(user) 新增"云席"相关功能
* 聊天模块(chat) 新增对课堂激励功能的支持
* 聊天模块(chat) 支持调用 `sendCustomMessage` 方法发送自定义消息，并支持聊天消息回调，对应类型为 `ChatMsgSource.CustomMessage`
* 微信模块(weixin) 支持处理微信强制授权持久化

### Optimizes

* 频道模块(channel) 完善转播处理，在取消转播关联时回调相关事件
* 弹幕模块(barrage) 优化弹幕消息获取机制
* 播放器模块(player) 放开弹幕字号功能限制
* 聊天模块(chat) 优化聊天重放对象获取逻辑
* 优化 SDK 内部其他处理逻辑

### Build System

* 更新 `rtc-web-sdk` 版本至 `1.20.2`，修复部分已知 bug
* 更新 `@polyv/player-module` 版本至 `1.12.2`，优化弹幕相关逻辑

***

## v0.9.0(2023-09-22)

### Bug Fixes

* 频道模块(channel) 修复页面次数轮询回调只触发一次的问题

### Features

* 聊天室模块(chat) 新增根据时间戳获取聊天历史记录功能
* 互动模块(interact-receive) 新增商品库回放功能
* 连麦模块(connect-mic) 新增移动端正常延迟连麦功能
* 字幕模块(subtitle) 新增回放字幕功能
* 微信模块(weixin) 新增获取微信相关配置的方法
* 邀请模块(invite) 新增获取邀请榜配置的方法
* 提问模块(ask) 新增在触发严禁词进行事件回调 `AskEvents.SendBadWord`
* 播放器模块(player)、弹幕模块(barrage) 新增修改弹幕字号大小逻辑
* 报名模块(enroll) 新增对 `tips` 字段类型的处理

### Optimizes

* 频道模块(channel) 完善对转播双师功能的支持，同步调整其他模块和转播双师相关的功能逻辑
* 其他内部模块的一些逻辑优化

### Build System

* 更新 `@polyv/interactions-receive-sdk` 版本至 `20230921`
* 更新播放器 SDK， 支持在 IE 浏览器中加载
* 更新 `@polyv/player-module` 版本至 `1.21.1`
* 更新 `@polyv/rtas-sdk` 版本至 `0.4.2`

***

## v0.8.0(2023-09-01)

### Features

* 频道模块(channel) 新增 SaaS 观看时长功能
* 用户模块(user) 新增观众手机号实名认证功能
* 播放器模块(player) 和 回放模块(playback) 支持双语视频流切换功能
* 邀请模块(invite) 新增邀请明细功能
* 聊天室模块(chat) 新增 `insertLocalImageChatMsg`、`sendImageMsgDirectly` 方法，并支持 `webp` 图片格式上传

### Optimizes

* 完善 SDK 内部多语言处理机制
* 播放器模块(player) 响应后台配置，约束竖屏全屏功能
* 短信模块(sms) 优化短信平台关闭下的处理，增加 `UnSetSmsPlatform` 错误原因
* 弹幕模块(barrage) 支持展示自定义消息
* 字幕模块(subtitles) 优化内部状态管理

### Build System

* 更新 `@polyv/chat-image-upload-sdk` 版本至 `0.5.0-rc.1`
* 更新 `@polyv/interactions-receive-sdk` 版本至 `20230831`

***

## v0.7.0(2023-08-25)

### Features

* SDK 新增字幕模块(subtitles)，播放器模块(player) 支持字幕相关功能处理
* 频道模块(channel) 新增 `SeminarHostJoinInGroup` 和 `SeminarHostLeaveGroup` 事件，完善对研讨会场景的支持
* 连麦模块(connect-mic) 新增 `DeviceRecoverFail` 事件
* 文档模块(doc) 支持双向白板功能
* 播放器模块(player) 支持在无延迟直播下断网重试拉流
* 互动模块 (interact-receive) 新增抽奖手动结束开关

### Code Refactoring

* 核心模块(watchCore) 调整 `updateAppConfig` 方法，不再支持更新 `sdkIntegration`

### Optimizes

* 播放器模块(player) 优化延迟时间处理
* 邀请模块(invite) 优化 `getRankList` 方法
* 观看条件模块(auth) 优化外部授权和独立授权相关逻辑

### Build System

* 更新 `rtc-web-sdk` 版本至 `1.19.1`
* 更新 `@polyv/live-low-latency-player` 版本至 `1.2.0`

***

## v0.6.0(2023-08-11)

### Features

* 核心模块(watch-core)
  * 已支持在观众未授权时也能使用 `isPlaybackWatchByVid` 进行判断，并提供 `getPlaybackWatchBasicInfo` 来获取 `vid` 观看回放的基础信息
  * 传入参数 `autoAuthParams` 增加 `ignoreWxAuth` 和 `wxSnapshotPageMode` 字段
* 微信模块(weixin) 增加对快照模式的处理，并支持响应强制微信授权配置
* 频道模块(channel) 增加营销埋点开关，埋点模块(rtas) 哦后续不需要观众信息也能正常使用
* 互动模块(interact-receive) 支持埋点处理，并处理部分内部优化
* 播放器模块(player) 增加 `PlayerUIControlDisplay` 事件，支持在 UI 层移动端使用播放器 SDK 提供的 UI 控件时，能响应控制栏的显隐操作
* 聊天室模块(chat) 支持响应表情开关配置
* 分享模块(share) 支持响应回放标题分享

### Optimizes

* SDK内部完善私有化域名处理
* 聊天室模块(chat) 统一处理发言消息 `isOverLength` 字段，在接口无相关字段返回时，默认发言内容超过 500 字符即溢出
* 播放器模块(player) 调整对延迟时间 `delayTime` 的处理
* 回放模块(playback) 在处理视频回放时，优先使用 `m3u8` 的视频，并对外提供 `videoSource` 字段提供给到外部获取视频数据
* 短信模块(sms) 增加相关的验证码提示优化
* 用户模块(user) 增加 `CurrentUserKicked` 事件同步响应踢出处理

### Build System

* `@polyv/utils` 版本升级至 `2.5.0-beta.1`
* `@polyv/live-low-latency-player` 版本升级至 `1.1.0`
* `@polyv/white-board-sdk` 和 `@polyv/white-board-ui` 版本升级至 `3.11.1`，增加可操作视频播放的工具，支持加载 avif 格式的图片
* `@polyv/interactions-receive-sdk` 版本升级至 `rc-20230803`

***

## v0.5.1(2023-07-28)

### Deprecated

* 聊天室模块(chat) `getChatSetting` 中的 `maxViewers` 字段不再推荐使用，如需判断是否超过直播间最大在线人数，可以监听 `OverMaxOnlineCount` 事件

### Bug Fixes

* 播放器模块(player) 修复无延迟播放器初始化暂停无法点击播放的问题

### Features

* 完善"测试模式"处理，UI 层不需要再关注"测试模式"，只需要关注直播状态
* 播放器模块(player) 在部分场景下，支持直播结束后自动切换回放暂存视频
* 提问模块(ask) 增加 `SystemMessage` 事件
* 聊天室模块(chat) 增加 `OverMaxOnlineCount` 事件
* 当观众昵称为手机号时，支持响应后台开关进行脱敏处理

### Optimizes

* 播放器模块(player) 销毁时同步销毁时移相关的逻辑
* 播放器模块(player) 重新安装播放器实例时，需要移除 `playerWrap`
* 聊天室模块(chat) `CurrentUserRelogin` 事件回调增加错误来源

### Build System

* `@just4` 部分库升级到正式版
* `@polyv/chat-sdk` 更新到 `0.19.0-rc.1`

***

## v0.5.0(2023-07-21)

### Bug Fixes

* 修复移动端引导页大图封面图展示的问题
* 修复 PPT 跑马灯异常的问题

### Features

* 支持直播时移、精彩看点（直播打点、回放打点）一期功能
* 支持正常延迟播放器使用 ip 地址进行 CDN 拉流
* 推广链接菜单增加 iframe 打开方式处理
* 配合互动 SDK 完善答题红包功能，并增加 chatToken 入参调整互动公告接口

### Optimizes

* 更换默认的回放首帧占位图的地址

### Build System

* 升级 `rtcWebSDK` 至 `0.18.0-rc.1`
* 升级 `@polyv/interactions-receive-sdk` 至 `rc-20230720`

***

## v0.4.0(2023-06-30)

### Deprecated

* `InteractReceiveEvents.VotedListChange` 即将废弃
  * 互动投票功能需要的数据不需要手动传入，可以由 `@polyv/interactions-receive-sdk` 内部维护

### Bug Fixes

* 修复 SDK 内部部分默认图片地址错误的问题
* 修复统计参数 param4 和 param5 没有优先使用接口返回值导致的编码问题

### Features

* 提问模块(ask): 增加竖屏提问相关的方法
* 观看条件模块(auth): 外部授权观看条件优化-主次条件下支持隐藏登录按钮
* 互动模块(interact-receive): 提供抢答 SDK 单一实例方法
* `Polyv-SaaS` 支持静态化配置

### Optimizes

* 完善跑马灯异常处理
* 允许验证外部授权和独立授权时，需要增加是否已进行观看条件授权的判断
* 播放器模块(player) `setupPlayer` 方法 `options` 参数增加 `extraPlayerOptions` 字段，支持透传给到播放器 SDK

### Build System

* 升级 `@polyv/chat-sdk` 至 `0.18.0-rc.1`
* 升级 `@polyv/interactions-receive-sdk` 至 `0.15.0-rc-20230615.1`
* `detail` 接口增加 `clientVersion` 入参来记录版本号

***

## v0.3.2(2023-06-16)

### Bug Fixes

* 修复 `AppConfig` 的 `inviteInfo` 没有支持选传的问题
* 修复无法在回放状态播放视频的 bug

### Features

* 回放模块(playback)支持通过 playbackOptions.url 来获取回放地址
* 支持响应-管理后台观看页语言选项切换
* 支持响应-管理后台直播介绍'压缩图片'开关
* 支持响应-管理后台观看页预约人数隐藏开关
* 频道模块(channel)新增 `ChannelSetupFail` 事件
* 聊天室模块(chat)新增 `ChatReconnectSuccess` 事件，并补充 `ChatConnectFailReason` 枚举值

### Optimizes

* 后续新增的代码增加版本号相关的注释

### Build System

* 更新 `rtc-web-sdk` 版本至 1.18.1
* 更新 `rtas-sdk` 版本至 0.4.1

***

## v0.3.1(2023-06-09)

### Bug Fixes

* 修复前端 viewer 接口传参和后端不一致的问题
* 修复合并的视频为 http 协议，无法正常播放的问题
* 付费观看增加异常处理逻辑，试看增加重定向跳转处理
* 修复聊天重放时，自己的发言没有展示在弹幕上

### Features

* 新增 `verify` 验证模块并提供 `verifyViewerLoginToken` 验证登录令牌 Api，[文档入口](https://git.polyv.net/help-center/document-center/-/blob/master/live/js/new_sdk/live_watch_sdk/articles/verify/overview.html)。

### Optimizes

* 不使用 bind 来代理聊天重放模块对应的方法
* 优化播放器模块获取可选线路 `getLineCount` 方法逻辑，在不支持线路切换时返回可选数为 0。
* 完善播放器 forceSessionId 的处理
* 白名单观看条件增加错误码
* 优化弹幕速度代码

### Build System

* 升级 terser 版本，修复压缩 esm 无法识别 export \* as 的语法问题

***

## v0.3.0(2023-06-02)

### Bug Fixes

* 修复未直播前进入观看页，直播开始后没有显示文档的问题
* 完善打赏功能的判断，微信支付开关禁用的情况下，也支持免费礼物打赏
* 报名观看兼容旧版直播后台数据

### Features

* 观看条件
  * 自定义授权校验增加参数判断
  * 独立授权失败支持重定向跳转
  * 特殊授权参数统一由 UI 层传入
* 微信
  * 调整微信授权的处理逻辑
* 分会场
  * 支持分会场竖向模板
  * 支持分会场链接跳转分会场
* PPT区域支持关闭跑马灯参数show
* 点播播放器增加授权 code 入参
* 连麦
  * 支持移动端竖屏连麦
* 回放
  * 增加聊天重放功能
* 播放器
  * 直播播放器增加弹幕调速功能
* 聊天室
  * 聊天室支持私有化部署

### Optimizes

* 一系列优化！！！！！
* 大部分配置和逻辑改成有 `live-watch-sdk` 实现，UI 层只需要调用对应的方法即可（变更范围：聊天室、频道、互动、播放器、以及其他配置）
* 修改获取在线人数逻辑
* 邀请海报和微信支付跳转时增加 apiVersion 传参
* sdk 不再直接从 url 上来获取特殊授权的入参，改成 ui 层直接传入
* 播放器需要的 sessionId 由 sdk 内部根据后台配置来设置，不再支持在 ui 层传入
* 播放器跑马灯由 sdk 内部根据后台配置来设置，不再支持在 ui 层传入

### Build System

* 升级 rtcWebSDK 到 `1.17.0`
* 互动 SDK 升级到 `rc-20230518`

***

## v0.2.0(2023-05-12)

> 不推荐继续使用

### Bug Fixes

* 修复 PageViewPolling 轮询间隔计算的问题

### Features

* 删除聊天室模块的 checkBadWord 方法
* SDK 内部增加 plvDebug，对外提供 setDebugMode 方法
* 将特殊身份判断迁移到 SDK 层中
* util 模块提供一次性发送多张图片的方法 uploadMultiImage
* 提供 getChannelPlayMode 方法
* 增加 share 模块
* createWatchCore 增加 playbackOrigin 入参
* createWatchCore 增加 autoAuthParams 入参，支持验证码条件下直接访问观看页
* 短信验证码增加类型入参来支持自定义短信内容功能
* 连麦模块增加 supportConnectMic 方法
* 增加邀请海报和分享功能的 POP 开关判断
* 回放状态，响应“不展示下一场次倒计时” 开关

### Optimizes

* 优化获取历史记录 Api 入参
* 优化图片违规的消息替换逻辑
* 优化发送消息后的消息替换机制
* 修改回复字段的类型名
* 优化点赞数逻辑
* 优化情绪反馈事件回调类型
* 完善 auth 和 weixin 模块，提供对应的方法
* 完善 donate, redpack, live-booking, playback 等模块，提供对应的方法
* 完善 invite 模块，不再使用 InviteEvents
* getChatHistoryBySessionId 返回的数据使用 PageContent 结构
* 短信校验增加错误信息返回

### Build System

* 更新 `@polyv/utils`, 替换 EventCenter
* 更新 chat-sdk 和 chat-image-upload-sdk 版本
* 升级 eslint 相关 package

***

## v0.1.0(2023-04-27)

> 不推荐继续使用

...
