获取歌曲附加信息

描述

通过获取歌曲附加信息，可以知道该歌曲的节拍数、节拍类型、以及所属流派信息。

注意

仅当传入的版权方 VendorId 为 “0（默认）” 或 “1” 时，才能使用本服务端接口；其余版权方不支持。版权方的详细信息，请联系 ZEGO 商务人员咨询。

接口原型

请求方法：GET
请求地址：https://ktv-api.zego.im/?Action=DescribeSongExtra
传输协议：HTTPS
调用频率限制：200 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考调用方式 - 公共请求参数。

说明

在线 KTV 服务端接口的公共请求参数与实时音视频、实时语音的不同，包含了 VendorId（版权方 ID），请务必阅读上述参考文档。

参数	类型	是否必选	描述
SongId	String	是	歌曲 ID。

请求示例

Untitled

https://ktv-api.zego.im/?Action=DescribeSongExtra
&SongId=125282604
&<公共请求参数>

Copied!

响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	请求结果的说明信息。
RequestId	String	请求 ID。
Data	Object	响应结果，详情可见 Data。

Data

参数	类型	描述
BPM	Number	节拍数。
BPMType	String	节拍类型。 0：未知 1：慢 2：中 3：快
Genres	Array of Number	歌曲流派，一首歌可能属于多个流派。 1：ACG 2：DJ 3：R&B 4：世界音乐 5：中国特色音乐 6：乡村音乐 7：儿童 8：其他 9：古典音乐 10：另类/独立 11：嘻哈 12：国风音乐 13：实验音乐 14：工业&哥特 15：布鲁斯 16：拉丁 17：摇滚 18：朋克 19：民谣 20：流行 21：爵士乐 22：电子 23：纯音乐 24：舞曲 25：金属 26：雷鬼 27：潮玩

响应示例

Untitled

{
    "Code": 0,
    "Message": "succeed",
    "RequestId": "fa5f5885-4c0e-4b61-a419-18648b9ff2ef",
    "Data": {
        "BPM": 61,
        "BPMType": "1",
        "Genres": [
            5
        ]
    }
}

Copied!

返回码

以下仅列出了接口业务逻辑相关的部分返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
320000004	参数非法。	请根据 Message 提示判断非法参数，调整对应参数值。
320010000	AppId 不可用	请联系 ZEGO 技术支持开通版权音乐服务。
320010001	不支持的付费类型。	请联系 ZEGO 技术支持开通版权音乐对应的付费类型。按次计费
320050000	系统错误。	请联系 ZEGO 技术支持。
320050002	系统繁忙。	请稍后重试。
320050003	未定义的引擎错误。	请联系 ZEGO 技术支持。
320050004	引擎内部错误。	请联系 ZEGO 技术支持。