跳转到正文

@capgo/capacitor-android-kiosk

通过 kiosk 模式和 launcher 控制,将 Android 设备固定到单个应用。

@capgo/capacitor-android-kiosk 将车队中的平板电脑锁定为单一的 Capacitor 体验,支持 Kiosk 模式、启动器固定和硬件按键策略。

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

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

继续从 @capgo/capacitor-android-kiosk 开始

“从 @capgo/capacitor-android-kiosk 继续”部分

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