跳过主要内容
返回插件
@capgo/capacitor-android-kiosk
教程
@capgo/capacitor-android-kiosk

Android Kiosk

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

指南

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');

全局参考

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

如果您正在使用 使用@capgo/capacitor-android-kiosk 计划仪表板和API操作时,连接它 @capgo/capacitor-android-kiosk 在@capgo/capacitor-android-kiosk中了解实现细节 开始使用 在开始使用中了解实现细节 API概述 在API概述中了解实现细节 介绍 在介绍中了解实现细节,并 API密钥 为API密钥的实现细节。