setMusicPitch method

FutureOr<void> setMusicPitch(
  1. NSString musicId,
  2. int pitch
)

@detail api @author lihuan.wuti2ha @brief 对播放中的音乐设置升降调信息。 @param musicId 音乐 ID。 @param pitch 相对于音乐文件原始音调的升高/降低值,取值范围 -12,12,默认值为 0,即不做调整。
取值范围内每相邻两个值的音高距离相差半音,正值表示升调,负值表示降调,设置的绝对值越大表示音调升高或降低越多。 @note - 调用本接口时音乐必须处于播放中状态。 - 若设置的 pitch 大于 12,则按最大值 12 进行调整;若设置的 pitch 小于 –12,,则按最小值 –12 进行调整。 - 若音乐 ID 错误,会触发 ktvPlayer:onPlayStateChanged:state:error:{@link #ByteRTCKTVPlayerDelegate#ktvPlayer:onPlayStateChanged:state:error} 回调,errorCode 为 –3023,playState 为 4。 - 若未进房,会触发 ktvPlayer:onPlayStateChanged:state:error:{@link #ByteRTCKTVPlayerDelegate#ktvPlayer:onPlayStateChanged:state:error} 回调,errorCode 为 –3022,playState 为 4。

Implementation

FutureOr<void> setMusicPitch(NSString musicId, int pitch) async {
  return await nativeCall('setMusicPitch:pitch:', [musicId, pitch]);
}