跳转至正文

@capgo/capacitor-android-kiosk

通过 Kiosk 模式和启动器控制,将 Android 设备锁定在单个应用中。

@capgo/capacitor-android-kiosk 通过 Kiosk 模式、启动器固定和硬件按键策略,将设备集群锁定在单一的 Capacitor 体验中。

平台支持备注
iOS否侧重 Android
Android是需按 README 进行 Device owner 配置
Web否不适用
  • isInKioskMode - 检查应用当前是否处于 Kiosk 模式。
  • isSetAsLauncher - 检查应用是否已设置为设备启动器(Home 应用)。
  • enterKioskMode - 进入 Kiosk 模式,隐藏系统 UI 并禁用硬件按键。同时启动前台保活服务,降低应用被系统杀掉的概率。为确保效果,应用必须被设置为设备启动器。
  • exitKioskMode - 退出 Kiosk 模式,恢复正常的系统 UI 和硬件按键功能。同时停止 enterKioskMode() 中启动的前台保活服务。
方法描述
isInKioskMode检查应用当前是否处于 Kiosk 模式。
isSetAsLauncher检查应用是否已设置为设备启动器(Home 应用)。
enterKioskMode进入 Kiosk 模式,隐藏系统 UI 并禁用硬件按键。同时启动前台保活服务,降低应用被系统杀掉的概率。为确保效果,应用必须被设置为设备启动器。
exitKioskMode退出 Kiosk 模式,恢复正常的系统 UI 和硬件按键功能。同时停止 enterKioskMode() 中启动的前台保活服务。
setAsLauncher打开设备的桌面设置,允许用户将此应用设为启动器。这是实现完整 Kiosk 模式功能的必要步骤。
setAllowedKeys设置在 Kiosk 模式下允许使用的硬件按键。默认情况下,Kiosk 模式会禁用所有硬件按键。
getPluginVersion获取原生 Capacitor 插件版本。

此参考文档同步自 src/definitions.ts 在 capacitor-android-kiosk.

如果你正在使用 @capgo/capacitor-android-kiosk 来规划 dashboard 和 API 操作,请将其连接至 使用 @capgo/capacitor-android-kiosk 在“使用 @capgo/capacitor-android-kiosk”中实现原生能力, API 概览 关于 API 概览中的实现细节, 简介 有关 Introduction 中的实现细节, API 密钥 有关 API Keys 中的实现细节,以及 设备 有关 Devices 中的实现细节。