uniapp 设置手机不息屏

段旭涛2025-06-08 12:22

在使用 UniApp 开发应用时，有时需要在设备长时间未操作时实现息屏保护功能，以节省电量和保护屏幕。以下是如何在 UniApp 中实现这一功能的步骤。

示例一

javascript 复制代码

// 保持屏幕常亮
uni.setKeepScreenOn({
    keepScreenOn: true
});

// 监听应用进入后台事件
uni.onHide(() => {
    // 进入后台时关闭屏幕常亮
    uni.setKeepScreenOn({
        keepScreenOn: false
    });
});

// 监听应用进入前台事件
uni.onShow(() => {
    // 进入前台时开启屏幕常亮
    uni.setKeepScreenOn({
        keepScreenOn: true
    });
});

示例二

javascript 复制代码

plus.device.setWakelock(true);

设置权限

在 Android 平台上，需要在 AndroidManifest.xml 文件中添加以下权限：

javascript 复制代码

<uses-permission android:name="android.permission.WAKE_LOCK" />

并确保在 HBuilder 中设置相应的权限

使用生命周期函数实现息屏保护

可以利用 UniApp 的生命周期函数来实现息屏保护功能。例如，当应用进入后台时，可以关闭屏幕常亮功能；当应用重新进入前台时，可以重新开启屏幕常亮功能

示例代码

javascript 复制代码

// 应用生命周期函数
App({
    onLaunch() {
        // 应用启动时执行的代码
    },
    onShow() {
        // 应用进入前台时执行的代码
        uni.setKeepScreenOn({
            keepScreenOn: true
        });
    },
    onHide() {
        // 应用进入后台时执行的代码
        uni.setKeepScreenOn({
            keepScreenOn: false
        });
    }
});