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