跳过主要内容
返回插件
@capgo/capacitor-keep-awake
教程
@capgo/capacitor-keep-awake

保持唤醒

防止设备屏幕变暗或睡眠,适用于视频播放器、导航和演示

指南

Keep Awake 教程

在设备上测试

下载 Capgo 应用程序,然后扫描二维码 code。

保持屏幕唤醒插件预览二维码 code

使用 @capgo/capacitor-keep-awake

Capacitor 保持屏幕唤醒插件,防止设备屏幕自动熄屏/睡眠。

安装

bun add @capgo/capacitor-keep-awake
bunx cap sync

此插件暴露的内容

  • keepAwake - 防止设备屏幕自动熄屏。
  • allowSleep - 允许设备屏幕自动熄屏(禁用保持屏幕唤醒)。
  • isSupported - 检查当前平台是否支持保持屏幕唤醒功能。
  • isKeptAwake - 检查设备是否当前处于保持屏幕唤醒状态。

示例用途

keepAwake

防止设备降低屏幕亮度。

import { KeepAwake } from '@capgo/capacitor-keep-awake';

await KeepAwake.keepAwake();
console.log('Screen will stay awake');

allowSleep

允许设备降低屏幕亮度(禁用保持唤醒)。

import { KeepAwake } from '@capgo/capacitor-keep-awake';

await KeepAwake.allowSleep();
console.log('Screen can now dim');

isSupported

检查当前平台是否支持保持唤醒功能。

import { KeepAwake } from '@capgo/capacitor-keep-awake';

const { isSupported } = await KeepAwake.isSupported();
if (isSupported) {
  console.log('Keep awake is supported');
}

isKeptAwake

检查设备是否正在被保持唤醒。

import { KeepAwake } from '@capgo/capacitor-keep-awake';

const { isKeptAwake } = await KeepAwake.isKeptAwake();
console.log('Is kept awake:', isKeptAwake);

全局参考

继续使用 @capgo/capacitor-keep-awake

如果您正在使用 使用 @capgo/capacitor-keep-awake 为了规划原生媒体和界面行为,连接它 @capgo/capacitor-keep-awake 了解@capgo/capacitor-keep-awake的实现细节 开始 了解Getting Started的实现细节 使用@capgo/capacitor-live-activities 了解在使用@capgo/capacitor-live-activities的原生能力 @capgo/capacitor-live-activities 了解@capgo/capacitor-live-activities的实现细节,以及 使用@capgo/capacitor-video-player 了解在使用@capgo/capacitor-video-player的原生能力