@tojestproste/caplab-sensor-info

Capacitor plugin (Android) zwracający pełną listę fizycznych czujników urządzenia — nazwa, vendor, zasięg, rozdzielczość, pobór mocy. Bez odczytu danych na żywo z czujników, tylko metadane.

Część zestawu CapLab — narzędzi diagnostycznych dla Androida.

Instalacja

npm install @tojestproste/caplab-sensor-info
npx cap sync

Uprawnienia

Brak. SensorManager.getSensorList() to czysto informacyjne API dostępne każdej aplikacji bez deklaracji w AndroidManifest.xml.

Poza zakresem: to dotyczy tylko sprawdzenia jakie czujniki fizycznie istnieją. Realny odczyt danych na żywo z niektórych czujników (np. krokomierz) wymagałby ACTIVITY_RECOGNITION (Android 10+) — nieobsługiwane przez ten plugin.

⚠️ Uwaga o rozmiarze response

Na urządzeniach z wieloma czujnikami (40+, typowe dla flagowców Xiaomi/Samsung) response może być duży — w testach na Poco X7 Pro to 43 czujniki z pełnymi metadanymi każdy. Jeśli łączysz kilka pluginów CapLab przez Promise.all() i planujesz zapisać wynik (np. do pliku albo schowka), rozważ wywołanie SensorInfo osobno, poza resztą — duży JSON potrafi przekroczyć limity schowka na niektórych telefonach.

Użycie

import { SensorInfo } from '@tojestproste/caplab-sensor-info';

const data = await SensorInfo.get();
console.log(data.totalSensorCount); // 43
console.log(data.commonSensorsPresence.stepCounter); // true
console.log(data.sensors[0].name); // "lsm6dsvq_acc"

API

• get()
• Interfaces

get()

get() => Promise<SensorInfoResult>

Zwraca pełną listę fizycznych czujników.

Returns: Promise<SensorInfoResult>

Interfaces

SensorInfoResult

| Prop | Type | | ------------------------- | ------------------------------------------------------------------------------ | | timestamp | number | | totalSensorCount | number | | sensors | SensorInfoSensor[] | | commonSensorsPresence | SensorInfoCommonPresence |

Przykładowy response

Realny output (Poco X7 Pro, 43 czujniki — wycinek):

{
  "totalSensorCount": 43,
  "sensors": [
    {
      "name": "lsm6dsvq_acc",
      "vendor": "st",
      "stringType": "android.sensor.accelerometer",
      "maxRange": 78.45,
      "power": 0.001,
      "reportingMode": "continuous"
    },
    { "name": "tsl2522_als", "stringType": "android.sensor.light", "reportingMode": "on_change" },
    { "name": "Fod Wakeup", "vendor": "xiaomi", "stringType": "xiaomi.sensor.fod" }
  ],
  "commonSensorsPresence": {
    "accelerometer": true,
    "gyroscope": true,
    "proximity": true,
    "stepCounter": true,
    "heartRate": false
  }
}

Ciekawostka: producenci OEM (np. Xiaomi) dodają własne, niestandardowe czujniki spoza puli Androida — SAR sensor, OIS, elevator detection, pickup wakeup, flicker sensor. Wszystkie pojawiają się w pełnej liście sensors.

Licencja

MIT