setMusicPitch method
@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]);
}