发布日志
版权音乐功能重要更新（SDK）
注意
请注意，本页面仅更新与版权音乐 KTV 相关的发布日志，如果您想要了解 Express SDK 的其它变更，请参考 实时音视频 - 发布日志。
3.20.5 版本
发布日期：2024-01-08
新增功能
| 功能项 | 功能描述 | 相关文档 |
|---|---|---|
| 版权音乐支持 Flutter Web | 支持开发者使用 Express Flutter SDK 开发 Web KTV 应用。 | 集成 SDK |
3.12.3 版本
发布日期：2024-01-08
新增功能
| 功能项 | 功能描述 | 相关文档 |
|---|---|---|
| 支持版权音乐插件 | 支持版权音乐功能插件化，当开发者的业务场景仅需更新版权音乐相关的代码时，可以单独集成插件包，无需更新 Express SDK，即可平滑迁移。请注意：
| 集成 SDK |
3.10.0 版本
发布日期：2023-10-27
新增功能
| 功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 支持区分场景，获取不同歌曲资源 | 支持在 requestResource 接口传入不同的场景 ID，获取不同的音乐资源，应用于直播、语聊等场景中。 | requestResource |
改进优化
| 优化项 | 优化描述 | 相关接口 |
|---|---|---|
| 优化错误码提示 | 新增 1017071、1017072、1017073、1017074、1017075、1017076、1017077 等错误码，细化版权音乐的错误提示信息。 | requestResource |
修复问题
1. 修复获取总分、平均分失败的问题
2. 修复 KTV 场景中出现打分结果延迟更新的问题
3.4.2 版本
发布日期：2023-04-26
新增功能
| 功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 版权内容中心新增音乐版权方歌曲资源 | 支持在相关接口的参数 vendorID 中传入不同的版权方取值，进行点歌、获取歌词等操作。版权方的详细信息，请联系 ZEGO 商务人员咨询。 | |
| 扩展歌曲打分能力支持范围 | 支持多个版权方歌曲的打分、展示音高线的能力，详细信息，请联系 ZEGO 商务人员咨询。 | 发送扩展请求接口说明 |
| 支持在多房间模式下使用版权音乐 | 通过在"点歌"和"获取分享资源"的接口中加入 roomID 参数，实现版权音乐在多房间模式下的使用。 | |
| 支持歌曲聚合搜索 | 支持通过输入歌手、歌名等关键字，同时在多家版权方曲库中搜索查询，支持对搜索结果筛选、排序、自定义展示。 | |
| 扩展获取到的歌曲资源信息 | 支持通过 requestResource 接口获取 songID 对应歌曲的"抢唱片段"的开始与结束时间等信息，其他用户可以通过 getSharedResource 接口获取分享的信息。该功能仅支持部分版权方使用，请联系 ZEGO 商务人员咨询。 | |
| 新增计费模式 | 新增计费模式，按房主包月计费，请联系 ZEGO 商务人员咨询。 | - |
改进优化
| 优化项 | 优化描述 | 相关接口 |
|---|---|---|
| 优化错误码提示 | 由于歌曲资源存在有效期限制，获取歌曲资源接口，新增返回 1008011 错误码，表示歌曲资源已失效。 | loadCopyrightedMusicResourceWithPosition |
接口变更
- 修改接口
| 修改接口 | 接口描述 | 上线版本 |
|---|---|---|
| ZegoCopyrightedMusicVendorID | 新增一个音乐版权方的枚举值，请联系 ZEGO 商务人员咨询。 | 3.4.2 |
3.3.0 版本
发布日期：2023-03-20
新增功能
| 功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 新增版权内容中心，部分接口支持区分版权方查询 | 支持根据版权方，点歌、获取逐行解析歌词、以及查询资源是否有缓存。 版权方的详细信息，请联系 ZEGO 商务人员咨询。 | |
| 发送扩展请求时，支持根据版权方，获取标签列表、根据标签获取歌曲、批量查询歌曲信息、搜索歌曲。 |
接口变更
- 修改接口
| 修改接口 | 接口描述 | 上线版本 |
|---|---|---|
| getLrcLyric 新增 vendorID 可选参数 | 新增 vendorID 可选参数，支持开发者按照不同的音乐版权方，获取对应 vendorID 的逐行歌词。 | 3.3.0 |
| queryCache 新增 vendorID 可选参数 | 新增 vendorID 可选参数，支持开发者按照不同的音乐版权方，查询不同版权方的音乐资源是否有缓存。 | 3.3.0 |
| ZegoCopyrightedMusicRequestConfig 新增 vendorID 属性 | 支持通过版权方，获取资源。 | 3.3.0 |
| ZegoCopyrightedMusicGetSharedConfig 新增 vendorID 属性 | 支持在分享资源时，配置版权方。 | 3.3.0 |
修复问题
1. 修复了获取歌曲伴奏资源、或高潮片段资源时，立即获取音高线会失败的问题
3.1.0 版本
发布日期： 2022-12-27
新增功能
| 功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 伴奏打分 | 支持获取伴奏或高潮片段资源的满分。 | getFullScore |
修复问题
1. 修改了播放版权音乐时，音频观察器抛出 playback、 mix pcm 音频数据的问题
接口变更
- 新增接口
| 新增接口 | 接口描述 | 上线版本 |
|---|---|---|
| requestResource | 获取音乐资源（包括原曲、伴奏、伴奏高潮片段）。 | 3.1.0 |
| getSharedResource | 获取被分享的歌曲资源。 | 3.1.0 |
- 废弃接口
| 废弃接口 | 变更说明 | 废弃版本 |
|---|---|---|
| 废弃点歌 requestsong、点伴奏 requestAccompaniment、点伴奏高潮片段 requestAccompanimentClip 3 个获取音乐资源接口，统一使用 requestResource 接口替代，获取音乐资源方式更规范便捷。 | 3.1.0 | |
| getMusicByToken | 原有的获取他人分享的歌曲或伴奏 getMusicByToken 接口废弃，替换为 getSharedResource 接口，不再需要使用 shareToken 分享音乐资源。 | 3.1.0 |