@boengli/电容全屏

这个 Capacitor 插件允许您在您的Android app中启用全屏模式,隐藏系统状态和导航条,以进行更浸润的经验.

细节

全屏功能利用 WindowInsetsControllerCompat 管理Android上的浸入模式.

兼容性

• 插件版本 0.0.20
  此版本更新为 电容 8。 。 。 .
  要求数 Android 7.0 (API 24)及以上 (中文(简体) ) 财务报告和审定财务报表 爪哇语 21。 。 。 .

• 插件版本 0.0.19
  此版本更新为 电容 7。 。 。 .
  要求数 Android 11.0 (API 30)及以上 (中文(简体) ) 财务报告和审定财务报表 爪哇语 21。 。 。 .

• 插件版本 0.0.18
  现已精简支助 Android 11.0 (API 30)及以上 (中文(简体) ). 对早期Android版本的遗产支持被放弃.

• 插件版本 0.0.17
  浸入模式执行支持 Android 8.0 (API 26)及以上 (中文(简体) )。 。 。 .

安装

1. 安装 npm i @boengli/capacitor-fullscreen
2. 如果你的应用程序覆盖 androidxCoreVersion 内 /android/variables.gradle,确保这是 >= 1.17.0
3. npx cap sync android

配置

在你身边 capacitor.config.ts数字 :

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    Fullscreen: {
      activateOnLoad: true, // default — activates immersive mode as soon as the plugin loads
    },
  },
};

设定 activateOnLoad: false 如果您想要手动控制全屏并仅呼叫 activateImmersiveMode() 从您自己的代码(例如,在特定页面或用户动作上).

示例使用

import { Fullscreen } from '@boengli/capacitor-fullscreen';

try {
  await Fullscreen.activateImmersiveMode();
  console.log('Fullscreen enabled');
} catch (error) {
  console.error('Error enabling fullscreen:', error);
}

iOS系统

您不需要插件 。 把这个加进你的 Info.plist数字 :

<key>UIStatusBarHidden</key>
<true/>
<key>UIViewControllerBasedStatusBarAppearance</key>
<false/>

函数描述

激活immersive 模块

activateImmersiveMode() => Promise<void>

活化浸润模式,隐藏状态和导航条.

回返: 承诺在浸入模式成功启动时解决, 如果失败, 则以错误拒绝 .

解除immersive 模块

deactivateImmersiveMode() => Promise<void>

解除受浸模式,恢复状态和导航条的能见度.

回返: 当浸入模式成功被关闭或失败时以出错拒绝时, 承诺可以解决.