获取伴奏高潮时间点
描述
通过获取伴奏高潮时间点,可以标示出一首伴奏中高潮片段的时间节点。
接口原型
- 请求方法:GET
- 请求地址:
https://ktv-api.zego.im/?Action=DescribeAccompanyClipInfo
- 传输协议:HTTPS
- 调用频率限制:200 次/秒
请求参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数。
说明
在线 KTV 服务端接口的公共请求参数与实时音视频、实时语音的不同,包含了 VendorId(版权方 ID),请务必阅读上述参考文档。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
SongId | String | 是 | 歌曲 ID。 |
请求示例
Untitled
https://ktv-api.zego.im/?Action=DescribeAccompanyClipInfo
&SongId=125282604
&<公共请求参数>
1
响应参数
参数 | 类型 | 描述 |
---|---|---|
Code | Number | 返回码。 |
Message | String | 请求结果的说明信息。 |
RequestId | String | 请求 ID。 |
Data | Object | 响应结果,详情可见 Data。 |
Data
参数 | 类型 | 描述 |
---|---|---|
SegmentBegin | Number | 高潮开始时间,单位:毫秒。 仅当 VendorId 为 0、1 或 4 时,此字段的返回值才有实际意义。 |
SegmentEnd | Number | 高潮结束时间,单位:毫秒。 仅当 VendorId 为 0、1 或 4 时,此字段的返回值才有实际意义。 |
ShortSegmentBegin | Number | 高潮片段资源短分片的开始时间,单位:毫秒。 仅当 VendorId 为 2 时,此字段的返回值才有实际意义。 |
ShortSegmentEnd | Number | 高潮片段资源短分片的结束时间,单位:毫秒。 仅当 VendorId 为 2 时,此字段的返回值才有实际意义。 |
响应示例
Untitled
{
"Code": 0,
"Message": "succeed",
"RequestId": "94987a7c-a386-43df-a164-2b8c72be4ce9",
"Data": {
"SegmentBegin": 0,
"SegmentEnd": 0,
"ShortSegmentBegin": 77059,
"ShortSegmentEnd": 103955
}
}
1
返回码
以下仅列出了接口业务逻辑相关的部分返回码,完整返回码请参考 全局返回码。
返回码 | 说明 | 处理建议 |
---|---|---|
320000004 | 参数非法。 | 请根据 Message 提示判断非法参数,调整对应参数值。 |
320010000 | AppId 不可用 | 请联系 ZEGO 技术支持开通版权音乐服务。 |
320010001 | 不支持的付费类型。 | 请联系 ZEGO 技术支持开通版权音乐对应的付费类型。
|
320050000 | 系统错误。 | 请联系 ZEGO 技术支持。 |
320050002 | 系统繁忙。 | 请稍后重试。 |
320050003 | 未定义的引擎错误。 | 请联系 ZEGO 技术支持。 |
320050004 | 引擎内部错误。 | 请联系 ZEGO 技术支持。 |