AgoraAudioFrameDelegate
音频观测器。
你可以调用 setAudioFrameDelegate 注册或取消注册 AgoraAudioFrameDelegate 音频观测器。
onEarMonitoringAudioFrame
获得耳返的原始音频数据。
- (BOOL)onEarMonitoringAudioFrame:(AgoraAudioFrame* _Nonnull)frame;
- 你需要在加入频道前,调用 setAudioFrameDelegate 注册音频观测器对象,即注册 onEarMonitoringAudioFrame 回调。
- 为保证获得的耳返音频数据格式符合预期,声网推荐你在如下两种方式中选其一设置耳返音频数据格式:
- 调用 setEarMonitoringAudioFrameParametersWithSampleRate 设置获取的耳返音频数据格式,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 onEarMonitoringAudioFrame 回调。
- 在 getEarMonitoringAudioParams 回调的返回值中设置获取的耳返音频数据格式,SDK 会根据该回调的返回值计算采样间隔,并根据该采样间隔触发 onEarMonitoringAudioFrame 回调。
参数
- frame
- 音频原始数据。详见 AgoraAudioFrame。
返回值
无实际含义。
onMixedAudioFrame
获取采集和播放音频混音后的数据。
- (BOOL)onMixedAudioFrame:(AgoraAudioFrame* _Nonnull)frame;
- 你需要在加入频道前,调用 setAudioFrameDelegate 注册音频观测器对象,即注册 onMixedAudioFrame 回调。
- 该回调仅报告单通道数据。
- 为保证采集和播放音频混音后的数据格式符合预期,Agora 推荐你在如下两种方式中选其一设置采集和播放音频混音后的音频数据格式:
- 调用 setMixedAudioFrameParametersWithSampleRate 设置音频数据格式,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 onMixedAudioFrame 回调。
- 在 getMixedAudioParams 回调的返回值中设置音频数据格式,SDK 会根据该回调的返回值计算采样间隔,并根据该采样间隔触发 onMixedAudioFrame 回调。
参数
- frame
- 音频原始数据。详见 AgoraAudioFrame。
返回值
无实际含义。
onPlaybackAudioFrame
获得播放的原始音频数据。
- (BOOL)onPlaybackAudioFrame:(AgoraAudioFrame* _Nonnull)frame;
- 你需要在加入频道前,调用 setAudioFrameDelegate 注册音频观测器对象,即注册 onPlaybackAudioFrame 回调。
- 为保证播放的音频数据格式符合预期,Agora 推荐你在如下两种方式中选其一设置播放的音频数据格式:
- 调用 setPlaybackAudioFrameParametersWithSampleRate 设置音频数据格式,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 onPlaybackAudioFrame 回调。
- 在 getPlaybackAudioParams 回调的返回值中设置音频数据格式,SDK 会根据该回调的返回值计算采样间隔,并根据该采样间隔触发 onPlaybackAudioFrame 回调。
参数
- frame
- 音频原始数据。详见 AgoraAudioFrame。
返回值
无实际含义。
onPlaybackAudioFrameBeforeMixing
获得混音前的指定用户的声音。
- (BOOL)onPlaybackAudioFrameBeforeMixing:(AgoraAudioFrame* _Nonnull)frame uid:(NSUInteger)uid;
参数
- uid
- 指定用户的用户 ID。
- frame
- 音频原始数据。详见 AgoraAudioFrame。
返回值
无实际含义。
onRecordAudioFrame
获得采集的原始音频数据。
- (BOOL)onRecordAudioFrame:(AgoraAudioFrame* _Nonnull)frame;
- 你需要在加入频道前,调用 setAudioFrameDelegate 注册音频观测器对象,即注册 onRecordAudioFrame 回调。
- 为保证采集到的音频数据格式符合预期,Agora 推荐你在如下两种方式中选其一设置采集到的音频数据格式:
- 调用 setRecordingAudioFrameParametersWithSampleRate 设置获取的耳返音频数据格式,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 onRecordAudioFrame 回调。
- 在 getRecordAudioParams 回调的返回值中设置获取的耳返音频数据格式,SDK 会根据该回调的返回值计算采样间隔,并根据该采样间隔触发 onRecordAudioFrame 回调。
参数
- frame
- 音频原始数据。详见 AgoraAudioFrame。
返回值
无实际含义。
getRecordAudioParams
设置 onRecordAudioFrame 回调数据的格式。
- (AgoraAudioParams* _Nonnull)getRecordAudioParams NS_SWIFT_NAME(getRecordAudioParams());
你需要在调用 setAudioFrameDelegate 方法时注册该回调。成功注册音频数据观测器后,SDK 会触发该回调,你可以在该回调的返回值中设置 SDK 采集的音频数据格式。
SDK 会通过你在返回值中设置的 AgoraAudioParams 计算采样间隔触发 onRecordAudioFrame 回调。计算公式为采样间隔 = samplesPerCall/(sampleRate × channel)。
请确保采样间隔不小于 0.01 秒。
返回值
SDK 采集的音频数据,详见 AgoraAudioParams。
getMixedAudioParams
设置 onMixedAudioFrame 回调数据的格式。
- (AgoraAudioParams* _Nonnull)getMixedAudioParams NS_SWIFT_NAME(getMixedAudioParams());
你需要在调用 setAudioFrameDelegate 方法时注册该回调。成功注册音频数据观测器后,SDK 会触发该回调,你可以在该回调的返回值中设置 SDK 采集和播放音频混音后的数据格式。
SDK 会通过你在返回值中设置的 AgoraAudioParams 计算采样间隔触发 onMixedAudioFrame 回调。计算公式为采样间隔 = samplesPerCall/(sampleRate × channel)。
请确保采样间隔不小于 0.01 秒。
返回值
SDK 采集和播放音频混音后的音频数据,详见 AgoraAudioParams。
getPlaybackAudioParams
设置 onPlaybackAudioFrame 回调数据的格式。
- (AgoraAudioParams* _Nonnull)getPlaybackAudioParams NS_SWIFT_NAME(getPlaybackAudioParams());
你需要在调用 setAudioFrameDelegate 方法时注册该回调。成功注册音频数据观测器后,SDK 会触发该回调,你可以在该回调的返回值中设置 SDK 播放的音频数据格式。
SDK 会通过你在返回值中设置的 AgoraAudioParams 计算采样间隔触发 onPlaybackAudioFrame 回调。计算公式为采样间隔 = samplesPerCall/(sampleRate × channel)。
请确保采样间隔不小于 0.01 秒。
返回值
SDK 播放的音频数据,详见 AgoraAudioParams。
getEarMonitoringAudioParams
设置 onEarMonitoringAudioFrame 回调数据的格式。
- (AgoraAudioParams* _Nonnull)getEarMonitoringAudioParams NS_SWIFT_NAME(getEarMonitoringAudioParams());
- 自从
- v4.0.1
你需要在调用 setAudioFrameDelegate 方法时注册该回调。成功注册音频数据观测器后,SDK 会触发该回调,你可以在该回调的返回值中设置耳返的音频数据格式。
SDK 会通过你在返回值中设置的 AgoraAudioParams 计算采样间隔触发 onEarMonitoringAudioFrame 回调。计算公式为采样间隔 = samplesPerCall/(sampleRate × channel)。
请确保采样间隔不小于 0.01 秒。
返回值
耳返的音频数据,详见 AgoraAudioParams。