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

保持屏幕开启

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

指南

保持唤醒教程

在设备上测试

Download the Capgo app, then scan the QR 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 的实现细节 开始使用 为 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities 的实现细节 为 @capgo/capacitor-live-activities 的原生能力 @capgo/capacitor-live-activities 为 @capgo/capacitor-live-activities 的实现细节,以及 使用 @capgo/capacitor-video-player 为使用 @capgo/capacitor-video-player 的原生能力 for the native capability in Using @capgo/capacitor-video-player.