أدوات استشعار البيئة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوفر نظام Android الأساسي أربعة أدوات استشعار تتيح لك مراقبة الخصائص البيئية المختلفة.
يمكنك استخدام أدوات الاستشعار هذه لرصد الرطوبة المحيطة والإضاءة والضغط المحيطي
درجة الحرارة المحيطة بالقرب من جهاز يعمل بنظام التشغيل Android تعتمد جميع أدوات استشعار البيئة الأربعة على الأجهزة
ولا تتوفر إلا إذا كانت الشركة المصنعة للجهاز قد ضمّنتها في الجهاز. باستثناء
مستشعر الضوء، الذي تستخدمه معظم الشركات المصنعة للأجهزة للتحكم في سطوع الشاشة، والبيئة
التي لا تتوفر دائمًا على الأجهزة. لهذا السبب، من المهم بشكل خاص أن
التحقق في وقت التشغيل مما إذا كان هناك جهاز استشعار للبيئة قبل أن تحاول الحصول على البيانات من
بها.
على عكس معظم مستشعرات الحركة وأجهزة استشعار الموضع، التي تعرض مصفوفة متعددة الأبعاد من أجهزة الاستشعار
قيم لكل SensorEvent
، ينتج عن أدوات استشعار البيئة جهاز استشعار واحد
قيمة لكل حدث بيانات. على سبيل المثال، درجة الحرارة بالدرجة المئوية (°م) أو الضغط بالهكتار (hPa).
وعلى عكس أدوات استشعار الحركة وأجهزة استشعار الموضع، التي غالبًا ما تتطلب تمريرًا عاليًا أو تمريرًا منخفضًا
فإن مستشعرات البيئة لا تتطلب عادةً أي تصفية للبيانات أو معالجة للبيانات. على الطاولة
1. ملخصًا لاستشعارات البيئة المتوافقة مع نظام Android الأساسي.
الجدول 1. أجهزة استشعار البيئة المتاحة على نظام Android الأساسي
1 تختلف عمليات التنفيذ من جهاز إلى آخر.
الخاص بك. تم إيقاف أداة الاستشعار هذه نهائيًا في الإصدار Android 4.0 (المستوى 14 من واجهة برمجة التطبيقات).
استخدام أجهزة استشعار الإضاءة والضغط ودرجة الحرارة
عادةً ما لا تتطلب البيانات الأولية التي تحصل عليها من مستشعرات الضوء والضغط ودرجة الحرارة
المعايرة أو التصفية أو التعديل، مما يجعلها من أسهل أدوات الاستشعار في الاستخدام. إلى
في هذه المرحلة، يتم جمع البيانات من أجهزة الاستشعار هذه، ما عليك أولاً إنشاء مثيل من الفئة SensorManager
، ويمكنك استخدام هذه البيانات للحصول على نسخة افتراضية من جهاز استشعار مادي.
بعد ذلك، يتم تسجيل أداة استماع أداة استشعار باستخدام طريقة onResume()
، وبدء معالجة بيانات جهاز الاستشعار الواردة وفق طريقة معاودة الاتصال onSensorChanged()
. تشير رسالة الأشكال البيانية
الرمز التالي كيفية القيام بذلك:
Kotlin
class SensorActivity : Activity(), SensorEventListener {
private lateinit var sensorManager: SensorManager
private var pressure: 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
pressure = sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE)
}
override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
// Do something here if sensor accuracy changes.
}
override fun onSensorChanged(event: SensorEvent) {
val millibarsOfPressure = event.values[0]
// Do something with this sensor data.
}
override fun onResume() {
// Register a listener for the sensor.
super.onResume()
sensorManager.registerListener(this, pressure, 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 pressure;
@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);
pressure = sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE);
}
@Override
public final void onAccuracyChanged(Sensor sensor, int accuracy) {
// Do something here if sensor accuracy changes.
}
@Override
public final void onSensorChanged(SensorEvent event) {
float millibarsOfPressure = event.values[0];
// Do something with this sensor data.
}
@Override
protected void onResume() {
// Register a listener for the sensor.
super.onResume();
sensorManager.registerListener(this, pressure, SensorManager.SENSOR_DELAY_NORMAL);
}
@Override
protected void onPause() {
// Be sure to unregister the sensor when the activity pauses.
super.onPause();
sensorManager.unregisterListener(this);
}
}
يجب أن تضمِّن دائمًا عمليات تنفيذ لكل من طريقة معاودة الاتصال onAccuracyChanged()
وonSensorChanged()
. كن أيضًا
احرِص دائمًا على إلغاء تسجيل جهاز الاستشعار عند توقُّف أحد الأنشطة مؤقتًا. يمنع هذا الإجراء المستشعر من
استشعار البيانات باستمرار واستنزاف البطارية.
استخدام جهاز استشعار الرطوبة
يمكنك الحصول على بيانات الرطوبة النسبية النسبية باستخدام جهاز استشعار الرطوبة بالطريقة نفسها التي تستخدمها.
بأجهزة استشعار الضوء والضغط والحرارة. ومع ذلك، إذا كان الجهاز يحتوي على كل من جهاز استشعار للرطوبة
(TYPE_RELATIVE_HUMIDITY
) وجهاز استشعار الحرارة (TYPE_AMBIENT_TEMPERATURE
)، يمكنك استخدام مصدرَي البيانات هذين لاحتساب
ونقطة التكثُّف والرطوبة المطلقة.
درجة التكثُّف
نقطة التكثُّف هي درجة الحرارة التي يجب أن يبرد عندها حجم معيّن من الهواء بشكل ثابت.
الضغط البارومتري، حتى يكثف بخار الماء في الماء. توضح المعادلة التالية كيف يمكنك
حساب نقطة التكثف:
أين،
- td = درجة حرارة التكثف بالدرجة المئوية
- t = درجة الحرارة الفعلية بالدرجة المئوية
- RH = الرطوبة النسبية الفعلية بالنسبة المئوية (%)
- m = 17.62
- Tn = 243.12
الرطوبة المطلقة
الرطوبة المطلقة هي كتلة بخار الماء في حجم معين من الهواء الجاف. ارتفاع مطلق
يتم قياس مستوى الرطوبة بالغرام/المتر3. توضح المعادلة التالية كيف يمكنك
حساب الرطوبة المطلقة:
أين،
- dv = الرطوبة المطلقة بالجرام/المتر3
- t = درجة الحرارة الفعلية بالدرجة المئوية
- RH = الرطوبة النسبية الفعلية بالنسبة المئوية (%)
- m = 17.62
- Tn = 243.12 درجة مئوية
- A = 6.112 هكتار
يجب عليك أيضًا قراءة
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Environment sensors\n\nThe Android platform provides four sensors that let you monitor various environmental properties.\nYou can use these sensors to monitor relative ambient humidity, illuminance, ambient pressure, and\nambient temperature near an Android-powered device. All four environment sensors are hardware-based\nand are available only if a device manufacturer has built them into a device. With the exception of\nthe light sensor, which most device manufacturers use to control screen brightness, environment\nsensors are not always available on devices. Because of this, it's particularly important that you\nverify at runtime whether an environment sensor exists before you attempt to acquire data from\nit.\n\nUnlike most motion sensors and position sensors, which return a multi-dimensional array of sensor\nvalues for each [SensorEvent](/reference/android/hardware/SensorEvent), environment sensors return a single sensor\nvalue for each data event. For example, the temperature in °C or the pressure in hPa.\nAlso, unlike motion sensors and position sensors, which often require high-pass or low-pass\nfiltering, environment sensors do not typically require any data filtering or data processing. Table\n1 provides a summary of the environment sensors that are supported on the Android platform.\n\n\n**Table 1.** Environment sensors that are supported on the Android platform.\n\n| Sensor | Sensor event data | Units of measure | Data description |\n|-----------------------------------------------------------------------------------------|-------------------|------------------|----------------------------|\n| [TYPE_AMBIENT_TEMPERATURE](/reference/android/hardware/Sensor#TYPE_AMBIENT_TEMPERATURE) | `event.values[0]` | °C | Ambient air temperature. |\n| [TYPE_LIGHT](/reference/android/hardware/Sensor#TYPE_LIGHT) | `event.values[0]` | lx | Illuminance. |\n| [TYPE_PRESSURE](/reference/android/hardware/Sensor#TYPE_PRESSURE) | `event.values[0]` | hPa or mbar | Ambient air pressure. |\n| [TYPE_RELATIVE_HUMIDITY](/reference/android/hardware/Sensor#TYPE_RELATIVE_HUMIDITY) | `event.values[0]` | % | Ambient relative humidity. |\n| [TYPE_TEMPERATURE](/reference/android/hardware/Sensor#TYPE_TEMPERATURE) | `event.values[0]` | °C | Device temperature.^1^ |\n\n^**1**^ Implementations vary from device to\ndevice. This sensor was deprecated in Android 4.0 (API Level 14).\n\nUse the light, pressure, and temperature sensors\n------------------------------------------------\n\nThe raw data you acquire from the light, pressure, and temperature sensors usually requires no\ncalibration, filtering, or modification, which makes them some of the easiest sensors to use. To\nacquire data from these sensors you first create an instance of the [SensorManager](/reference/android/hardware/SensorManager) class, which you can use to get an instance of a physical sensor.\nThen you register a sensor listener in the [onResume()](/reference/android/app/Activity#onResume()) method, and start handling incoming sensor data in the [onSensorChanged()](/reference/android/hardware/SensorEventListener#onSensorChanged(android.hardware.SensorEvent)) callback method. The\nfollowing code shows you how to do this: \n\n### Kotlin\n\n```kotlin\nclass SensorActivity : Activity(), SensorEventListener {\n\n private lateinit var sensorManager: SensorManager\n private var pressure: Sensor? = null\n\n public override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n setContentView(R.layout.main)\n\n // Get an instance of the sensor service, and use that to get an instance of\n // a particular sensor.\n sensorManager = getSystemService(Context.SENSOR_SERVICE) as SensorManager\n pressure = sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE)\n }\n\n override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {\n // Do something here if sensor accuracy changes.\n }\n\n override fun onSensorChanged(event: SensorEvent) {\n val millibarsOfPressure = event.values[0]\n // Do something with this sensor data.\n }\n\n override fun onResume() {\n // Register a listener for the sensor.\n super.onResume()\n sensorManager.registerListener(this, pressure, SensorManager.SENSOR_DELAY_NORMAL)\n }\n\n override fun onPause() {\n // Be sure to unregister the sensor when the activity pauses.\n super.onPause()\n sensorManager.unregisterListener(this)\n }\n}\n```\n\n### Java\n\n```java\npublic class SensorActivity extends Activity implements SensorEventListener {\n private SensorManager sensorManager;\n private Sensor pressure;\n\n @Override\n public final void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(R.layout.main);\n\n // Get an instance of the sensor service, and use that to get an instance of\n // a particular sensor.\n sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);\n pressure = sensorManager.getDefaultSensor(Sensor.TYPE_PRESSURE);\n }\n\n @Override\n public final void onAccuracyChanged(Sensor sensor, int accuracy) {\n // Do something here if sensor accuracy changes.\n }\n\n @Override\n public final void onSensorChanged(SensorEvent event) {\n float millibarsOfPressure = event.values[0];\n // Do something with this sensor data.\n }\n\n @Override\n protected void onResume() {\n // Register a listener for the sensor.\n super.onResume();\n sensorManager.registerListener(this, pressure, SensorManager.SENSOR_DELAY_NORMAL);\n }\n\n @Override\n protected void onPause() {\n // Be sure to unregister the sensor when the activity pauses.\n super.onPause();\n sensorManager.unregisterListener(this);\n }\n}\n```\n\nYou must always include implementations of both the [onAccuracyChanged()](/reference/android/hardware/SensorEventListener#onAccuracyChanged(android.hardware.Sensor, int)) and [onSensorChanged()](/reference/android/hardware/SensorEventListener#onSensorChanged(android.hardware.SensorEvent)) callback methods. Also, be\nsure that you always unregister a sensor when an activity pauses. This prevents a sensor from\ncontinually sensing data and draining the battery.\n\nUse the humidity sensor\n-----------------------\n\nYou can acquire raw relative humidity data by using the humidity sensor the same way that you use\nthe light, pressure, and temperature sensors. However, if a device has both a humidity sensor\n([TYPE_RELATIVE_HUMIDITY](/reference/android/hardware/Sensor#TYPE_RELATIVE_HUMIDITY)) and a temperature sensor ([TYPE_AMBIENT_TEMPERATURE](/reference/android/hardware/Sensor#TYPE_AMBIENT_TEMPERATURE)) you can use these two data streams to calculate\nthe dew point and the absolute humidity.\n\n#### Dew point\n\nThe dew point is the temperature at which a given volume of air must be cooled, at constant\nbarometric pressure, for water vapor to condense into water. The following equation shows how you\ncan calculate the dew point:\n\nWhere,\n\n- t~d~ = dew point temperature in degrees C\n- t = actual temperature in degrees C\n- RH = actual relative humidity in percent (%)\n- m = 17.62\n- T~n~ = 243.12\n\n#### Absolute humidity\n\nThe absolute humidity is the mass of water vapor in a given volume of dry air. Absolute\nhumidity is measured in grams/meter^3^. The following equation shows how you\ncan calculate the absolute humidity:\n\nWhere,\n\n- d~v~ = absolute humidity in grams/meter^3^\n- t = actual temperature in degrees C\n- RH = actual relative humidity in percent (%)\n- m = 17.62\n- T~n~ = 243.12 degrees C\n- A = 6.112 hPa\n\n### You should also read\n\n- [Sensors](/guide/topics/sensors)\n- [Sensors Overview](/guide/topics/sensors/sensors_overview)\n- [Position Sensors](/guide/topics/sensors/sensors_position)\n- [Motion Sensors](/guide/topics/sensors/sensors_motion)"]]