setEffectPosition abstract method
设置指定音效文件的播放位置。
通过此接口可以实现根据实际情况播放音效文件,而非从头到尾播放整个文件。
使用前提
请先调用 playEffect 接口播放音效文件。
调用时机
请在引擎初始化之后调用此接口,且该方法仅可在加入房间后调用。
参数说明
effectId
指定音效的 ID。每个音效均有唯一的 ID
position
指定音效文件的起始播放位置。单位为毫秒。
相关接口
- getEffectCurrentPosition:获取指定音效文件的当前播放位置。
- NERtcAudioEffectEventCallback.onAudioEffectTimestampUpdate:注册此回调实时获取指定音效文件的当前播放进度,默认为每隔 1s 返回一次。
返回值
- 0(OK):方法调用成功。
- 其他:方法调用失败。
- 30003(invalidParam):参数错误,比如 effectId 无效。
- 30005(invalidState):当前状态不支持的操作,比如找不到对应的音效任务或引擎尚未初始化。
Implementation
Future<int> setEffectPosition(int effectId, int position);