Cảm biến vị trí

Nền tảng Android cung cấp hai cảm biến cho phép bạn xác định vị trí của thiết bị: cảm biến từ trường địa lý và cảm biến gia tốc. Nền tảng Android cũng cung cấp một cảm biến cho phép bạn xác định khoảng cách giữa mặt thiết bị với một đối tượng (còn gọi là cảm biến khoảng cách). Cảm biến từ trường địa lý và cảm biến khoảng cách dựa trên phần cứng. Hầu hết nhà sản xuất điện thoại di động và máy tính bảng đều trang bị cảm biến trường địa từ. Tương tự như vậy, các nhà sản xuất điện thoại di động thường cung cấp cảm biến độ gần để xác định thời điểm điện thoại di động được đưa gần khuôn mặt người dùng (ví dụ: trong khi gọi điện thoại). Để xác định hướng của thiết bị, bạn có thể sử dụng kết quả đọc từ gia tốc kế của thiết bị và cảm biến trường địa từ.

Lưu ý: Chúng tôi đã ngừng sử dụng cảm biến hướng trong Android 2.2 (API cấp 8) và loại cảm biến hướng trong Android 4.4W (API cấp 20).

Cảm biến vị trí rất hữu ích trong việc xác định vị trí thực tế của thiết bị trong khung tham chiếu của thế giới. Ví dụ: bạn có thể sử dụng cảm biến từ trường địa lý kết hợp với gia tốc kế để xác định vị trí của thiết bị so với cực bắc từ. Bạn cũng có thể sử dụng các cảm biến này để xác định hướng của thiết bị trong khung tham chiếu của ứng dụng. Cảm biến vị trí thường không được dùng để theo dõi chuyển động hoặc chuyển động của thiết bị, chẳng hạn như lắc, nghiêng hoặc đẩy (để biết thêm thông tin, hãy xem phần Cảm biến chuyển động).

Cảm biến trường địa từ và gia tốc kế trả về các mảng nhiều chiều của giá trị cảm biến cho mỗi SensorEvent. Ví dụ: cảm biến trường địa từ cung cấp các giá trị cường độ trường địa từ cho mỗi trục toạ độ trong một sự kiện cảm biến. Tương tự, cảm biến gia tốc kế đo lường gia tốc được áp dụng cho thiết bị trong một sự kiện cảm biến. Để biết thêm thông tin về hệ toạ độ mà cảm biến sử dụng, hãy xem phần Hệ toạ độ cảm biến. Cảm biến khoảng cách cung cấp một giá trị duy nhất cho mỗi sự kiện cảm biến. Bảng 1 tóm tắt các cảm biến vị trí được hỗ trợ trên nền tảng Android.

Bảng 1. Các cảm biến vị trí được hỗ trợ trên nền tảng Android.

Cảm biến Dữ liệu sự kiện của cảm biến Mô tả Đơn vị đo lường
TYPE_GAME_ROTATION_VECTOR SensorEvent.values[0] Thành phần vectơ xoay dọc theo trục x (x * sin(θ/2)). Không có đơn vị
SensorEvent.values[1] Thành phần vectơ xoay dọc theo trục y (y * sin(θ/2)).
SensorEvent.values[2] Thành phần vectơ xoay dọc theo trục z (z * sin(;/2)).
TYPE_GEOMAGNETIC_ROTATION_VECTOR SensorEvent.values[0] Thành phần vectơ xoay dọc theo trục x (x * sin(;/2)). Không có đơn vị
SensorEvent.values[1] Thành phần vectơ xoay dọc theo trục y (y * sin(θ/2)).
SensorEvent.values[2] Thành phần vectơ xoay dọc theo trục z (z * sin(θ/2)).
TYPE_MAGNETIC_FIELD SensorEvent.values[0] Cường độ trường địa từ dọc theo trục x. μT
SensorEvent.values[1] Cường độ trường địa từ dọc theo trục y.
SensorEvent.values[2] Cường độ trường địa từ dọc theo trục z.
TYPE_MAGNETIC_FIELD_UNCALIBRATED SensorEvent.values[0] Cường độ từ trường địa cầu (không có độ chính xác của sắt cứng) dọc theo trục x. μT
SensorEvent.values[1] Cường độ từ trường địa cầu (không có quy trình hiệu chuẩn sắt cứng) dọc theo trục y.
SensorEvent.values[2] Cường độ địa từ (không cần hiệu chỉnh bằng sắt cứng) dọc theo trục z.
SensorEvent.values[3] Ước tính độ lệch sắt dọc theo trục x.
SensorEvent.values[4] Phỏng đoán độ lệch sắt dọc theo trục y.
SensorEvent.values[5] Ước tính độ lệch sắt dọc theo trục z.
TYPE_ORIENTATION1 SensorEvent.values[0] Độ góc phương vị (góc xung quanh trục z). Độ
SensorEvent.values[1] Độ cao (góc xung quanh trục x).
SensorEvent.values[2] Cuộn (góc quanh trục y).
TYPE_PROXIMITY SensorEvent.values[0] Khoảng cách từ đối tượng.2 cm

1Không dùng cảm biến này nữa trong Android 2.2 (API cấp 8) và không dùng loại cảm biến này nữa trong Android 4.4W (API cấp 20). Khung cảm biến cung cấp các phương thức thay thế để thu thập hướng của thiết bị. Các phương thức này được thảo luận trong phần Tính toán hướng của thiết bị.

2 Một số cảm biến độ gần chỉ cung cấp các giá trị nhị phân đại diện cho gần và xa.

Sử dụng cảm biến vectơ xoay trò chơi

Cảm biến vectơ xoay trò chơi giống với Cảm biến vectơ xoay, ngoại trừ việc không sử dụng trường địa từ. Do đó, trục Y không hướng về phía bắc mà hướng về một số tọa độ tham chiếu khác. Giá trị tham chiếu đó được phép trôi theo cùng thứ tự cường độ khi con quay hồi chuyển trôi xung quanh trục Z.

Vì cảm biến vectơ xoay trò chơi không sử dụng trường từ, nên các lượt xoay tương đối sẽ chính xác hơn và không bị ảnh hưởng bởi các thay đổi về trường từ. Sử dụng cảm biến này trong trò chơi nếu bạn không quan tâm đến hướng bắc và vectơ xoay pháp tuyến không phù hợp với nhu cầu của bạn do phụ thuộc vào trường từ.

Mã sau đây cho bạn biết cách lấy một thực thể của cảm biến vectơ xoay trò chơi mặc định:

Kotlin

private lateinit var sensorManager: SensorManager
private var sensor: Sensor? = null
...
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_GAME_ROTATION_VECTOR)

Java

private SensorManager sensorManager;
private Sensor sensor;
...
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_GAME_ROTATION_VECTOR);

Sử dụng cảm biến vectơ xoay địa từ

Cảm biến vectơ xoay từ trường địa lý tương tự như cảm biến vectơ xoay, nhưng không sử dụng con quay hồi chuyển. Độ chính xác của cảm biến này thấp hơn cảm biến vectơ xoay thông thường, nhưng mức tiêu thụ điện năng lại giảm. Chỉ sử dụng cảm biến này nếu bạn muốn thu thập thông tin xoay ở chế độ nền mà không tốn quá nhiều pin. Cảm biến này hữu ích nhất khi được dùng cùng với tính năng phân lô.

Mã sau đây cho bạn biết cách lấy một thực thể của cảm biến vectơ xoay địa từ mặc định:

Kotlin

private lateinit var sensorManager: SensorManager
private var sensor: Sensor? = null
...
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_GEOMAGNETIC_ROTATION_VECTOR)

Java

private SensorManager sensorManager;
private Sensor sensor;
...
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_GEOMAGNETIC_ROTATION_VECTOR);

Tính toán hướng của thiết bị

Bằng cách tính toán hướng của thiết bị, bạn có thể theo dõi vị trí của thiết bị so với hệ quy chiếu của trái đất (cụ thể là cực bắc từ tính). Đoạn mã sau đây cho bạn biết cách tính hướng của thiết bị:

Kotlin

private lateinit var sensorManager: SensorManager
...
// Rotation matrix based on current readings from accelerometer and magnetometer.
val rotationMatrix = FloatArray(9)
SensorManager.getRotationMatrix(rotationMatrix, null, accelerometerReading, magnetometerReading)

// Express the updated rotation matrix as three orientation angles.
val orientationAngles = FloatArray(3)
SensorManager.getOrientation(rotationMatrix, orientationAngles)

Java

private SensorManager sensorManager;
...
// Rotation matrix based on current readings from accelerometer and magnetometer.
final float[] rotationMatrix = new float[9];
SensorManager.getRotationMatrix(rotationMatrix, null,
    accelerometerReading, magnetometerReading);

// Express the updated rotation matrix as three orientation angles.
final float[] orientationAngles = new float[3];
SensorManager.getOrientation(rotationMatrix, orientationAngles);

Hệ thống tính toán các góc hướng bằng cách sử dụng cảm biến trường địa từ của thiết bị kết hợp với gia tốc kế trên thiết bị. Bằng cách sử dụng 2 cảm biến phần cứng này, hệ thống sẽ cung cấp dữ liệu về 3 góc hướng sau:

  • Góc phương vị (độ quay quanh trục -z). Đây là góc giữa hướng la bàn hiện tại của thiết bị và hướng bắc từ. Nếu cạnh trên của thiết bị hướng về phía bắc có từ tính, thì góc phương vị là 0 độ; nếu cạnh trên cùng hướng về phía nam, góc phương vị là 180 độ. Tương tự, nếu cạnh trên hướng về phía đông, thì góc phương vị là 90 độ và nếu cạnh trên hướng về phía tây, thì góc phương vị là 270 độ.
  • Độ cao (độ xoay quanh trục x). Đây là góc giữa một mặt phẳng song song với màn hình của thiết bị và một mặt phẳng song song với mặt đất. Nếu bạn giữ thiết bị song song với mặt đất với cạnh dưới cùng gần bạn nhất và nghiêng cạnh trên của thiết bị về phía mặt đất, thì góc nghiêng sẽ trở thành dương. Nghiêng theo hướng ngược lại – di chuyển cạnh trên của thiết bị ra xa mặt đất – khiến góc cao độ trở thành âm. Phạm vi giá trị là -90 độ đến 90 độ.
  • Góc xoay (số độ xoay quanh trục y). Đây là góc giữa một mặt phẳng vuông góc với màn hình của thiết bị và một mặt phẳng vuông góc với mặt đất. Nếu bạn giữ thiết bị song song với mặt đất với cạnh dưới cùng gần bạn nhất và nghiêng cạnh trái của thiết bị về phía mặt đất, thì góc nghiêng sẽ trở thành dương. Việc nghiêng theo hướng ngược lại – di chuyển cạnh phải của thiết bị về phía mặt đất – sẽ khiến góc nghiêng trở thành âm. Phạm vi giá trị là từ -180 độ đến 180 độ.

Lưu ý: Định nghĩa về độ nghiêng của cảm biến đã thay đổi để phản ánh phần lớn các phương thức triển khai trong hệ sinh thái cảm biến địa lý.

Xin lưu ý rằng các góc này hoạt động từ một hệ toạ độ khác với hệ toạ độ dùng trong ngành hàng không (đối với độ lệch chuẩn, độ cao và độ xoay). Trong hệ thống hàng không, trục x nằm dọc theo cạnh dài của máy bay, từ đuôi đến mũi.

Cảm biến hướng lấy dữ liệu bằng cách xử lý dữ liệu cảm biến thô từ gia tốc kế và cảm biến từ trường địa lý. Do quá trình xử lý nặng, độ chính xác của cảm biến hướng sẽ bị giảm. Cụ thể, cảm biến này chỉ đáng tin cậy khi góc nghiêng là 0. Do đó, cảm biến hướng không còn được dùng trong Android 2.2 (API cấp 8) và loại cảm biến hướng không còn được dùng trong Android 4.4W (API cấp 20). Thay vì sử dụng dữ liệu thô từ cảm biến hướng, bạn nên sử dụng phương thức getRotationMatrix() kết hợp với phương thức getOrientation() để tính toán các giá trị hướng, như trong mã mẫu sau. Trong quá trình này, bạn có thể sử dụng phương thức remapCoordinateSystem() để dịch các giá trị hướng sang khung tham chiếu của ứng dụng.

Kotlin

class SensorActivity : Activity(), SensorEventListener {

    private lateinit var sensorManager: SensorManager
    private val accelerometerReading = FloatArray(3)
    private val magnetometerReading = FloatArray(3)

    private val rotationMatrix = FloatArray(9)
    private val orientationAngles = FloatArray(3)

    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.main)
        sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
    }

    override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
        // Do something here if sensor accuracy changes.
        // You must implement this callback in your code.
    }

    override fun onResume() {
        super.onResume()

        // Get updates from the accelerometer and magnetometer at a constant rate.
        // To make batch operations more efficient and reduce power consumption,
        // provide support for delaying updates to the application.
        //
        // In this example, the sensor reporting delay is small enough such that
        // the application receives an update before the system checks the sensor
        // readings again.
        sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER)?.also { accelerometer ->
            sensorManager.registerListener(
                    this,
                    accelerometer,
                    SensorManager.SENSOR_DELAY_NORMAL,
                    SensorManager.SENSOR_DELAY_UI
            )
        }
        sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD)?.also { magneticField ->
            sensorManager.registerListener(
                    this,
                    magneticField,
                    SensorManager.SENSOR_DELAY_NORMAL,
                    SensorManager.SENSOR_DELAY_UI
            )
        }
    }

    override fun onPause() {
        super.onPause()

        // Don't receive any more updates from either sensor.
        sensorManager.unregisterListener(this)
    }

    // Get readings from accelerometer and magnetometer. To simplify calculations,
    // consider storing these readings as unit vectors.
    override fun onSensorChanged(event: SensorEvent) {
        if (event.sensor.type == Sensor.TYPE_ACCELEROMETER) {
            System.arraycopy(event.values, 0, accelerometerReading, 0, accelerometerReading.size)
        } else if (event.sensor.type == Sensor.TYPE_MAGNETIC_FIELD) {
            System.arraycopy(event.values, 0, magnetometerReading, 0, magnetometerReading.size)
        }
    }

    // Compute the three orientation angles based on the most recent readings from
    // the device's accelerometer and magnetometer.
    fun updateOrientationAngles() {
        // Update rotation matrix, which is needed to update orientation angles.
        SensorManager.getRotationMatrix(
                rotationMatrix,
                null,
                accelerometerReading,
                magnetometerReading
        )

        // "rotationMatrix" now has up-to-date information.

        SensorManager.getOrientation(rotationMatrix, orientationAngles)

        // "orientationAngles" now has up-to-date information.
    }
}

Java

public class SensorActivity extends Activity implements SensorEventListener {

    private SensorManager sensorManager;
    private final float[] accelerometerReading = new float[3];
    private final float[] magnetometerReading = new float[3];

    private final float[] rotationMatrix = new float[9];
    private final float[] orientationAngles = new float[3];

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
    }

    @Override
    public void onAccuracyChanged(Sensor sensor, int accuracy) {
        // Do something here if sensor accuracy changes.
        // You must implement this callback in your code.
    }

    @Override
    protected void onResume() {
        super.onResume();

        // Get updates from the accelerometer and magnetometer at a constant rate.
        // To make batch operations more efficient and reduce power consumption,
        // provide support for delaying updates to the application.
        //
        // In this example, the sensor reporting delay is small enough such that
        // the application receives an update before the system checks the sensor
        // readings again.
        Sensor accelerometer = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
        if (accelerometer != null) {
            sensorManager.registerListener(this, accelerometer,
                SensorManager.SENSOR_DELAY_NORMAL, SensorManager.SENSOR_DELAY_UI);
        }
        Sensor magneticField = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
        if (magneticField != null) {
            sensorManager.registerListener(this, magneticField,
                SensorManager.SENSOR_DELAY_NORMAL, SensorManager.SENSOR_DELAY_UI);
        }
    }

    @Override
    protected void onPause() {
        super.onPause();

        // Don't receive any more updates from either sensor.
        sensorManager.unregisterListener(this);
    }

    // Get readings from accelerometer and magnetometer. To simplify calculations,
    // consider storing these readings as unit vectors.
    @Override
    public void onSensorChanged(SensorEvent event) {
        if (event.sensor.getType() == Sensor.TYPE_ACCELEROMETER) {
          System.arraycopy(event.values, 0, accelerometerReading,
              0, accelerometerReading.length);
        } else if (event.sensor.getType() == Sensor.TYPE_MAGNETIC_FIELD) {
            System.arraycopy(event.values, 0, magnetometerReading,
                0, magnetometerReading.length);
        }
    }

    // Compute the three orientation angles based on the most recent readings from
    // the device's accelerometer and magnetometer.
    public void updateOrientationAngles() {
        // Update rotation matrix, which is needed to update orientation angles.
        SensorManager.getRotationMatrix(rotationMatrix, null,
            accelerometerReading, magnetometerReading);

        // "rotationMatrix" now has up-to-date information.

        SensorManager.getOrientation(rotationMatrix, orientationAngles);

        // "orientationAngles" now has up-to-date information.
    }
}

Thường thì bạn không cần thực hiện bất kỳ hoạt động xử lý hoặc lọc dữ liệu nào của góc hướng thô của thiết bị, ngoài việc dịch hệ toạ độ của cảm biến sang khung tham chiếu của ứng dụng.

Sử dụng cảm biến từ trường

Cảm biến trường địa từ cho phép bạn theo dõi những thay đổi trong trường từ của trái đất. Mã sau đây cho bạn biết cách tải một thực thể của cảm biến trường địa từ mặc định:

Kotlin

private lateinit var sensorManager: SensorManager
private var sensor: Sensor? = null
...
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD)

Java

private SensorManager sensorManager;
private Sensor sensor;
...
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);

Lưu ý: Nếu ứng dụng của bạn nhắm đến Android 12 (API cấp 31) trở lên, thì cảm biến này sẽ bị giới hạn tốc độ.

Cảm biến này cung cấp dữ liệu cường độ trường thô (tính bằng μT) cho mỗi trục toạ độ trong số 3 trục. Thông thường, bạn không cần sử dụng trực tiếp cảm biến này. Thay vào đó, bạn có thể sử dụng cảm biến vectơ xoay để xác định chuyển động quay thô hoặc bạn có thể sử dụng cảm biến gia tốc kế và cảm biến trường địa từ với phương thức getRotationMatrix() để lấy ma trận xoay và ma trận độ nghiêng. Sau đó, bạn có thể sử dụng các ma trận này với các phương thức getOrientation()getInclination() để lấy dữ liệu độ nghiêng từ trường địa lý và phương vị.

Lưu ý: Khi kiểm thử ứng dụng, bạn có thể cải thiện độ chính xác của cảm biến bằng cách vẫy thiết bị theo mẫu hình-8.

Sử dụng cảm biến từ trường chưa được hiệu chuẩn

Máy đo từ trường chưa hiệu chỉnh tương tự như cảm biến từ trường địa từ, ngoại trừ việc không áp dụng quy trình hiệu chỉnh sắt cứng cho từ trường. Hoạt động hiệu chuẩn tại nhà máy và bù trừ nhiệt độ vẫn được áp dụng cho trường từ. Từ kế chưa được hiệu chỉnh rất hữu ích trong việc xử lý các ước tính về sắt cứng có chất lượng kém. Nói chung, geomagneticsensor_event.values[0] sẽ gần với uncalibrated_magnetometer_event.values[0] - uncalibrated_magnetometer_event.values[3]. Tức là,

calibrated_x ~= uncalibrated_x - bias_estimate_x

Lưu ý: Các cảm biến chưa được hiệu chỉnh cung cấp nhiều kết quả thô hơn và có thể có một số độ chệch. Tuy nhiên, kết quả đo lường của các cảm biến này có ít bước nhảy hơn so với các giá trị hiệu chỉnh được áp dụng trong quá trình hiệu chuẩn. Một số ứng dụng có thể muốn các kết quả chưa được hiệu chỉnh này mượt mà và đáng tin cậy hơn. Ví dụ: nếu một ứng dụng đang cố gắng thực hiện quá trình hợp nhất cảm biến của riêng mình, thì việc đưa ra các phép hiệu chuẩn thực sự có thể làm méo kết quả.

Ngoài trường từ, cảm biến từ trường chưa được hiệu chuẩn cũng cung cấp độ lệch sắt cứng ước tính theo từng trục. Mã sau đây cho bạn biết cách lấy một thực thể của con quay hồi chuyển từ trường chưa được hiệu chuẩn mặc định:

Kotlin

private lateinit var sensorManager: SensorManager
private var sensor: Sensor? = null
...
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD_UNCALIBRATED)

Java

private SensorManager sensorManager;
private Sensor sensor;
...
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD_UNCALIBRATED);

Sử dụng cảm biến độ gần

Cảm biến khoảng cách cho phép bạn xác định khoảng cách của một vật thể so với thiết bị. Mã sau đây cho bạn biết cách lấy một thực thể của cảm biến khoảng cách mặc định:

Kotlin

private lateinit var sensorManager: SensorManager
private var sensor: Sensor? = null
...
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY)

Java

private SensorManager sensorManager;
private Sensor sensor;
...
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
sensor = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY);

Cảm biến khoảng cách thường được dùng để xác định khoảng cách từ đầu người dùng đến mặt thiết bị cầm tay (ví dụ: khi người dùng đang thực hiện hoặc nhận cuộc gọi điện thoại). Hầu hết cảm biến khoảng cách trả về khoảng cách tuyệt đối, tính bằng cm, nhưng một số cảm biến chỉ trả về các giá trị gần và xa.

Lưu ý: Trên một số mẫu thiết bị, cảm biến độ gần nằm bên dưới màn hình. Điều này có thể khiến một dấu chấm nhấp nháy xuất hiện trên màn hình nếu bạn bật cảm biến này khi màn hình đang bật.

Đoạn mã sau đây cho bạn biết cách sử dụng cảm biến độ gần:

Kotlin

class SensorActivity : Activity(), SensorEventListener {

    private lateinit var sensorManager: SensorManager
    private var proximity: Sensor? = null

    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.main)

        // Get an instance of the sensor service, and use that to get an instance of
        // a particular sensor.
        sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
        proximity = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY)
    }

    override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
        // Do something here if sensor accuracy changes.
    }

    override fun onSensorChanged(event: SensorEvent) {
        val distance = event.values[0]
        // Do something with this sensor data.
    }

    override fun onResume() {
        // Register a listener for the sensor.
        super.onResume()

        proximity?.also { proximity ->
            sensorManager.registerListener(this, proximity, SensorManager.SENSOR_DELAY_NORMAL)
        }
    }

    override fun onPause() {
        // Be sure to unregister the sensor when the activity pauses.
        super.onPause()
        sensorManager.unregisterListener(this)
    }
}

Java

public class SensorActivity extends Activity implements SensorEventListener {
    private SensorManager sensorManager;
    private Sensor proximity;

    @Override
    public final void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        // Get an instance of the sensor service, and use that to get an instance of
        // a particular sensor.
        sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
        proximity = sensorManager.getDefaultSensor(Sensor.TYPE_PROXIMITY);
    }

    @Override
    public final void onAccuracyChanged(Sensor sensor, int accuracy) {
        // Do something here if sensor accuracy changes.
    }

    @Override
    public final void onSensorChanged(SensorEvent event) {
        float distance = event.values[0];
        // Do something with this sensor data.
    }

    @Override
    protected void onResume() {
        // Register a listener for the sensor.
        super.onResume();
        sensorManager.registerListener(this, proximity, SensorManager.SENSOR_DELAY_NORMAL);
      }

    @Override
    protected void onPause() {
        // Be sure to unregister the sensor when the activity pauses.
        super.onPause();
        sensorManager.unregisterListener(this);
    }
}

Lưu ý: Một số cảm biến độ gần trả về các giá trị nhị phân biểu thị "gần" hoặc "xa". Trong trường hợp này, cảm biến thường báo cáo giá trị phạm vi tối đa ở trạng thái xa và giá trị thấp hơn ở trạng thái gần. Thông thường, giá trị xa là giá trị > 5 cm, nhưng giá trị này có thể khác nhau giữa các cảm biến. Bạn có thể xác định phạm vi tối đa của cảm biến bằng cách sử dụng phương thức getMaximumRange().

Bạn cũng nên đọc