KTV方案集成 FAQ

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

均设置为 60ms 一次。

A3. 分为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.getEngine().createMediaPlayer();
// 将播放器的流混入主流中
mediaPlayer.enableAux(true);

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

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