Page/area: Sitio web de marketing de Capgo. Role: Etiqueta de UI corta o elemento de navegación. Visto en: componente doc/SignupCta.astro, componente Hero.astro. Clave de mensaje `hero_title_line2` (Hero Title Line2).

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utilice la siguiente solicitud:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-light-sensor` plugin in my project.

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo las instrucciones específicas de la plataforma a continuación:

bun add @capgo/capacitor-light-sensor
bunx cap sync

Importar

import { LightSensor } from '@capgo/capacitor-light-sensor';

API Resumen

isAvailable

Verifique si el sensor de luz está disponible en el dispositivo actual. Siempre verifique la disponibilidad del sensor antes de intentar utilizarlo.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const { available } = await LightSensor.isAvailable();

start

Comience a escuchar actualizaciones del sensor de luz. Esto iniciará las mediciones del sensor con el intervalo especificado. Usa addListener para recibir los datos del sensor.

import { LightSensor } from '@capgo/capacitor-light-sensor';

await LightSensor.start({ updateInterval: 500 });

stop

Detener la escucha de actualizaciones del sensor de luz. Esto detendrá el sensor y conservará la batería.

import { LightSensor } from '@capgo/capacitor-light-sensor';

await LightSensor.stop();

checkPermissions

Ver el estado de permisos actual para sensores de alta frecuencia. En Android 12+, se requiere la permiso HIGH_SAMPLING_RATE_SENSORS para intervalos de actualización de sensores inferiores a 200ms.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.checkPermissions();

requestPermissions

Solicite permiso para sensores de alta frecuencia de muestreo. En Android 12+, esto solicita la permiso de HIGH_SAMPLING_RATE_SENSORS.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.requestPermissions();

Referencia de tipo

IsAvailableResult

Resultado que indica si el sensor está disponible.

export interface IsAvailableResult {
  /**
   * Whether the light sensor is available on this device.
   * Always false on iOS as the light sensor API is not available.
   *
   * @since 0.0.1
   */
  available: boolean;
}

StartOptions

Opciones para iniciar el escuchador del sensor de luz.

export interface StartOptions {
  /**
   * The desired interval between sensor updates in milliseconds.
   * On Android 12+, there's a minimum interval of 200ms unless the app
   * has the HIGH_SAMPLING_RATE_SENSORS permission.
   *
   * @default 200
   * @since 0.0.1
   */
  updateInterval?: number;
}

LightSensorCallback

Función de llamada para actualizaciones del sensor de luz.

export type LightSensorCallback = (measurement: LightSensorMeasurement) => void;

PermissionStatus

Resultado de una solicitud o comprobación de permiso.

export interface PermissionStatus {
  /**
   * Whether the high sampling rate sensor permission is granted.
   * On Android 12+, this permission is required for update intervals below 200ms.
   *
   * @since 0.0.1
   */
  highSamplingRate: 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';
}

VersionResult

Información de versión del plugin.

export interface VersionResult {
  /**
   * The current version of the plugin.
   *
   * @since 0.0.1
   */
  version: string;
}

LightSensorMeasurement

Un solo medidor de luz del sensor.

export interface LightSensorMeasurement {
  /**
   * Ambient light level in lux (lx).
   *
   * @since 0.0.1
   */
  illuminance: number;

  /**
   * Timestamp of the measurement in seconds since epoch.
   *
   * @since 0.0.1
   */
  timestamp: number;
}

Fuente de Verdad

Esta página se genera a partir del plugin’s src/definitions.tsRe-ejecuta la sincronización cuando los cambios públicos API cambian en la fuente.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para planificar la consola y las API operaciones, conecta con Usando @capgo/capacitor-sensor de luz para la capacidad nativa en Usando @capgo/capacitor-sensor de luz API Overview para el detalle de implementación en API Overview Introducción para los detalles de implementación en Introducción API Claves para los detalles de implementación en API Claves, y Dispositivos Para los detalles de implementación en dispositivos.