播放音效或音乐文件

// 设置音效 ID。
int EFFECT_ID = 1;
// 设置音效文件路径。
NSString *filePath = "your filepath";

// 设置音效 ID。
let EFFECT_ID:Int32 = 1
// 设置音效文件路径。
let filePath = "your filepath"

// 将指定的本地音效文件预加载至内存。
[agoraKit preloadEffect: EFFECT_ID filePath: filePath];
// 释放预加载的音效文件。
[agoraKit unloadEffect: EFFECT_ID];

// 将指定的本地音效文件预加载至内存。
agoraKit.preloadEffect(EFFECT_ID, filePath: filePath)
// 释放预加载的音效文件。
agoraKit.unloadEffect(EFFECT_ID)

// 设置音效循环播放的次数。-1 表示无限循环。
int loopCount = 1;
// 设置的音效的音调。取值范围为 [0.5, 2.0]。1.0 表示原始音调。
double pitch = 1;
// 设置的音效空间位置。取值范围为 [-1.0,1.0]。
// -1.0 表示音效出现在左边；0 表示音效出现在正前方；1 表示音效出现在右边。
double pan = 1;
// 设置音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
double gain = 100.0;
// 设置是否将音效发布至远端。true 表示本地用户和远端用户都能听到音效；false 表示只有本地用户能听到音效。 
BOOL publish = true;
// 设置音效文件的播放位置。500 表示从音效文件的第 500 ms 开始播放。
int startPos = 500; 
// 播放指定的音效文件。
[agoraKit playEffect: EFFECT_ID filePath: filePath loopCount: loopCount pitch: pitch pan: pan gain: gain publish: publish startPos: startPos];
// 本地音效文件播放已结束回调。
- (void)rtcEngineDidAudioEffectFinish:(AgoraRtcEngineKit* _Nonnull)engine EFFECT_ID;

// 设置音效循环播放的次数。-1 表示无限循环。 
let loopCount = 1
// 设置的音效的音调。取值范围为 [0.5, 2.0]。1.0 表示原始音调。
let pitch = 1
// 设置的音效空间位置。取值范围为 [-1.0,1.0]。
// -1.0 表示音效出现在左边；0 表示音效出现在正前方；1 表示音效出现在右边。
let pan = 1
// 设置音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
let gain = 100.0
// 设置是否将音效发布至远端。true 表示本地用户和远端用户都能听到音效；false 表示只有本地用户能听到音效。 
let publish = true
// 设置音效文件的播放位置。500 表示从音效文件的第 500 ms 开始播放。
let startPos = 500; 
// 播放指定的音效文件。
agoraKit.playEffect(EFFECT_ID, filePath: filePath, loopCount: Int32(loopCount), pitch: pitch, pan: pan, gain: gain, publish: publish, startPos: startPos)
// 本地音效文件播放已结束回调。 
func rtcEngineDidAudioEffectFinish(_ engine: AgoraRtcEngineKit, EFFECT_ID) {
}

// 停止播放指定的音效文件。
[agoraKit stopEffect: EFFECT_ID];
// 停止播放所有音效文件。
[agoraKit stopAllEffects];

// 停止播放指定的音效文件。
agoraKit.stopEffect(EFFECT_ID)
// 停止播放所有音效文件。
agoraKit.stopAllEffects()

// 暂停播放指定的音效文件。 
[agoraKit pauseEffect: EFFECT_ID];
// 暂停播放所有的音效文件。
[agoraKit pauseAllEffects];
// 恢复播放指定的音效文件。 
[agoraKit resumeEffect: EFFECT_ID];
// 恢复播放所有的音效文件。
[agoraKit resumeAllEffects];

// 暂停播放指定的音效文件。 
agoraKit.pauseEffect(EFFECT_ID)
// 暂停播放所有的音效文件。
agoraKit.pauseAllEffects()
// 恢复播放指定的音效文件。 
agoraKit.resumeEffect(EFFECT_ID)
// 恢复播放所有的音效文件。
agoraKit.resumeAllEffects()

// 获取指定本地音效文件的总时长。
[agoraKit getEffectDuration: filePath: filePath];
// 设置指定音效文件的播放位置。500 表示从音效文件的第 500 ms 开始播放。 
[agoraKit setEffectPosition: EFFECT_ID pos: 500];
// 获取指定音效文件的播放进度。
[agoraKit getEffectCurrentPosition: EFFECT_ID];

// 获取指定本地音效文件的总时长。 
agoraKit.getEffectDuration(filePath: filePath)
// 设置指定音效文件的播放位置。500 表示从音效文件的第 500 ms 开始播放。 
agoraKit.setEffectPosition(EFFECT_ID, pos: 500)
// 获取指定音效文件的播放进度。
agoraKit.getEffectCurrentPosition(EFFECT_ID)

// 设置所有音效文件的播放音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
[agoraKit setEffectsVolume: volume: 50.0];
// 设置指定音效文件的播放音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
[agoraKit setVolumeOfEffect: EFFECT_ID volume: 50.0];
// 获取音效文件的播放音量。音量范围为 [0.0,100.0]，100.0 表示原始音量。 
[agoraKit getEffectsVolume];

// 设置所有音效文件的播放音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
agoraKit.setEffectsVolume(volume: 50.0)
// 设置指定音效文件的播放音量。取值范围为 [0.0,100.0]，100.0 表示原始音量。 
agoraKit.setVolumeOfEffect(EFFECT_ID, volume: 50.0)
// 获取音效文件的播放音量。音量范围为 [0.0,100.0]，100.0 表示原始音量。 
agoraKit.getEffectsVolume()

// 设置音乐文件路径。
NSString *filePath = @"your file path";
// 设置是否只在本地播放音乐文件。true 表示只有本地用户能听到音乐；false 表示本地用户和远端用户都能听到音乐。
BOOL loopback = NO;
// 设置是否用音乐文件替换麦克风采集的音频。true 表示用户只能听到音乐；false 表示用户可以听到音乐和麦克风采集的音频。
BOOL replace = NO;
// 设置音乐文件的播放次数。1 表示播放 1 次。 
NSInteger cycle = 1;
// 设置音乐文件的播放位置。500 表示从音乐文件的第 500 ms 开始播放。 
NSInteger startPos = 500;
// 开始播放混音。
[agoraKit startAudioMixing: filePath loopback: loopback replace: replace cycle: cycle startPos: startPos];
// 本地音乐文件播放状态已改变回调。
- (void)rtcEngine:(AgoraRtcEngineKit* _Nonnull)engine localAudioMixingStateDidChanged:(AgoraAudioMixingStateCode)state reason:(AgoraAudioMixingReasonCode)reason;

// 设置音乐文件路径。
let filePath = "your file path"
// 设置是否只在本地播放音乐文件。true 表示只有本地用户能听到音乐；false 表示本地用户和远端用户都能听到音乐。
let loopback = false
// 设置是否用音乐文件替换麦克风采集的音频。true 表示用户只能听到音乐；false 表示用户可以听到音乐和麦克风采集的音频。
let replace = false
// 设置音乐文件的播放次数。1 表示播放 1 次。 
let cycle = 1
// 设置音乐文件的播放位置。500 表示从音乐文件的第 500 ms 开始播放。 
let startPos = 500
// 开始播放混音
agoraKit.startAudioMixing(filePath, loopback: loopback, replace: replace, cycle: cycle, startPos: startPos)
// 本地音乐文件播放状态已改变回调
func rtcEngine(_ engine: AgoraRtcEngineKit, localAudioMixingStateDidChanged state: AgoraAudioMixingStateCode, reason: AgoraAudioMixingReasonCode) {
}

// 停止播放音乐文件。
[agoraKit stopAudioMixing];

// 停止播放音乐文件。
agoraKit.stopAudioMixing()

// 暂停播放音乐文件。 
[agoraKit pauseAudioMixing];
// 恢复播放音乐文件。 
[agoraKit resumeAudioMixing];

// 暂停播放音乐文件。 
agoraKit.pauseAudioMixing()
// 恢复播放音乐文件。 
agoraKit.resumeAudioMixing()

// 获取当前音乐文件的总时长。 
[agoraKit getAudioMixingDuration];
// 设置当前音乐文件的播放位置。500 表示从音乐文件的第 500 ms 开始播放。 
[agoraKit setAudioMixingPosition: pos: 500];
// 获取当前音乐文件的播放位置。 
[agoraKit getEffectCurrentPosition];

// 获取当前音乐文件的总时长。 
agoraKit.getAudioMixingDuration()
// 设置当前音乐文件的播放位置。500 表示从音乐文件的第 500 ms 开始播放。 
agoraKit.setAudioMixingPosition(pos: 500)
// 获取当前音乐文件的播放位置。 
agoraKit.getEffectCurrentPosition()

// 调节当前音乐文件在本地和远端的播放音量。取值范围为 [0,100]，100 表示原始音量。 
[agoraKit adjustAudioMixingVolume: volume: 50];
// 调节当前音乐文件在远端的播放音量。取值范围为 [0,100]，100 表示原始音量。 
[agoraKit adjustAudioMixingPublishVolume: volume: 50];
// 调节当前音乐文件在本地的播放音量。取值范围为 [0,100]，100 表示原始音量。 
[agoraKit adjustAudioMixingPlayoutVolume: volume: 50];
// 获取当前音乐文件在本地的播放音量。音量范围为 [0,100]，100 表示原始音量。 
[agoraKit getAudioMixingPlayoutVolume];
// 获取当前音乐文件在远端的播放音量。音量范围为 [0,100]，100 表示原始音量。 
[agoraKit getAudioMixingPublishVolume];
// 调节当前音乐文件的音调。取值范围为 [-12,12]，0 表示原始音调，1 表示升高一个半音。
[agoraKit setAudioMixingPitch: pitch: 5];

// 调节当前音乐文件在本地和远端的播放音量。取值范围为 [0,100]，100 表示原始音量。 
agoraKit.adjustAudioMixingVolume(volume: 50)
// 调节当前音乐文件在远端的播放音量。取值范围为 [0,100]，100 表示原始音量。 
agoraKit.adjustAudioMixingPublishVolume(volume: 50)
// 调节当前音乐文件在本地的播放音量。取值范围为 [0,100]，100 表示原始音量。 
agoraKit.adjustAudioMixingPlayoutVolume(volume: 50)
// 获取当前音乐文件在本地的播放音量。音量范围为 [0,100]，100 表示原始音量。 
agoraKit.getAudioMixingPlayoutVolume()
// 获取当前音乐文件在远端的播放音量。音量范围为 [0,100]，100 表示原始音量。 
agoraKit.getAudioMixingPublishVolume()
// 调节当前音乐文件的音调。取值范围为 [-12,12]，0 表示原始音调，1 表示升高一个半音。
agoraKit.setAudioMixingPitch(pitch: 5)

//声网推荐取值范围为 [50,400]。其中，50 表示 0.5 倍速，100 表示原始速度，400 表示 4 倍速。
[agoraKit setAudioMixingPlaybackSpeed: speed: 50];

//声网推荐取值范围为 [50,400]。其中，50 表示 0.5 倍速，100 表示原始速度，400 表示 4 倍速。
agoraKit.setAudioMixingPlaybackSpeed(speed: 50)

// 获取当前音乐文件的音轨数量。
[agoraKit getAudioTrackCount];
// 指定音乐文件的音轨进行播放。指定音轨的索引取值范围为 [0, getAudioTrackCount())。
[agoraKit selectAudioTrack: index: 2];

// 获取当前音乐文件的音轨数量。
agoraKit.getAudioTrackCount()
// 指定音乐文件的音轨进行播放。指定音轨的索引取值范围为 [0, getAudioTrackCount())。
agoraKit.selectAudioTrack(index: 2)

[agoraKit setAudioMixingDualMonoMode: AgoraAudioMixingDualMonoAuto];

agoraKit.setAudioMixingDualMonoMode(.auto)