允许应用程序向系统提供性能场景信息,系统将据此在API生效范围内尽可能优化应用性能,从而提升用户体验。
调用接口需捕获异常。
perfHint只是应用向系统发送的性能优化提示,系统收到提示后会综合考量整机CPU负载、系统温度等因素进行决策,不保证一定进行性能提升。
性能提示仅当应用在前台运行时才会生效,应用切换到后台后提示将失效。
调用本接口会一定程度上造成功耗和整机温度的上升。
上报线程ID提升QoS优先级不能与QoS API混用。通过线程ID提升QoS优先级的底层实现依赖于QoS API,针对同一个线程,两边任一调用生效即开始提升QoS优先级,任一调用结束即解除提升。因此混用可能导致QoS优先级提升的生效与解除行为不符合预期。
起始版本: 26.0.0
需要系统性能优化的场景类型。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.FAST.SchedulingOptimization
起始版本: 26.0.0
| 名称 | 值 | 说明 |
|---|---|---|
| APP_LAUNCH | 1 | 应用启动场景。 |
| PAGE_TRANSITION | 2 | 页面切换场景。 |
| PAGE_LOAD | 3 | 页面加载场景。 |
| NETWORK_FILE_PROCESSING | 4 | 网络文件处理场景。 |
| LOCAL_FILE_PROCESSING | 5 | 本地文件处理场景。 |
| PAGE_DRAWING | 6 | 页面绘制场景。 |
| ANIMATION | 7 | 动效场景。 |
| MEDIA_PLAYBACK | 8 | 媒体播放场景。 |
| MEDIA_ENCODING_AND_DECODING | 9 | 媒体编解码场景。 |
需要系统性能优化的场景状态。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.FAST.SchedulingOptimization
起始版本: 26.0.0
| 名称 | 值 | 说明 |
|---|---|---|
| END | 0 | 结束系统性能优化。 |
| BEGIN | 1 | 开始系统性能优化。 |
需要系统性能优化的持续时间选项。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.FAST.SchedulingOptimization
起始版本: 26.0.0
| 名称 | 值 | 说明 |
|---|---|---|
| SHORT | 1 | 短持续时间。单次最大持续时间:1,间隔大于3。单位:秒。 |
| MEDIUM | 2 | 中等持续时间。单次最大持续时间:10,间隔大于30。单位:秒。 |
| LONG | 3 | 长持续时间。单次最大持续时间:60,间隔大于180。单位:秒。 |
系统性能优化的配置参数。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.FAST.SchedulingOptimization
起始版本: 26.0.0
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| sceneType | SceneType | 否 | 否 | 系统性能优化场景类型。 |
| sceneState | SceneState | 否 | 否 | 系统性能优化场景状态。 |
| durationType | DurationType | 否 | 否 | 系统性能优化持续时间类型。 |
| tids | number[] | 否 | 否 | 系统性能优化线程ID,最大长度为16。 |
perfHint(config: PerfHintConfig): Promise<void>
系统性能优化接口。使用Promise异步回调。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.FAST.SchedulingOptimization
起始版本: 26.0.0
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| config | PerfHintConfig | 是 | 系统性能优化的配置参数。 |
返回值:
| 类型 | 说明 |
|---|---|
| Promise<void> | Promise对象。无返回结果的Promise对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
| 错误码ID | 错误信息 |
|---|---|
| 1027700001 | High system load. |
| 1027700002 | Power Saving Mode. |
| 1027700003 | Low Power Mode. |
| 1027700004 | Non-frontend calling scenarios. |
| 1027700005 | The interval does not meet the requirement. |
| 1027700006 | Failed to execute scheduling optimization. |
示例:
import { schedulingOptimization } from '@kit.FASTKit';
@Entry
@Component
struct PerfHintDemo {
build() {
Column() {
Button("perfHint")
.onClick(async () => {
try {
let config: schedulingOptimization.PerfHintConfig = {
sceneType: schedulingOptimization.SceneType.APP_LAUNCH,
sceneState: schedulingOptimization.SceneState.BEGIN,
durationType: schedulingOptimization.DurationType.SHORT,
tids: [] // 按需填入线程ID
};
await schedulingOptimization.perfHint(config);
console.info('perfHint success');
} catch (error) {
console.error(`perfHint error.code is ${error.code}, message is ${error.message}`);
// 根据错误码进行相应处理
}
})
.width('100%')
}
.margin(16)
.height('100%')
.justifyContent(FlexAlign.Center)
}
}