private lateinit var sensorManager: SensorManager
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
if (sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD) != null) {
    // Success! There's a magnetometer.
} else {
    // Failure! No magnetometer.
private SensorManager sensorManager;
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
if (sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD) != null){
    // Success! There's a magnetometer.
} else {
    // Failure! No magnetometer.
注意：Android 对于设备制造商在其 Android 设备中内置的传感器类型没有特殊要求，因此设备可以采用各种传感器配置。
除了列出设备上的传感器之外，您还可以使用 Sensor 类的公共方法确定单个传感器的功能和属性。如果您希望应用根据设备上可用的传感器或传感器功能表现出不同的行为，这会非常有用。例如，您可以使用 getResolution() 和 getMaximumRange() 方法来获得传感器的分辨率和最大量程。您也可以使用 getPower() 方法来获得传感器的电源要求。
如果您希望针对不同制造商的传感器或传感器的不同版本优化您的应用，有两种公共方法特别有用。例如，如果您的应用需要监控倾斜和摇晃等用户手势，您可以为具有特定供应商的重力传感器的新设备创建一组数据过滤规则和优化，并为没有重力传感器且只有加速度计的设备创建另一组数据过滤规则和优化。以下代码示例展示了如何使用 getVendor() 和 getVersion() 方法来执行此操作。在本例中，我们要查找一个将 Google LLC 列为供应商、版本号为 3 的重力传感器。如果设备上没有该传感器，我们会尝试使用加速度计。
Kotlin
private lateinit var sensorManager: SensorManager
private var mSensor: Sensor? = null
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
if (sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY) != null) {
    val gravSensors: List<Sensor> = sensorManager.getSensorList(Sensor.TYPE_GRAVITY)
    // Use the version 3 gravity sensor.
    mSensor = gravSensors.firstOrNull { it.vendor.contains("Google LLC") && it.version == 3 }
if (mSensor == null) {
    // Use the accelerometer.
    mSensor = if (sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER) != null) {
        sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER)
    } else {
        // Sorry, there are no accelerometers on your device.
        // You can't play this game.
private SensorManager sensorManager;
private Sensor mSensor;
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
mSensor = null;
if (sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY) != null){
    List<Sensor> gravSensors = sensorManager.getSensorList(Sensor.TYPE_GRAVITY);
    for(int i=0; i<gravSensors.size(); i++) {
        if ((gravSensors.get(i).getVendor().contains("Google LLC"))




    
 &&
           (gravSensors.get(i).getVersion() == 3)){
            // Use the version 3 gravity sensor.
            mSensor = gravSensors.get(i);
if (mSensor == null){
    // Use the accelerometer.
    if (sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER) != null){
        mSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
    } else{
        // Sorry, there are no accelerometers on your device.
        // You can't play this game.
另一个有用的方法是 getMinDelay() 方法，它会返回传感器可用于检测数据的最小时间间隔（以微秒为单位）。如果 getMinDelay() 方法返回非零值，则表示相应传感器为流式传感器。流式传感器是在 Android 2.3（API 级别 9）中引入的，这类传感器会定期检测数据。如果调用 getMinDelay() 方法时，传感器返回 0，则说明传感器不是流式传感器，因为它仅在所检测的参数发生变化时才会报告数据。
getMinDelay() 方法可用于确定传感器采集数据的最高频率。如果应用中的某些功能需要较高的数据采集频率或流式传感器，则可以使用此方法确定传感器是否满足这些要求，然后相应地启用或停用应用中的相关功能。
注意：传感器的最高数据采集频率不一定是传感器框架向应用提交传感器数据的频率。传感器框架通过传感器事件报告数据，而应用接收传感器事件的频率受多个因素的影响。如需了解详情，请参阅监控传感器事件。
监控传感器事件
要监控原始传感器数据，您需要实现两个通过 SensorEventListener 接口公开的回调方法：onAccuracyChanged() 和 onSensorChanged()。Android 系统会在发生以下情况时调用这两个方法：
  
传感器的准确度发生了变化。
在这种情况下，系统会调用 onAccuracyChanged() 方法，为您提供对于发生变化的 Sensor 对象的引用以及传感器的新准确度。准确度由以下 4 个状态常量之一表示：SENSOR_STATUS_ACCURACY_LOW、SENSOR_STATUS_ACCURACY_MEDIUM、SENSOR_STATUS_ACCURACY_HIGH 或 SENSOR_STATUS_UNRELIABLE。
  
传感器报告了新值。
    
在这种情况下，系统会调用 onSensorChanged() 方法，为您提供 SensorEvent 对象。SensorEvent 对象包含关于新传感器数据的信息，包括：数据的准确度、生成数据的传感器、生成数据的时间戳以及传感器记录的新数据。
以下代码展示了如何使用 onSensorChanged() 方法监控光传感器的数据。在本示例中，原始传感器数据作为 sensor_data 显示在 main.xml 文件中定义的 TextView 中。
Kotlin
class SensorActivity : Activity(), SensorEventListener {
    private lateinit var sensorManager: SensorManager
    private var mLight: Sensor? = null
    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.main)
        sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
        mLight = sensorManager.getDefaultSensor(Sensor.TYPE_LIGHT)
    override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
        // Do something here if sensor accuracy changes.
    override fun onSensorChanged(event: SensorEvent) {
        // The light sensor returns a single value.
        // Many sensors return 3 values, one for each axis.
        val lux = event.values[0]
        // Do something with this sensor value.
    override fun onResume() {
        super.onResume()
        mLight?.also { light ->
            sensorManager.registerListener(this, light, SensorManager.SENSOR_DELAY_NORMAL)
    override fun onPause() {
        super.onPause()
        sensorManager.unregisterListener(this)
public class SensorActivity extends Activity implements SensorEventListener {
    private SensorManager sensorManager;
    private Sensor mLight;
    @Override
    public final void onCreate(Bundle savedInstanceState) {
        




    
super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
        mLight = sensorManager.getDefaultSensor(Sensor.TYPE_LIGHT);
    @Override
    public final void onAccuracyChanged(Sensor sensor, int accuracy) {
        // Do something here if sensor accuracy changes.
    @Override
    public final void onSensorChanged(SensorEvent event) {
        // The light sensor returns a single value.
        // Many sensors return 3 values, one for each axis.
        float lux = event.values[0];
        // Do something with this sensor value.
    @Override
    protected void onResume() {
        super.onResume();
        sensorManager.registerListener(this, mLight, SensorManager.SENSOR_DELAY_NORMAL);
    @Override
    protected void onPause() {
        super.onPause();
        sensorManager.unregisterListener(this);
在本示例中，在调用 registerListener() 方法时指定了默认数据延迟 (SENSOR_DELAY_NORMAL)。数据延迟（或采样率）控制传感器事件通过 onSensorChanged() 回调方法发送到应用的时间间隔。默认数据延迟采用 200,000 微秒的延迟，适用于监控典型的屏幕方向变化。您可以指定其他数据延迟，比如 SENSOR_DELAY_GAME（延迟 20,000 微秒）、SENSOR_DELAY_UI（延迟 60,000 微秒），或 SENSOR_DELAY_FASTEST（延迟 0 微秒）。从 Android 3.0（API 级别 11）开始，您还可以将延迟指定为以微秒为单位的绝对值。
您指定的延迟只是建议的延迟。Android 系统和其他应用可以更改此延迟。最佳做法是指定尽可能大的延迟，因为系统通常会使用比您指定的延迟更小的延迟（也就是说，您应该选择能够满足应用需求的最低采样率）。使用更大的延迟可以降低处理器的负载，从而降低功耗。
没有任何公共方法可以确定传感器框架向您的应用发送传感器事件的频率，但是，您可以使用与每个传感器事件关联的时间戳来计算几个事件的采样率。采样率（延迟）一旦设置，就不应该再更改。如果由于某种原因确实需要更改延迟，则必须取消注册再重新注册传感器监听器。
另外还需要注意的是，本示例使用 onResume() 和 onPause() 回调方法来注册和取消注册传感器事件监听器。最佳的做法是始终停用不需要的传感器，特别是在活动处于暂停状态时。如果不这样做，可能会在几小时内将电池电量耗尽，因为有些传感器的电量需求很大，可以很快耗尽电池电量。当屏幕关闭时，系统不会自动停用传感器。
处理不同的传感器配置
Android 没有为设备指定标准的传感器配置，这意味着设备制造商可以在其 Android 设备中采用任何想要的传感器配置。因此，设备可以包含采用各种配置的各种传感器。如果您的应用依赖于特定类型的传感器，则必须确保设备上存在该传感器，这样您的应用才能成功运行。
有两种方法可以确保设备上存在特定的传感器：
  
在运行时检测传感器，并根据需要启用或停用应用功能。
  
使用 Google Play 过滤器定位具有特定传感器配置的设备。
下面将分别讨论这两种方法。
在运行时检测传感器
如果您的应用使用特定类型的传感器，但不依赖于它，则可以使用传感器框架在运行时检测传感器，然后根据需要停用或启用应用功能。例如，导航应用可能会使用温度传感器、压力传感器、GPS 传感器和地磁场传感器来显示温度、气压、位置和罗盘方位。如果设备没有压力传感器，您可以使用传感器框架在运行时检测压力传感器的缺失，然后停用应用界面中显示压力的部分。例如，以下代码会检查设备上是否有压力传感器：
Kotlin
private lateinit var sensorManager: SensorManager
sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager
if (sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE) != null) {
    // Success! There's a pressure sensor.
} else {
    // Failure! No pressure sensor.
private SensorManager sensorManager;
sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
if (sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE) != null){
    // Success! There's a pressure sensor.
} else {
    // Failure! No pressure sensor.
使用 Google Play 过滤器定位特定的传感器配置
如果您要在 Google Play 上发布应用，您可以在清单文件中使用 <uses-feature>
     元素，以对不具备适合您应用的传感器配置的设备屏蔽您的应用。<uses-feature> 元素有几个硬件描述符，可让您根据是否存在特定传感器来过滤应用。您可以列出的传感器包括：加速度计、气压计、罗盘（地磁场）、陀螺仪、光传感器和距离传感器。以下清单示例条目会对没有加速度计的设备屏蔽应用：
<uses-feature android:name="android.hardware.sensor.accelerometer"
              android:required="true" />
如果您将此元素和描述符添加到应用的清单中，那么只有当用户的设备具有加速度计时，他们才会在 Google Play 上看到您的应用。
仅当您的应用完全依赖于特定传感器时，才应将描述符设置为 android:required="true"。如果您的应用使用某种传感器来实现某项功能，但没有该传感器也可以运行，那么您就应该在 <uses-feature> 元素中列出该传感器，但将描述符设置为 android:required="false"。这样可以确保设备即使没有该传感器也可以安装您的应用。这也是帮助您跟踪应用所使用的功能的最佳项目管理方法。请记住，如果您的应用使用特定的传感器，但没有该传感器也能运行，那么您就应该在运行时检测传感器，并根据需要停用或启用应用功能。
传感器坐标系
通常，传感器框架使用标准的 3 轴坐标系来表示数据值。对于大多数传感器，当设备处于默认屏幕方向时，会相对于设备屏幕来定义坐标系（参见图 1）。当设备处于默认屏幕方向时，X 轴为水平向右延伸，Y 轴为垂直向上延伸，Z 轴为垂直于屏幕向外延伸。在此坐标系中，屏幕后面的坐标将具有负 Z 值。以下传感器使用此坐标系：
关于此坐标系，特别需要注意的一点就是当设备的屏幕方向改变时，坐标轴不会转换，也就是说，传感器的坐标系不会随着设备的移动而改变。此行为与 OpenGL 坐标系的行为是相同的。
还需要注意的一点是，您的应用不能假设设备的自然（默认）屏幕方向是竖屏。许多平板设备的自然屏幕方向为横屏。传感器坐标系始终基于设备的自然屏幕方向。
最后，如果您的应用将传感器数据对应到屏幕显示，您需要使用 getRotation() 方法确定屏幕的旋转度，然后使用 remapCoordinateSystem() 方法将传感器坐标映射到屏幕坐标。即使您的清单指定了仅限竖屏显示，您也需要这样做。
注意：有些传感器和方法使用的坐标系基于世界参照系（而不是设备参照系）。这些传感器和方法返回的数据表示设备相对于地球的运动或位置。如需了解详情，请参阅 getOrientation() 方法、getRotationMatrix() 方法、屏幕方向传感器和旋转矢量传感器。
传感器速率限制
为了保护有关用户的潜在敏感信息，如果您的应用以 Android 12（API 级别 31）或更高版本为目标平台，系统会对来自某些移动传感器和位置传感器的数据的刷新率施加限制。这些数据包括由设备的加速度计、陀螺仪和地磁场传感器记录的值。
刷新率限制取决于您访问传感器数据的方式：
如果您调用 registerListener() 方法来监控传感器事件，则传感器采样率限制为 200 Hz。对于 registerListener() 方法的所有过载变体都是如此。
如果您使用 SensorDirectChannel 类，则传感器采样率限制为 RATE_NORMAL，通常约为 50 Hz。
如果您的应用需要以较高的采样率收集移动传感器数据，则必须声明 HIGH_SAMPLING_RATE_SENSORS 权限，如以下代码段所示。否则，如果您的应用尝试在未声明此权限的情况下以较高的采样率收集移动传感器数据，就会发生 SecurityException。
AndroidManifest.xml
<manifest ...>
    <uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS"/>
    <application ...>
    </application>
</manifest>

访问和使用传感器的最佳做法
在设计传感器实现时，请务必遵循本节介绍的指导原则。若要使用传感器框架访问传感器和采集传感器数据，建议将这些指导原则视为最佳实践。
仅在前台采集传感器数据
在搭载 Android 9（API 级别 28）或更高版本的设备上，在后台运行的应用具有以下限制：
  
采用连续报告模式的传感器（如加速度计和陀螺仪）不会收到事件。
  
使用变化时触发或单次报告模式的传感器不会收到事件。
考虑到这些限制，最好是在应用于前台运行或作为前台服务的一部分时检测传感器事件。
取消注册传感器监听器
请务必在不使用传感器或传感器活动暂停时取消注册传感器的监听器。注册传感器监听器后，只要不取消注册传感器，那么即使监听器的活动已暂停，传感器仍会继续采集数据并消耗电池资源。以下代码展示了如何使用 onPause() 方法来取消注册监听器：
Kotlin
private lateinit var sensorManager: SensorManager
override fun onPause() {
    super.onPause()
    sensorManager.unregisterListener(this)
private SensorManager sensorManager;
@Override
protected void onPause() {
    super.onPause();
    sensorManager.unregisterListener(this);
如需了解详情，请参阅 unregisterListener(SensorEventListener)。
使用 Android 模拟器进行测试
Android 模拟器包含一组虚拟传感器控件，可用来测试各种传感器，如加速度计、环境温度传感器、磁力计、距离传感器、光传感器等。
模拟器会与运行 SdkControllerSensor 应用的 Android 设备建立连接。请注意，此应用仅适用于搭载 Android 4.0（API 级别 14）或更高版本的设备。（如果设备搭载的是 Android 4.0，则必须安装修订版本 2。）SdkControllerSensor 应用会监控设备上传感器的变化，并将相关数据传输到模拟器。然后，模拟器会根据从设备传感器收到的新值做出相应的转变。

您可以在以下位置查看 SdkControllerSensor 应用的源代码：
$ your-android-sdk-directory/tools/apps/SdkController
如需在设备和模拟器之间传输数据，请按以下步骤操作：
  
检查设备上是否启用了 USB 调试功能。
  
使用 USB 数据线将设备连接到开发计算机。
  
在设备上启动 SdkControllerSensor 应用。

  
在应用中，选择您要模拟的传感器。
  
运行以下 adb 命令：
$ adb forward tcp:1968 tcp:1968
  
启动模拟器。现在，您应该可以通过移动设备将转变应用到模拟器。
注意： 如果您对物理设备的移动没有让模拟器发生转变，请尝试再次运行第 5 步中的 adb 命令。
如需了解详情，请参阅 Android 模拟器指南。
请勿阻塞 onSensorChanged() 方法
传感器数据可以以很高的频率变化，这意味着系统可能会频繁调用 onSensorChanged(SensorEvent) 方法。最佳的做法是在 onSensorChanged(SensorEvent) 方法中执行尽可能少的任务，以免阻塞它。如果您的应用要求您过滤或删减传感器数据，则应在 onSensorChanged(SensorEvent) 方法之外执行该任务。
避免使用已弃用的方法或传感器类型
有一些方法和常量已被弃用。
特别是 TYPE_ORIENTATION 传感器类型已被弃用。应改用 getOrientation() 方法来获取屏幕方向数据。同样，TYPE_TEMPERATURE 传感器类型也已被弃用。您应在搭载 Android 4.0 的设备上改用 TYPE_AMBIENT_TEMPERATURE 传感器类型。
使用传感器之前应先进行验证
在尝试从传感器采集数据之前，应始终先验证设备上是否存在该传感器。不要因为某种传感器很常用就假设它存在。没有人要求设备制造商必须在其设备中提供任何特定的传感器。
谨慎选择传感器延迟
使用 registerListener() 方法注册传感器时，请务必选择适合您的应用或用例的提交频率。传感器能以非常高的频率提供数据。允许系统发送您不需要的额外数据，会浪费系统资源和耗费电池电量。
      [[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2026-03-31。"],[],[]]