指南
安卓锁屏插件教程
使用@capgo/capacitor-android-kiosk
Capacitor安卓锁屏插件,用于控制锁屏模式和启动器功能。该插件仅适用于安卓。要在iOS上使用锁屏模式,请使用设备的引导访问功能。
安装
bun add @capgo/capacitor-android-kiosk
bunx cap sync
此插件暴露的内容
isInKioskMode- 检查应用是否当前正在锁屏模式下运行。isSetAsLauncher- 检查应用是否设置为设备启动器(主屏幕应用)。enterKioskMode- 进入屏幕保护模式,隐藏系统界面并阻止硬件按钮。同时启动前台保持活动服务,以便系统杀死应用的可能性降低。应用必须设置为设备启动器,才能有效工作。exitKioskMode- 退出屏幕保护模式,恢复正常的系统界面和硬件按钮功能。同时停止前台保持活动服务。
- 示例用法
isInKioskMode
- 检查应用是否当前正在屏幕保护模式下运行。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
const { isInKioskMode } = await CapacitorAndroidKiosk.isInKioskMode();
console.log('Kiosk mode active:', isInKioskMode);
isSetAsLauncher
- 检查应用是否设置为设备启动器(主屏幕应用)。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
const { isLauncher } = await CapacitorAndroidKiosk.isSetAsLauncher();
console.log('Is launcher:', isLauncher);
enterKioskMode
- 进入屏幕保护模式,隐藏系统界面并阻止硬件按钮。同时启动前台保持活动服务,以便系统杀死应用的可能性降低。应用必须设置为设备启动器,才能有效工作。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.enterKioskMode();
exitKioskMode
- 退出屏幕保护模式,恢复正常的系统界面和硬件按钮功能。同时停止前台保持活动服务。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');
- 全部参考
- - GitHub: - https://github.com/Cap-go/capacitor-android-kiosk/
- - 文档:/docs/plugins/android-kiosk/
- 从使用 @capgo/capacitor-android-kiosk 中继续
如果您正在使用 使用@capgo/capacitor-android-kiosk 来规划仪表板和API操作,连接它与 @capgo/capacitor-android-kiosk 查看@capgo/capacitor-android-kiosk, Getting Started 查看Getting Started, API Overview 查看API Overview, Introduction 查看Introduction, API Keys 为 API 的实现细节提供 API Keys。