跳过主要内容
返回插件
@capgo/capacitor-android-kiosk
教程
由 github.com/Cap-go

Android Kiosk

使用launcher功能和硬件键控制将Android设备锁定到kiosk模式中

指南

Android Kiosk 教程

使用 @capgo/capacitor-android-kiosk

Capacitor Android Kiosk 插件,用于控制 kiosk 模式和启动器功能。该插件仅适用于 Android。对于 iOS kiosk 模式,请使用设备的 Guided Access 功能。

安装

bun add @capgo/capacitor-android-kiosk
bunx cap sync

什么这个插件暴露了

  • isInKioskMode - 检查应用程序是否当前正在 kiosk 模式下运行。
  • isSetAsLauncher - 检查应用程序是否设置为设备启动器(主应用程序)。
  • enterKioskMode - 进入 kiosk 模式,隐藏系统 UI 并阻止硬件按钮。也启动前台保持活动服务,以便应用程序更不容易被系统杀死。应用程序必须设置为设备启动器,这样才能有效地工作。
  • exitKioskMode - 退出 kiosk 模式,恢复正常的系统 UI 和硬件按钮功能。也停止前台保持活动服务,启动在 enterKioskMode() 中启动的服务。

示例用法

isInKioskMode

- 检查应用程序是否当前正在 kiosk 模式下运行。

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

- 进入 kiosk 模式,隐藏系统 UI 并阻止硬件按钮。也启动前台保持活动服务,以便应用程序更不容易被系统杀死。应用程序必须设置为设备启动器,这样才能有效地工作。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.enterKioskMode();

exitKioskMode

- 退出 kiosk 模式,恢复正常的系统 UI 和硬件按钮功能。也停止前台保持活动服务,启动在 enterKioskMode() 中启动的服务。

import { CapacitorAndroidKiosk } from '@capgo/capacitor-android-kiosk';

await CapacitorAndroidKiosk.exitKioskMode();
console.log('Exited kiosk mode');

全局参考

继续使用@capgo/capacitor-android-kiosk

如果您正在使用 使用@capgo/capacitor-android-kiosk 来规划仪表板和API操作,连接它与 @capgo/capacitor-android-kiosk 的实现细节在@capgo/capacitor-android-kiosk, 入门指南 实现细节在入门指南, API概述 实现细节在API概述, 简介 为简介中的实现细节提供 API 键 为API 键中的实现细节提供