> **技术栈**：HarmonyOS 5.0 + ArkTS + @ohos.vibrator

>

> **适用场景**：按钮反馈、操作确认、游戏交互、手机排水

---

## 前言

触觉反馈是提升用户体验的重要手段。本文将介绍如何在HarmonyOS应用中使用震动API实现各种触觉交互效果。

## 一、震动API概述

HarmonyOS提供了`@ohos.vibrator`模块用于控制设备震动：

- **时长震动**：指定震动持续时间

- **预设效果**：使用系统预设的震动模式

- **自定义模式**：通过震动模式数组实现复杂效果

## 二、权限配置

```json

// module.json5

{

  "requestPermissions": [

    {

      "name": "ohos.permission.VIBRATE",

      "reason": "$string:vibrate_reason",

      "usedScene": {

        "abilities": ["EntryAbility"],

        "when": "inuse"

      }

    }

  ]

}

```

## 三、基础使用

### 3.1 简单震动

```typescript

import vibrator from '@ohos.vibrator';

// 震动100毫秒

async function simpleVibrate(): Promise<void> {

  try {

    await vibrator.startVibration({

      type: 'time',

      duration: 100

    }, {

      id: 0,

      usage: 'unknown'

    });

  } catch (err) {

    console.error('震动失败:', err);

  }

}

```

### 3.2 停止震动

```typescript

async function stopVibrate(): Promise<void> {

  try {

    await vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_TIME);

  } catch (err) {

    console.error('停止震动失败:', err);

  }

}

```

### 3.3 回调方式

```typescript

vibrator.startVibration({

  type: 'time',

  duration: 50

}, {

  id: 0,

  usage: 'notification'

}, (error) => {

  if (error) {

    console.error('震动失败:', error);

  }

});

```

## 四、实际应用场景

### 4.1 按钮点击反馈

```typescript

@Component

struct VibrationButton {

  @Prop text: string = '按钮';

  onClick: () => void = () => {};

  private async vibrateFeedback(): Promise<void> {

    try {

      await vibrator.startVibration({

        type: 'time',

        duration: 30  // 短促震动

      }, { id: 0, usage: 'touch' });

    } catch (err) {}

  }

  build() {

    Button(this.text)

      .onClick(() => {

        this.vibrateFeedback();

        this.onClick();

      })

  }

}

```

### 4.2 操作成功/失败反馈

```typescript

// 成功反馈 - 短促单次

async function successFeedback(): Promise<void> {

  await vibrator.startVibration({

    type: 'time',

    duration: 50

  }, { id: 0, usage: 'notification' });

}

// 失败反馈 - 连续两次

async function errorFeedback(): Promise<void> {

  await vibrator.startVibration({ type: 'time', duration: 100 }, { id: 0, usage: 'alarm' });

  await new Promise(resolve => setTimeout(resolve, 150));

  await vibrator.startVibration({ type: 'time', duration: 100 }, { id: 0, usage: 'alarm' });

}

```

### 4.3 手机排水场景

```typescript

export class AudioEngine {

  private enableVibration: boolean = false;

  setVibrationEnabled(enabled: boolean): void {

    this.enableVibration = enabled;

  }

  async start(durationSeconds: number): Promise<void> {

    // 启动音频播放...

   

    // 配合震动增强排水效果

    if (this.enableVibration) {

      this.startVibration();

    }

  }

  private startVibration(): void {

    const config = getAppConfig();

    if (config.feature.vibrationPattern.length > 0) {

      try {

        vibrator.startVibration({

          type: 'time',

          duration: 100

        }, {

          id: 0,

          usage: 'unknown'

        });

      } catch (err) {

        console.error('启动震动失败:', err);

      }

    }

  }

  private stopVibration(): void {

    try {

      vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_TIME);

    } catch (err) {

      console.error('停止震动失败:', err);

    }

  }

}

```

### 4.4 测试记录确认

```typescript

private recordThreshold(): void {

  // 记录测试结果...

  // 震动反馈确认

  try {

    vibrator.startVibration({

      type: 'time',

      duration: 50

    }, {

      id: 0,

      usage: 'notification'

    }, (error) => {

      if (error) {

        console.error('Vibration failed:', error);

      }

    });

  } catch (err) {

    console.error('Vibration exception:', err);

  }

}

```

## 五、震动配置管理

```typescript

export interface FeatureConfig {

  enableVibration: boolean;

  vibrationPattern: number[];  // [震动时长, 间隔, 震动时长, ...]

}

// 手机排水配置

export const WaterEjectorConfig = {

  feature: {

    enableVibration: true,

    vibrationPattern: [100, 50, 100, 50],  // 震动100ms, 停50ms, 震动100ms, 停50ms

  }

};

// 听力测试配置

export const HearingTestConfig = {

  feature: {

    enableVibration: false,  // 听力测试不需要震动

    vibrationPattern: [],

  }

};

```

## 六、用户设置控制

```typescript

@Entry

@Component

struct SettingsPage {

  @State vibrationEnabled: boolean = true;

  aboutToAppear(): void {

    this.loadSettings();

  }

  async loadSettings(): Promise<void> {

    this.vibrationEnabled = await PreferencesUtil.getBoolean('vibration_enabled', true);

  }

  async toggleVibration(): Promise<void> {

    this.vibrationEnabled = !this.vibrationEnabled;

    await PreferencesUtil.putBoolean('vibration_enabled', this.vibrationEnabled);

   

    // 更新音频引擎设置

    AudioEngine.getInstance().setVibrationEnabled(this.vibrationEnabled);

   

    // 反馈当前状态

    if (this.vibrationEnabled) {

      vibrator.startVibration({ type: 'time', duration: 50 }, { id: 0, usage: 'touch' });

    }

  }

  build() {

    Row() {

      Text('震动反馈')

      Toggle({ type: ToggleType.Switch, isOn: this.vibrationEnabled })

        .onChange(() => this.toggleVibration())

    }

  }

}

```

## 七、避坑指南

1. **权限声明**：必须在`module.json5`中声明`VIBRATE`权限

2. **异常处理**：震动API可能失败，需要try-catch

3. **用户控制**：提供开关让用户控制是否启用震动

4. **适度使用**：过度震动会影响用户体验和电池寿命

5. **设备兼容**：部分设备可能不支持震动

## 总结

本文介绍了HarmonyOS震动API的使用方法和实际应用场景。合理使用触觉反馈可以显著提升用户体验，但要注意适度使用并提供用户控制选项。

---

**🎓 我的HarmonyOS开发课堂**：[点击进入课堂学习](https://developer.huawei.com/consumer/cn/training/classDetail/03d6a547f8124d35aab33fc40840288f?type=1?ha_source=hmosclass&ha_sourceId=89000248)