保持屏幕常亮

场景说明

在使用开发板进行应用开发调试时，不操作屏幕一段时间后，屏幕会熄屏变黑，再操作时需要再次点亮屏幕，耗费时间不利于调试。本例将介绍如何通过窗口管理相关接口实现屏幕常亮。

效果呈现

本示例最终效果如下（在开发板中可验证实际常亮效果）：

screenon

运行环境

本例基于以下环境开发，开发者也可以基于其他适配的版本进行开发：

  • IDE：DevEco Studio 3.1 Release
  • SDK：Ohos_sdk_public 3.2.12.2 (API Version 9 Release)

实现思路

通过Window的setWindowKeepScreenOn方法，在需要时控制屏幕是否常亮，并通过Window的getWindowProperties().isKeepScreenOn查看窗口属性中屏幕常亮的状态。

开发步骤

  1. 构建简易界面，用于显示当前屏幕常亮的状态，并绘制按钮用于设置常亮和取消常亮。

    build() {
	Row() {
	  Column() {
		Text(this.message + this.isScreenOn)
		  ...

		Button('设置常亮')
		  ...
		  .onClick(()=>{
			this.keepScreenOn(true)
		  })

		Button('取消常亮')
		  ...
		  .onClick(()=>{
			this.keepScreenOn(false)
		  })
	  }
	  .width('100%')
	}
	.height('100%')
}

  2. 获取应用上下文并通过其获取到当前窗口实例，通过窗口实例的setWindowKeepScreenOn方法控制屏幕是否常亮，并通过getWindowProperties获取窗口属性，从而查看属性中屏幕常亮状态isKeepScreenOn的取值。

    import common from '@ohos.app.ability.common';
import window from '@ohos.window';

private context: common.BaseContext = getContext(this) as common.BaseContext

async keepScreenOn(status) {
	let windowClass = await window.getLastWindow(this.context) //获取窗口实例
	await windowClass.setWindowKeepScreenOn(status) //设置窗口常亮或取消
	this.isScreenOn = await windowClass.getWindowProperties().isKeepScreenOn//查看屏幕常亮状态
}

完整代码

通过上述步骤可以完成整个示例的开发，完整代码如下：

import common from '@ohos.app.ability.common';
import window from '@ohos.window';

@Entry
@Component
struct KeepScreenOn {
  @State message: string = '常亮状态 : '
  @State isScreenOn: boolean = false
  private context: common.BaseContext = getContext(this) as common.BaseContext

  async keepScreenOn(status) {
    let windowClass = await window.getLastWindow(this.context) //获取窗口实例
    await windowClass.setWindowKeepScreenOn(status) //设置窗口常亮或取消
    this.isScreenOn = await windowClass.getWindowProperties().isKeepScreenOn//查看屏幕常亮状态
  }

  build() {
    Row() {
      Column() {
        Text(this.message + this.isScreenOn)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)

        Button('设置常亮')
          .fontSize(16)
          .height(50)
          .width(100)
          .borderRadius(10)
          .margin({top:20})
          .backgroundColor('#A4AE77')
          .onClick(()=>{
            this.keepScreenOn(true)
          })

        Button('取消常亮')
          .fontSize(16)
          .height(50)
          .width(100)
          .borderRadius(10)
          .margin({top:20})
          .backgroundColor('#A4AE77')
          .onClick(()=>{
            this.keepScreenOn(false)
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}