Skip to main content

Proximity Sensor

Near/far detection for validating proximity behavior (device dependent).

Live Status tab showing the current state and sensor status

Overview​

The proximity sensor typically reports a simple state: something is close to the sensor (near) or not (far). It is commonly used to turn off the screen during calls.

Table of Contents​

Tabs​

  • Live Status: current Near/Far/Unknown state plus sensor status.
  • Event Log: a timestamped history of state changes (up to 100 events).

Live Status Tab​

The Live Status tab shows:

  • A large circular indicator with an icon and the current state. Three states are possible: Near, Far, and Unknown (each with a distinct icon).
  • Haptic feedback is provided on each state change (success for Near, warning for Far, error for Unknown).
  • A status panel with:
    • Sensor monitoring status (Active/Inactive)
    • Device orientation at last event
    • Last event time
    • Total events recorded

The layout adapts to orientation -- in portrait, the indicator and status panel stack vertically; in landscape, they are laid out side by side.

Event Log Tab​

Event Log tab with a Clear button

The Event Log tab includes:

  • A Clear button to remove the recorded event history.
  • A table-like list with state and time. In landscape orientation, additional Orientation and Status columns are shown.

What You Can See​

  • Proximity state (near/far)
  • Update behavior while the screen is on (device/OS dependent)

Notes​

  • Not all devices expose proximity sensor data in the same way.
  • Cases, screen protectors, and dirt can affect proximity behavior.

Notes And Limitations​

  • If your device does not have a proximity sensor, Lirum shows the tool as unavailable.
  • The proximity sensor is not available on visionOS.
Last updated on by Rogerio Hirooka