开始获取

复制包含安装步骤和本插件的完整 Markdown 指南的设置提示。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-proximity`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/proximity/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

bun add @capgo/capacitor-proximity
bunx cap sync

导入

import { CapacitorProximity } from '@capgo/capacitor-proximity';

API概述

`enable`

启用近距离监测

在iOS上启用 UIDevice.isProximityMonitoringEnabled在Android上开始监听 TYPE_PROXIMITY 并在感应器被遮盖时降低当前应用窗口

import { CapacitorProximity } from '@capgo/capacitor-proximity';

await CapacitorProximity.enable();

`disable`

Disable proximity monitoring.

恢复默认应用窗口行为并停止传感器监控.

import { CapacitorProximity } from '@capgo/capacitor-proximity';

await CapacitorProximity.disable();

`getStatus`

获取当前传感器可用性和插件启用状态.

import { CapacitorProximity } from '@capgo/capacitor-proximity';

const status = await CapacitorProximity.getStatus();

Type Reference

`ProximityStatusResult`

ProximityStatusResult getStatus().

export interface ProximityStatusResult {
  /**
   * Whether the current device exposes a usable proximity sensor.
   *
   * @since 0.0.1
   */
  available: boolean;

  /**
   * Whether proximity monitoring is currently enabled by the plugin.
   *
   * @since 0.0.1
   */
  enabled: boolean;

  /**
   * Platform label returned by the native or web implementation.
   *
   * @since 0.0.1
   */
  platform: 'ios' | 'android' | 'web';
}

`PluginVersionResult`

请求插件版本时返回的结果。

export interface PluginVersionResult {
  /**
   * Native plugin version string.
   *
   * @since 0.0.1
   */
  version: string;
}

真实数据来源

此页面是由插件生成的。 src/definitions.ts当公共API上游更改时，请重新运行同步。

从开始阶段继续

如果您正在使用 开始阶段 规划仪表板和API操作，请将其连接到使用@capgo/capacitor-proximity 为native能力在使用@capgo/capacitor-proximity中 API概述为实现细节在API概述中介绍为实现细节在介绍中 API密钥为实现细节在API密钥中,和设备为实现细节在设备中