##鸿蒙核心技术##运动开发##Media Kit（媒体服务）#

前言

在运动过程中，保持稳定的节奏对于提升运动效果至关重要。无论是跑步、骑自行车还是进行高强度间歇训练（HIIT），一个精准的节拍器都能帮助你更好地控制运动节奏，从而达到更好的锻炼效果。本文将结合鸿蒙（HarmonyOS）开发实战经验，深入解析如何开发一个运动节拍器，让你在运动中也能轻松掌握节奏。

一、为什么选择 SoundPool 而不是 AVPlayer

在开发运动节拍器时，我们选择了SoundPool而不是AVPlayer。这是因为SoundPool在播放短促的提示音时表现更为出色，能够快速响应并确保音效的及时播放，这对于需要精确控制节奏的运动节拍器来说至关重要。而AVPlayer更适合用于播放长音频文件，如音乐或视频，其响应速度和音效播放的即时性不如SoundPool。

二、运动节拍器的核心逻辑

1.初始化音效

在节拍器启动前，我们需要加载音效文件并初始化SoundPool。以下是初始化音效的核心代码：

async initSound() {
  this.soundPool = await media.createSoundPool(1, {
    usage: audio.StreamUsage.STREAM_USAGE_MUSIC, // 音频流使用类型：音乐
    rendererFlags: 1
  });

  const context = getContext(this) as common.UIAbilityContext;
  const fd = context.resourceManager.getRawFdSync('medias/metronome2.mp3'); // 建议使用短促"嘀"声
  this.soundId = await this.soundPool.load(
    fd.fd,
    fd.offset,
    fd.length
  );
}

2.节拍器播放逻辑

节拍器的核心逻辑是根据设置的 BPM（每分钟节拍数）定时播放音效，并在每次播放时触发视觉提示（如闪光）。以下是节拍器播放逻辑的核心代码：

startMetronome() {
  if (this.isPlaying) return;

  this.isPlaying = true;
  const interval = 60000 / this.bpm; // 节拍间隔

  const playWithFlash = () => {
    this.flashActive = true;
    setTimeout(() => this.flashActive = false, 100); // 在 100 毫秒后将 flashActive 设置为 false，恢复视觉状态。

    if (this.soundPool && this.soundId !== -1) {
      this.soundPool.play(this.soundId, {
        loop: 0,
        rate: 1.0,
        leftVolume: 1.0, // 最大音量确保运动时能听见
        rightVolume: 1.0,
        priority: 0
      });
    }

    this.timerId = setTimeout(playWithFlash, interval);
  };

  playWithFlash();
}

3.停止节拍器

停止节拍器时，我们需要清除定时器并释放SoundPool资源。以下是停止节拍器的核心代码：

stopMetronome() {
  this.isPlaying = false;
  clearTimeout(this.timerId);
}

三、用户界面设计

为了让用户能够方便地控制节拍器，我们需要设计一个简洁直观的用户界面。以下是用户界面的核心代码：

build() {
  Column() {
    // 大号视觉提示区
    Circle()
      .width(200)
      .height(200)
      .fill(this.flashActive ? Color.Red : Color.White)
      .margin({ bottom: 40 })
      .animation({ duration: 50, curve: Curve.EaseIn })

    // 超大 BPM 显示
    Text(`${this.bpm}`)
      .fontSize(60)
      .fontWeight(FontWeight.Bold)
      .margin({ bottom: 30 })

    // 运动专用 BPM 范围滑块
    Slider({
      value: this.bpm,
      min: 40,  // 最低有效运动节奏
      max: 200, // 高强度间歇训练上限
      step: 1
    })
      .width('90%')
      .height(60)
      .onChange((value: number) => {
        this.bpm = value;
        if (this.isPlaying) {
          this.stopMetronome();
          this.startMetronome();
        }
      })

    // 运动场景专用控制按钮
    Button(this.isPlaying ? '停止运动' : '开始运动')
      .width(200)
      .height(80)
      .fontSize(24)
      .backgroundColor(this.isPlaying ? Color.Red : Color.Green)
      .onClick(() => {
        this.isPlaying ? this.stopMetronome() : this.startMetronome();
      })
  }
  .width('100%')
  .height('100%')
  .justifyContent(FlexAlign.Center)
}

核心点解析

• 视觉提示：通过Circle组件和flashActive状态，实现视觉上的节拍提示。

• BPM 显示：通过Text组件显示当前的 BPM 值，让用户能够直观地看到节拍频率。

• BPM 调整：通过Slider组件允许用户调整 BPM 值，并在调整后自动更新节拍器频率。

• 控制按钮：通过Button组件实现节拍器的启动和停止功能。

四、优化与改进

1.根据运动步频设置节拍器频率

为了更好地适应用户的运动节奏，我们可以根据用户的步频动态调整节拍器的频率。我之前的文章中有如何获取步频步幅。

private async updateBpmFromStepFrequency() {
  // 获取当前步频
  const currentStepFrequency = await this.getStepFrequency();
  this.bpm = Math.round(currentStepFrequency * 60); // 将步频转换为 BPM
  if (this.isPlaying) {
    this.stopMetronome();
    this.startMetronome();
  }
}

2.增加音效选择功能

为了满足不同用户的需求，可以增加音效选择功能，允许用户选择不同的提示音。例如，提供多种音效文件供用户选择。

private soundOptions: string[] = ['metronome1.mp3', 'metronome2.mp3', 'metronome3.mp3'];
private selectedSoundIndex: number = 0;

private async loadSound() {
  const context = getContext(this) as common.UIAbilityContext;
  const fd = context.resourceManager.getRawFdSync(`medias/${this.soundOptions[this.selectedSoundIndex]}`);
  this.soundId = await this.soundPool.load(
    fd.fd,
    fd.offset,
    fd.length
  );
}

3.优化视觉提示效果

为了提升用户体验，可以进一步优化视觉提示效果，例如增加动画效果或改变提示颜色。

Circle()
  .width(200)
  .height(200)
  .fill(this.flashActive ? Color.Red : Color.White)
  .margin({ bottom: 40 })
  .animation({ duration: 100, curve: Curve.EaseInOut }) // 增加动画效果

五、总结

通过鸿蒙的SoundPool和相关 API，我们可以轻松开发一个功能强大的运动节拍器。