## requestAnimationFrame(callback: (timestamp: number) => void): number @requestanimationframe
在下一次重绘之前,调用用户提供的回调函数
### requestAnimationFrame 兼容性
Web: 4.0; 微信小程序: x; 支付宝小程序: x; Android: 4.25; iOS: 4.25; iOS(VDOM) UTS 插件: x; HarmonyOS: 4.61
### 参数
| 名称 | 类型 | 必填 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| callback | (timestamp: number) => void | 是 | 微信小程序: x; 支付宝小程序: x | 下一次重绘前执行的回调函数,timestamp 为时间戳。 |
### 返回值
| 类型 | 描述 |
| :- | :- |
| number | 动画帧请求 ID,可用于 cancelAnimationFrame。 |
## cancelAnimationFrame(taskId: number): void @cancelanimationframe
取消一个先前通过调用 requestAnimationFrame() 方法添加到计划中的动画帧请求
### cancelAnimationFrame 兼容性
Web: 4.0; 微信小程序: x; 支付宝小程序: x; Android: 4.25; iOS: 4.25; iOS(VDOM) UTS 插件: x; HarmonyOS: 4.61
### 参数
| 名称 | 类型 | 必填 | 兼容性 | 描述 |
| :- | :- | :- | :-: | :- |
| taskId | number | 是 | 微信小程序: x; 支付宝小程序: x | requestAnimationFrame 返回的请求 ID。 |
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/animation-frame/animation-frame.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/animation-frame/animation-frame.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/animation-frame/animation-frame
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/animation-frame/animation-frame
>示例
```vue
FPS: {{data.FPSString}}
FrameCount: {{data.testFrameCount}}
提示: 重复点击会忽略重复启动,避免创建多个并行的 requestAnimationFrame 循环
```
:::
**提示**
- requestAnimationFrame/cancelAnimationFrame 为全局 API,如果需要跨平台处理 canvas 动画应使用 [uni.createCanvasContextAsync](./create-canvas-context-async.md)
- `Android uni-app x` requestAnimationframe 目前仅支持有参数callback,示例:`requestAnimationFrame((timestamp : number) => {})`
## 高刷专题@High-refresh-rate
早期手机的刷新率为60Hz,后来陆续出现90Hz、120Hz、144Hz等更高刷新率。
更高的刷新率意味着UI更丝滑,但也更费电。
60Hz的刷新率是16.6ms绘制一帧图像,而120高刷是8.3ms绘制一帧。
如何在流畅和节电之间取舍,是手机系统厂商、app开发者、最终用户的3方平衡,在不同手机系统中的表现也不相同。
通用的规则有:
1. 手机进入节能模式时,会关闭高刷
2. 部分手机提供给用户手动开启/关闭高刷的设置
3. 除非在节能模式下,否则应用在滚动时会自动开启高刷,这点无需应用申请
4. 某些动画、帧回调API,需要应用开发者主动申请高刷。但手机厂商仍然会选择性允许,这种选择规则各厂商不同且大多不公开,可能存在包名白名单。而如果应用不申请,则这些API无法获取到高刷的细腻体验。
具体到uni-app x的情况:
- iOS平台,从HBuilderX 5.21+,requestAnimationFrame 接口支持申请高刷新率。css动画和UniElement.animate动画一直支持高刷。web-view组件,被iOS强制限制在60Hz,网页内无法体验高刷。
- 安卓和鸿蒙平台,从HBuilderX 5.22+,requestAnimationFrame 以及 CSS 动画和UniElement.animate动画支持申请高刷。
- 暂未提供关闭申请高刷的设置
注意无论哪个平台,最终高刷是否生效仍受手机系统策略以及用户设置影响。