请求UI绘制帧率
========

如果开发者需要以独立的帧率绘制更新操作UI界面时，可以通过DisplaySync来实现。应用中绘制内容的帧率可以使用DisplaySync实例来控制，具体请查阅[@ohos.graphics.displaySync (可变帧率)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-displaysync)。

#### 开发步骤

此处以不同帧率改变文本组件字体大小为例，来模拟不同UI绘制帧率的效果。

1.  导入模块。
    
    import { displaySync } from '@kit.ArkGraphics2D';
    
2.  定义和构建DisplaySync对象。
    
    @Entry
    @Component
    struct Index {
      // ...
    
      private backDisplaySyncSlow: displaySync.DisplaySync | undefined = undefined;
      private backDisplaySyncFast: displaySync.DisplaySync | undefined = undefined;
      // ...
    }
    
3.  定义两个文本组件。
    
    @State drawFirstSize: number = 25;
    @State drawSecondSize: number = 25;
    
    // ...
    
    @Builder
    doSomeRenderFirst() {
      Text('30')
        .fontSize(this.drawFirstSize)
    }
    
    @Builder
    doSomeRenderSecond() {
      Text('60')
        .fontSize(this.drawSecondSize)
    }
    
4.  通过DisplaySync实例设置帧率和注册订阅函数。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/99/v3/vdQj1eKpTWSMVJ4jhwnSig/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132544Z&HW-CC-Expire=86400&HW-CC-Sign=A04BB5AE605A44F974F26A0C6CF6C9E6A4E2B58888BD8E4FF317D529BA3C4F83)
    
    订阅函数运行于UI主线程，故涉及UI线程的耗时操作不应运行于订阅函数中，以免影响性能。
    
    CreateDisplaySyncSlow() {
      let range: ExpectedFrameRateRange = {
        expected: 30,
        min: 0,
        max: 120
      };
    
      let draw30 = (intervalInfo: displaySync.IntervalInfo) => {
        if (this.isBigger\_30) {
          this.drawFirstSize += 1;
          if (this.drawFirstSize > 150) {
            this.isBigger\_30 = false;
          }
        } else {
          this.drawFirstSize -= 1;
          if (this.drawFirstSize < 25) {
            this.isBigger\_30 = true;
          }
        }
      };
    
      this.backDisplaySyncSlow = displaySync.create();
      this.backDisplaySyncSlow.setExpectedFrameRateRange(range);
      this.backDisplaySyncSlow.on("frame", draw30);
    }
    
5.  开始每帧回调。
    
    Button('Start')
      .id('CustomDrawStart')
      .fontSize(14)
      .fontWeight(500)
      .margin({ bottom: 10, left: 5 })
      .fontColor(Color.White)
      .onClick((): void => {
        if (this.backDisplaySyncSlow == undefined) {
          this.CreateDisplaySyncSlow();
        }
        if (this.backDisplaySyncFast == undefined) {
          this.CreateDisplaySyncFast();
        }
        if (this.backDisplaySyncSlow) {
          this.backDisplaySyncSlow.start();
        }
        if (this.backDisplaySyncFast) {
          this.backDisplaySyncFast.start();
        }
      })
      .width('20%')
      .height(40)
      .shadow(ShadowStyle.OUTER\_DEFAULT\_LG)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a8/v3/nhfPBhDdRbmb-BfnsMj5jA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132544Z&HW-CC-Expire=86400&HW-CC-Sign=48DF70FF285BFE6AE0CE3E207D611C9E0CF8E6626BF561312E44026CCB8B8B8C)
    
    创建的DisplaySync实例在start使能后需要aboutToDisappear函数中进行stop操作并置空，避免内存泄漏问题。
    
    aboutToDisappear() {
      if (this.backDisplaySyncSlow) {
        this.backDisplaySyncSlow.stop();
        this.backDisplaySyncSlow = undefined;
      }
      if (this.backDisplaySyncFast) {
        this.backDisplaySyncFast.stop();
        this.backDisplaySyncFast = undefined;
      }
    }
    
6.  结束每帧回调。
    
    Button('Stop')
      .id('CustomDrawStop')
      .fontSize(14)
      .fontWeight(500)
      .margin({ bottom: 10, left: 5 })
      .fontColor(Color.White)
      .onClick((): void => {
        if (this.backDisplaySyncSlow) {
          this.backDisplaySyncSlow.stop();
        }
        if (this.backDisplaySyncFast) {
          this.backDisplaySyncFast.stop();
        }
      })
      .width('20%')
      .height(40)
      .shadow(ShadowStyle.OUTER\_DEFAULT\_LG)