@ohos.graphics.displaySync (Variable Frame Rate)

The displaySync module allows your application to draw its custom UI content at a specified frame rate.

NOTE

The initial APIs of this module are supported since API version 11. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import displaySync from '@ohos.graphics.displaySync';

displaySync.create

create(): DisplaySync

Creates a DisplaySync object, through which you can set the frame rate of the custom UI content.

System capability: SystemCapability.ArkUI.ArkUI.Full

Return value

Type	Description
DisplaySync	DisplaySync object created.

Example

let backDisplaySync: displaySync.DisplaySync = displaySync.create();

IntervalInfo

You can obtain the timestamp information from the event callback, including the timestamp when the current frame arrives and the timestamp when the next frame is expected to arrive.

System capability: SystemCapability.ArkUI.ArkUI.Full

Name	Type	Read-only	Mandatory	Description
timestamp	number	Yes	No	Time when the current frame arrives, in nanoseconds.
targetTimestamp	number	Yes	No	Expected arrival time of the next frame, in nanoseconds.

DisplaySync

An object that implements the setting of the frame rate and callback. It provides APIs for you to set the frame rate, register a callback, and start/stop the callback.

Before calling any of the following APIs, you must use displaySync.create() to create a DisplaySync instance.

setExpectedFrameRateRange

setExpectedFrameRateRange(rateRange: ExpectedFrameRateRange) : void

Sets the expected frame rate range.

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
rateRange	ExpectedFrameRateRange	Yes	Expected frame rate range.

Example

let range : ExpectedFrameRateRange = {
  expected: 10,
  min:0,
  max:120
};

// Set the expected frame rate range.
backDisplaySync?.setExpectedFrameRateRange(range)

on('frame')

on(type: 'frame', callback: Callback<IntervalInfo>): void

Subscribes to change events of each frame.

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
type	'frame'	Yes	Event type. The value is fixed at 'frame'.
callback	Callback<IntervalInfo>	Yes	Callback used for subscription.

Example

let callback = (frameInfo: displaySync.IntervalInfo) => {
    console.info("DisplaySync", 'TimeStamp:' + frameInfo.timestamp + ' TargetTimeStamp: ' + frameInfo.targetTimestamp);
}

// Subscribe to the event.
backDisplaySync?.on("frame", callback)

off('frame')

off(type: 'frame', callback?: Callback<IntervalInfo>): void

Unsubscribes from change events of each frame.

System capability: SystemCapability.ArkUI.ArkUI.Full

Parameters

Name	Type	Mandatory	Description
type	'frame'	Yes	Event type. The value is fixed at 'frame'.
callback	Callback<IntervalInfo>	No	Callback used for unsubscription. If no value is passed in, all subscriptions to the specified event are canceled.

Example

let callback = (frameInfo: displaySync.IntervalInfo) => {
    console.info("DisplaySync", 'TimeStamp:' + frameInfo.timestamp + ' TargetTimeStamp: ' + frameInfo.targetTimestamp);
}

backDisplaySync?.on("frame", callback)

// Unsubscribe from the event.
backDisplaySync?.off("frame", callback)

start

start(): void

Starts callback for each frame.

System capability: SystemCapability.ArkUI.ArkUI.Full

Example

let range : ExpectedFrameRateRange = {
  expected: 10,
  min:0,
  max:120
};

backDisplaySync?.setExpectedFrameRateRange(range)

let callback = (frameInfo: displaySync.IntervalInfo) => {
    console.info("DisplaySync", 'TimeStamp:' + frameInfo.timestamp + ' TargetTimeStamp: ' + frameInfo.targetTimestamp);
}

backDisplaySync?.on("frame", callback)

// Start callback for each frame.
backDisplaySync?.start()

stop

stop(): void

Stops callback for each frame.

System capability: SystemCapability.ArkUI.ArkUI.Full

Example

let range : ExpectedFrameRateRange = {
  expected: 10,
  min:0,
  max:120
};

backDisplaySync?.setExpectedFrameRateRange(range)

let callback = (frameInfo: displaySync.IntervalInfo) => {
    console.info("DisplaySync", 'TimeStamp:' + frameInfo.timestamp + ' TargetTimeStamp: ' + frameInfo.targetTimestamp);
}

backDisplaySync?.on("frame", callback)

backDisplaySync?.start()

// ...

// Stop callback for each frame.
backDisplaySync?.stop()