虚拟节拍器
- Flutter
更新时间不可用
configRhythmPlayer
配置虚拟节拍器。
Future<void> configRhythmPlayer(AgoraRhythmPlayerConfig config);废弃
自 v6.6.2 版本废弃。
- 调用 startRhythmPlayer 后，你可以调用该方法重新配置虚拟节拍器。
- 开启虚拟节拍器后，SDK 会从头开始播放指定的音频文件，并根据你在 AgoraRhythmPlayerConfig 中设置的
beatsPerMinute控制每个文件的播放时长。例如，将beatsPerMinute设为60，则 SDK 会 1 秒播放 1 个节拍。如果文件时长超过了节拍时长，则 SDK 只播放节拍时长部分的音频。 - 虚拟节拍器的声音默认不会发布至远端，如果你希望远端用户听到虚拟节拍器的声音，你可以在调用该方法后，将 ChannelMediaOptions 中的
publishRhythmPlayerTrack设为 true。
调用时机
加入频道前后均可调用。
相关回调
成功调用该方法后，SDK 会在本地触发 onRhythmPlayerStateChanged 回调，报告虚拟节拍器的状态。
参数
| 参数名 | 描述 |
|---|---|
config | 节拍器配置。详见 AgoraRhythmPlayerConfig。 |
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类
startRhythmPlayer
开启虚拟节拍器。
Future<void> startRhythmPlayer(
{required String sound1,
required String sound2,
required AgoraRhythmPlayerConfig config});废弃
自 v6.6.2 版本废弃。
- 开启虚拟节拍器后，SDK 会从头开始播放指定的音频文件，并根据你在 AgoraRhythmPlayerConfig 中设置的
beatsPerMinute控制每个文件的播放时长。例如，将beatsPerMinute设为60，则 SDK 会 1 秒播放 1 个节拍。如果文件时长超过了节拍时长，则 SDK 只播放节拍时长部分的音频。 - 虚拟节拍器的声音默认不会发布至远端，如果你希望远端用户听到虚拟节拍器的声音，你可以在调用该方法后，将 ChannelMediaOptions 中的
publishRhythmPlayerTrack设为 true。
适用场景
在音乐教学、体育教学等场景中，老师通常需要使用节拍器，让学生跟着正确的节拍练习。节拍由强拍和弱拍组成，每小节的第一拍称为强拍，其余称为弱拍。
调用时机
加入频道前后均可调用。
相关回调
成功调用该方法后，SDK 会在本地触发 onRhythmPlayerStateChanged 回调，报告虚拟节拍器的状态。
参数
| 参数名 | 描述 |
|---|---|
sound1 | 强拍文件的绝对路径或 URL 地址，需精确到文件名及后缀。例如 |
sound2 | 弱拍文件的绝对路径或 URL 地址，需精确到文件名及后缀。例如 |
config | 节拍器配置。详见 AgoraRhythmPlayerConfig。 |
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类
stopRhythmPlayer
关闭虚拟节拍器。
Future<void> stopRhythmPlayer();废弃
自 v6.6.2 版本废弃。
调用 startRhythmPlayer 后，你可以调用该方法关闭虚拟节拍器。
注： 该方法仅适用于 Android 和 iOS。
返回值
方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
所属接口类
onRhythmPlayerStateChanged
虚拟节拍器状态发生改变回调。
final void Function(RhythmPlayerStateType state, RhythmPlayerReason reason)?
onRhythmPlayerStateChanged;废弃
自 v6.6.2 版本废弃。
虚拟节拍器状态发生改变时，SDK 会触发该回调报告当前的虚拟节拍器状态。在虚拟节拍器出现故障时，该回调可以帮助你了解当前虚拟节拍的状态以及出现故障的原因，方便你排查问题。
注： 该回调仅适用于 Android 和 iOS。
参数
| 参数名 | 描述 |
|---|---|
state | 当前的虚拟节拍器状态，详见 RhythmPlayerStateType。 |
reason | 虚拟节拍器发生错误的错误码和错误信息，详见 RhythmPlayerReason。 |