# Vibrator

### Introduction

This sample simulates the countdown scenario to show the use of the vibrator APIs. Below shows the sample app.

![](./screenshots/device/vibratorTime.jpeg)

### Functions

You can trigger a vibrator to vibrate by duration or vibration effect.

### Required Permissions

ohos.permission.VIBRATE

### Usage

1. Touch the countdown text. A time picker is displayed. Select any time and touch **OK**. The selected time is displayed as the countdown text.

2. Touch **start**. The countdown starts, and the round progress bar and countdown text start changing. When the countdown ends, the device vibrates, the progress bar returns to the initial state, and a vibration dialog box is displayed.

3. Touch **reset**. The countdown ends, and the round progress bar and countdown text are restored to the initial state.

### Constraints

1. This sample can only be run on standard-system devices.

2. This sample requires a device with a vibrator.

3. This sample requires DevEco Studio 3.1 Canary1 (Build Version: 3.1.0.100) to compile and run.

# 振动

### 介绍

本示例模拟倒计时场景，通过[@ohos.vibrator](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-sensor-service-kit/js-apis-vibrator.md) 等接口来实现振动。

### 效果预览

|设置倒计时间|振动倒计时|
|--------------------------------|--------------------------------|
|![](./screenshots/device/setTime.jpeg)|![](./screenshots/device/vibratorTime.jpeg)|

使用说明

1.点击倒计时文本，弹出时间选择框，选择任意时间，点击**确认**，倒计时文本显示选择的时间。

2.点击**start**，开始倒计时，圆形进度条和文本开始变化；倒计时结束，开始振动，进度条恢复初始状态并且弹出振动提示框，按照描述进行选择。

3.点击**reset**，可以结束倒计时并使文本和进度条恢复初始状态。

### 工程目录
```
entry/src/main/ets/
|---common
|   |---TextDialog.ts                   // 弹窗组件
|   |---TextTimeComponent.ts            // 内容模块
|   |---TimerPicker.ts                  // TimerPicker模块
|   |---TitleBar.ts                     // 标题组件
|---mode
|   |---Logger.ts                       // 日志工具
|   |---TimerData.ts                    // 时间数据
|---page
|   |---Index.ets                       // 首页
```

### 具体实现

* 本示例实现振动的方法主要封装在TextTimerComponent中，源码参考: [TextTimerComponent](entry/src/main/ets/MainAbility/common/TextTimerComponent.ets) 。
    * 设置倒计时间：Timepicker文件中通过TextPicker组件来设置倒计的时间，并将设定的时间数据双向绑定到TextTimerComponent组件当中。
    * 启动倒计时：点击start按钮通过setInterval执行倒计时，每隔一段时间Process组件的进度值会被此代码this.progressValue += TOTAL / this.duration进行处理同步刷新。
    * 触发振动：当时间为0的时候，则执行vibrator.vibrate()方法去触发振动效果。
    * 初始化时间：点击reset按钮会将Process组件的value以及时间进行初始化，并清除定时器。

### 相关权限

[ohos.permission.VIBRATE](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionvibrate)

### 依赖

不涉及。

### 约束与限制

1.本示例仅支持标准系统上运行。

2.本示例需要使用有振动器的设备测试。

3.本示例已适配API version 14版本SDK，版本号：5.0.2.123。

4.本示例需要使用DevEco Studio 5.0.2 Release (Build Version: 5.0.7.210 构建 2025年2月11日)及以上版本才可编译运行。

### 下载

如需单独下载本工程，执行如下命令：
```
git init
git config core.sparsecheckout true
echo code/BasicFeature/DeviceManagement/Vibrator/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
```