KTV方案集成 FAQ

只有带有伴奏的歌曲才可以切换原唱和伴奏。

均设置为 60ms 一次。

分为SQ（Standard Quality）、HQ、无损音乐（暂无），音质不同大小不同。歌曲：SQ是3-4M，HQ6-7M，伴奏：单音轨默认都是SQ等级，双音轨是10M左右。下载时间根据具体的下载网络类型和网速而定，如4G下行10M/s，下载时间在1s以内。

可能造成的原因是：

• 用户当前网络差；
• 没有开启超低延迟模式；
• jitterbuffer水位设置过高。

没有开启混流对齐配置，总共有3个接口:

• startPublishingStreamWithConfig(forceSynchronousNetworkTime = 1)；
• setStreamAlignmentProperty；
• ZegoMixerTask setStreamAlignmentMode = 1。

麦上的用户拉流的 jitterbuffer 水位过低。网络存在抖动。麦上用户推荐值是(30,30)，观众是(500,100)。

可能是因为开发者没有使用合唱示例源码，自行实现倒计时同步逻辑，导致存在误差。

请查看是否开了 DTX，影响了 SEI 发送。

可能有以下原因：

• 重复设置了 setEventHandler 事件回调代理；
• 推流端没发 SEI；
• 拉流端没拉带有 SEI 的流。

请查看每次播放时有没有重新推伴奏流并更新混流。

Express 需要 advancedConfig("audio_loopback_after_prep":"true")。

请检查是否设置辅路流的数据来源，需要设置音频外部采集。

需要使用合唱示例源码的中途加入合唱对齐功能实现。

需要集成伴奏对齐功能，可以参考合唱示例源码实现。

房主下载歌曲时，如果某些歌曲下载异常，例如已下架，则会上报后台该歌曲下载失败，后台会将歌曲从歌单剔除，所以歌曲会变少。

segment_begin、segment_end 这两个字段用来定位高潮片段在整首歌中的起始位置和结束位置，单位均为毫秒，下载到的资源即 segment_begin ~ segment_end 这段，时长为 segment_end - segment_begin 的值。

prelude_duration 这个字段描述的是高潮前奏的时长，单位毫秒，前奏是包含在 segment_begin ~ segment_end 这段里面的。

以下代码供您参考：

// 创建媒体播放器
ZegoMediaPlayer *mediaPlayer = [[ZegoExpressEngine sharedEngine] createMediaPlayer];
// 将播放器的流混入主流中
[mediaPlayer enableAux:YES];
// 推流
[[ZegoExpressEngine sharedEngine] startPublishingStream:@"my_stream_id"];

更多详情可参考 ZegoExpressSDK API 文档的 enableAux 接口。

A5. 由于客户端拉流建立链接需要短暂时间，因此为了保证拉流端的歌曲聆听体验，在某些状态会提前进行推流（状态 round_preparing、next_song_preparing）；拉流同理。