指南
Android Kiosk教程
使用@capgo/capacitor-android-kiosk
Capacitor Android Kiosk插件,用于控制kiosk模式和启动器功能。这是一个Android-only插件。要在iOS上使用kiosk模式,请使用设备的Guided Access功能。
安装
bun add @capgo/capacitor-android-kiosk
bunx cap sync
此插件暴露的内容
isInKioskMode- 检查应用程序是否当前正在运行在kiosk模式下。isSetAsLauncher- 检查应用程序是否设置为设备启动器(主应用)。enterKioskMode- 进入全屏模式,隐藏系统UI并阻止硬件按钮。同时启动前台保活服务,以减少系统杀死应用的可能性。应用必须设置为设备启动器,才能有效工作。exitKioskMode- 退出全屏模式,恢复正常的系统UI和硬件按钮功能。同时停止前台保活服务,启动时enterKioskMode()中启动的服务。
示例用法
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
进入全屏模式,隐藏系统UI并阻止硬件按钮。同时启动前台保活服务,以减少系统杀死应用的可能性。应用必须设置为设备启动器,才能有效工作。
import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';
await CapacitorAndroidKiosk.enterKioskMode();
exitKioskMode
退出全屏模式,恢复正常的系统UI和硬件按钮功能。同时停止前台保活服务,启动时enterKioskMode()中启动的服务。
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中了解实现细节 开始使用 在开始使用中了解实现细节 API概述 在API概述中了解实现细节 介绍 在介绍中了解实现细节,并 API密钥 为API密钥的实现细节。