पोज़िशन सेंसर

Android प्लैटफ़ॉर्म, डिवाइस की पोज़िशन का पता लगाने के लिए दो सेंसर उपलब्ध कराता है: जियोमैग्नेटिक फ़ील्ड सेंसर और एक्सलरोमीटर. Android प्लैटफ़ॉर्म, एक ऐसा सेंसर भी उपलब्ध कराता है जिससे यह पता लगाया जा सकता है कि किसी डिवाइस का डिसप्ले, किसी ऑब्जेक्ट से कितना दूर है. इसे प्रॉक्सिमिटी सेंसर कहा जाता है. जियोमैग्नेटिक फ़ील्ड सेंसर और प्रॉक्सिमिटी सेंसर, हार्डवेयर पर आधारित होते हैं. हैंडसेट और टैबलेट बनाने वाली ज़्यादातर कंपनियां, जियोमैग्नेटिक फ़ील्ड सेंसर शामिल करती हैं. इसी तरह, हैंडसेट बनाने वाली कंपनियां आम तौर पर प्रॉक्सिमिटी सेंसर शामिल करती हैं. इससे यह पता चलता है कि हैंडसेट को किसी व्यक्ति के चेहरे के करीब कब रखा जा रहा है. उदाहरण के लिए, फ़ोन कॉल के दौरान. किसी डिवाइस के ओरिएंटेशन का पता लगाने के लिए, डिवाइस के एक्सलरोमीटर और जियोमैग्नेटिक फ़ील्ड सेंसर से मिली रीडिंग का इस्तेमाल किया जा सकता है.

ध्यान दें: ओरिएंटेशन सेंसर को Android 2.2 (एपीआई लेवल 8) में बंद कर दिया गया था. साथ ही, ओरिएंटेशन सेंसर टाइप को Android 4.4W (एपीआई लेवल 20) में बंद कर दिया गया था.

पोजीशन सेंसर, डिवाइस की जगह की जानकारी का पता लगाने में मदद करते हैं. उदाहरण के लिए, जियोमैग्नेटिक फ़ील्ड सेंसर को एक्सलरोमीटर के साथ इस्तेमाल करके, किसी डिवाइस की स्थिति का पता लगाया जा सकता है. इससे यह पता चलता है कि डिवाइस, मैग्नेटिक नॉर्थ पोल के किस हिस्से में या कितनी दूर है. इन सेंसर का इस्तेमाल, आपके ऐप्लिकेशन के फ़्रेम ऑफ़ रेफ़रंस में डिवाइस के ओरिएंटेशन का पता लगाने के लिए भी किया जा सकता है. आम तौर पर, डिवाइस की हलचल या मोशन को मॉनिटर करने के लिए, पोज़िशन सेंसर का इस्तेमाल नहीं किया जाता. जैसे, हिलाना, झुकाना या थ्रस्ट करना (ज़्यादा जानकारी के लिए, मोशन सेंसर देखें).

जियोमैग्नेटिक फ़ील्ड सेंसर और ऐक्सिलरोमीटर, हर SensorEvent के लिए सेंसर वैल्यू के मल्टी-डाइमेंशनल ऐरे दिखाते हैं. उदाहरण के लिए, जियोमैग्नेटिक फ़ील्ड सेंसर, सेंसर के एक इवेंट के दौरान तीनों कोऑर्डिनेट ऐक्सिस के लिए जियोमैग्नेटिक फ़ील्ड की ताकत की वैल्यू देता है. इसी तरह, एक्सलरोमीटर सेंसर, सेंसर इवेंट के दौरान डिवाइस पर लागू होने वाले ऐक्सलरेशन को मेज़र करता है. सेंसर के इस्तेमाल किए गए कोऑर्डिनेट सिस्टम के बारे में ज़्यादा जानकारी के लिए, सेंसर कोऑर्डिनेट सिस्टम देखें. प्रॉक्सिमिटी सेंसर, हर सेंसर इवेंट के लिए एक वैल्यू देता है. पहली टेबल में, Android प्लैटफ़ॉर्म पर काम करने वाले पोज़िशन सेंसर के बारे में खास जानकारी दी गई है.

पहली टेबल. Android प्लैटफ़ॉर्म पर काम करने वाले पोज़िशन सेंसर.

सेंसर सेंसर इवेंट का डेटा ब्यौरा मेज़रमेंट की इकाइयां
TYPE_GAME_ROTATION_VECTOR SensorEvent.values[0] x-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (x * sin(θ/2)). बिना इकाई वाला
SensorEvent.values[1] y-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (y * sin(θ/2)).
SensorEvent.values[2] z-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (z * sin(θ/2)).
TYPE_GEOMAGNETIC_ROTATION_VECTOR SensorEvent.values[0] x-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (x * sin(θ/2)). बिना इकाई वाला
SensorEvent.values[1] y-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (y * sin(θ/2)).
SensorEvent.values[2] z-ऐक्सिस के साथ रोटेशन वेक्टर कॉम्पोनेंट (z * sin(θ/2)).
TYPE_MAGNETIC_FIELD SensorEvent.values[0] x-ऐक्सिस के साथ जियोमैग्नेटिक फ़ील्ड की इंटेंसिटी. μT
SensorEvent.values[1] y-ऐक्सिस के हिसाब से जियोमैग्नेटिक फ़ील्ड की इंटेंसिटी.
SensorEvent.values[2] z ऐक्सिस के साथ जियोमैग्नेटिक फ़ील्ड की इंटेंसिटी.
TYPE_MAGNETIC_FIELD_UNCALIBRATED SensorEvent.values[0] एक्सिस के हिसाब से, पृथ्वी के चुंबकीय क्षेत्र की ताकत. इसमें हार्ड आयरन कैलिब्रेशन शामिल नहीं है. μT
SensorEvent.values[1] y ऐक्सिस के हिसाब से, पृथ्वी के चुंबकीय क्षेत्र की ताकत (हार्ड आयरन कैलिब्रेशन के बिना).
SensorEvent.values[2] ज़ेड ऐक्सिस के हिसाब से, पृथ्वी के चुंबकीय क्षेत्र की तीव्रता. इसमें हार्ड आयरन कैलिब्रेशन शामिल नहीं है.
SensorEvent.values[3] x-ऐक्सिस के हिसाब से आयरन बायस का अनुमान.
SensorEvent.values[4] y-ऐक्सिस के हिसाब से आयरन बायस का अनुमान.
SensorEvent.values[5] ज़ेड ऐक्सिस के साथ आयरन बायस का अनुमान.
TYPE_ORIENTATION1 SensorEvent.values[0] अज़ीमुथ (z-ऐक्सिस के चारों ओर का कोण). डिग्री
SensorEvent.values[1] पिच (x-ऐक्सिस के चारों ओर का कोण).
SensorEvent.values[2] रोल (y-ऐक्सिस के आस-पास का कोण).
TYPE_PROXIMITY SensorEvent.values[0] ऑब्जेक्ट से दूरी.2 सें॰मी॰

1इस सेंसर को Android 2.2 (एपीआई लेवल 8) में बंद कर दिया गया था. साथ ही, इस सेंसर टाइप को Android 4.4W (एपीआई लेवल 20) में बंद कर दिया गया था. सेंसर फ़्रेमवर्क, डिवाइस के ओरिएंटेशन की जानकारी पाने के लिए अन्य तरीके उपलब्ध कराता है. इनके बारे में डिवाइस के ओरिएंटेशन का हिसाब लगाना लेख में बताया गया है.

2 कुछ प्रॉक्सिमिटी सेंसर सिर्फ़ बाइनरी वैल्यू देते हैं. ये वैल्यू, ऑब्जेक्ट के पास और दूर होने की जानकारी देती हैं.

गेम रोटेशन वेक्टर सेंसर का इस्तेमाल करना

गेम रोटेशन वेक्टर सेंसर, रोटेशन वेक्टर सेंसर की तरह ही होता है. हालांकि, यह जियोमैग्नेटिक फ़ील्ड का इस्तेमाल नहीं करता है. इसलिए, Y ऐक्सिस उत्तर की ओर नहीं, बल्कि किसी अन्य दिशा में होता है. इस रेफ़रंस को, Z ऐक्सिस के आस-पास जायरोस्कोप के घूमने के बराबर घूमने की अनुमति है.

गेम रोटेशन वेक्टर सेंसर, मैग्नेटिक फ़ील्ड का इस्तेमाल नहीं करता. इसलिए, रिलेटिव रोटेशन ज़्यादा सटीक होते हैं और मैग्नेटिक फ़ील्ड में होने वाले बदलावों से इन पर कोई असर नहीं पड़ता. अगर आपको इस बात से कोई फ़र्क़ नहीं पड़ता कि उत्तर दिशा कहां है और मैग्नेटिक फ़ील्ड पर निर्भर होने की वजह से, सामान्य रोटेशन वेक्टर आपकी ज़रूरतों के मुताबिक नहीं है, तो गेम में इस सेंसर का इस्तेमाल करें.

यहां दिए गए कोड से, आपको डिफ़ॉल्ट गेम रोटेशन वेक्टर सेंसर का इंस्टेंस पाने का तरीका पता चलेगा:

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);

जियोमैग्नेटिक रोटेशन वेक्टर सेंसर का इस्तेमाल करना

जियोमैग्नेटिक रोटेशन वेक्टर सेंसर, रोटेशन वेक्टर सेंसर की तरह ही होता है. हालांकि, इसमें जाइरोस्कोप का इस्तेमाल नहीं किया जाता. इस सेंसर की सटीकता, सामान्य रोटेशन वेक्टर सेंसर से कम होती है. हालांकि, इससे बैटरी की खपत कम होती है. इस सेंसर का इस्तेमाल सिर्फ़ तब करें, जब आपको बैकग्राउंड में रोटेशन की जानकारी इकट्ठा करनी हो और बैटरी का इस्तेमाल कम करना हो. इस सेंसर का सबसे ज़्यादा फ़ायदा तब मिलता है, जब इसका इस्तेमाल बैचिंग के साथ किया जाता है.

यहां दिए गए कोड से, आपको डिफ़ॉल्ट जियोमैग्नेटिक रोटेशन वेक्टर सेंसर का इंस्टेंस पाने का तरीका पता चलेगा:

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);

डिवाइस के ओरिएंटेशन का पता लगाना

डिवाइस की ओरिएंटेशन का हिसाब लगाकर, पृथ्वी के फ़्रेम ऑफ़ रेफ़रंस (खास तौर पर, मैग्नेटिक नॉर्थ पोल) के हिसाब से डिवाइस की पोज़िशन को मॉनिटर किया जा सकता है. यहां दिए गए कोड से, आपको किसी डिवाइस के ओरिएंटेशन का पता लगाने का तरीका पता चलेगा:

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);

सिस्टम, डिवाइस के जियोमैग्नेटिक फ़ील्ड सेंसर और डिवाइस के ऐक्सिलरोमीटर का इस्तेमाल करके, ओरिएंटेशन ऐंगल का हिसाब लगाता है. इन दो हार्डवेयर सेंसर का इस्तेमाल करके, सिस्टम इन तीन ओरिएंटेशन ऐंगल के लिए डेटा उपलब्ध कराता है:

  • ऐज़िमुथ (z-ऐक्सिस के चारों ओर घूमने के डिग्री). यह डिवाइस के कंपास की मौजूदा दिशा और मैग्नेटिक नॉर्थ के बीच का ऐंगल है. अगर डिवाइस का ऊपरी किनारा मैग्नेटिक नॉर्थ की ओर है, तो ऐज़िमुथ 0 डिग्री होता है. अगर ऊपरी किनारा दक्षिण की ओर है, तो ऐज़िमुथ 180 डिग्री होता है. इसी तरह, अगर ऊपरी किनारा पूरब की ओर है, तो ऐज़िमुथ 90 डिग्री है. अगर ऊपरी किनारा पश्चिम की ओर है, तो ऐज़िमुथ 270 डिग्री है.
  • पिच (x ऐक्सिस के चारों ओर घूमने की डिग्री). यह डिवाइस की स्क्रीन के समानांतर प्लेन और ज़मीन के समानांतर प्लेन के बीच का ऐंगल होता है. अगर डिवाइस को ज़मीन के समानांतर इस तरह से पकड़ा जाता है कि उसका निचला किनारा आपके सबसे करीब हो और डिवाइस के ऊपरी किनारे को ज़मीन की ओर झुकाया जाता है, तो पिच ऐंगल पॉज़िटिव हो जाता है. डिवाइस को उल्टी दिशा में झुकाने पर, डिवाइस का ऊपरी किनारा ज़मीन से दूर चला जाता है. इससे पिच ऐंगल नेगेटिव हो जाता है. वैल्यू की रेंज -90 डिग्री से 90 डिग्री तक होती है.
  • रोल (y ऐक्सिस के चारों ओर घुमाव के डिग्री). यह डिवाइस की स्क्रीन से परपंडिकुलर प्लेन और ज़मीन से परपंडिकुलर प्लेन के बीच का ऐंगल होता है. अगर डिवाइस को ज़मीन के समानांतर रखा जाता है, तो डिवाइस का निचला किनारा आपके सबसे करीब होता है. साथ ही, डिवाइस के बाएँ किनारे को ज़मीन की ओर झुकाने पर, रोल ऐंगल पॉज़िटिव हो जाता है. डिवाइस को दूसरी दिशा में झुकाने पर, रोल ऐंगल नेगेटिव हो जाता है. ऐसा तब होता है, जब डिवाइस के दाईं ओर के किनारे को ज़मीन की ओर ले जाया जाता है. वैल्यू की रेंज -180 डिग्री से 180 डिग्री तक होती है.

ध्यान दें:सेंसर के रोल की परिभाषा में बदलाव किया गया है, ताकि यह जियोसेंसर के इकोसिस्टम में ज़्यादातर लागू होने वाले बदलावों को दिखा सके.

ध्यान दें कि ये ऐंगल, विमानन में इस्तेमाल किए जाने वाले कोऑर्डिनेट सिस्टम (यॉ, पिच, और रोल के लिए) से अलग कोऑर्डिनेट सिस्टम पर काम करते हैं. विमानन प्रणाली में, x ऐक्सिस विमान की लंबी साइड के साथ होता है. यह पूंछ से लेकर नाक तक होता है.

ओरिएंटेशन सेंसर, ऐक्सिलरोमीटर और जियोमैग्नेटिक फ़ील्ड सेंसर से मिले रॉ सेंसर डेटा को प्रोसेस करके अपना डेटा जनरेट करता है. प्रोसेसिंग में ज़्यादा समय लगने की वजह से, ओरिएंटेशन सेंसर की सटीकता और सटीक होने की क्षमता कम हो जाती है. खास तौर पर, यह सेंसर सिर्फ़ तब भरोसेमंद होता है, जब रोल ऐंगल 0 हो. इस वजह से, Android 2.2 (एपीआई लेवल 8) में ओरिएंटेशन सेंसर को बंद कर दिया गया था. साथ ही, Android 4.4W (एपीआई लेवल 20) में ओरिएंटेशन सेंसर टाइप को बंद कर दिया गया था. हमारा सुझाव है कि ओरिएंटेशन सेंसर से मिले रॉ डेटा का इस्तेमाल करने के बजाय, ओरिएंटेशन वैल्यू का हिसाब लगाने के लिए, getRotationMatrix() तरीके के साथ-साथ getOrientation() तरीके का इस्तेमाल करें. इसके बारे में यहां दिए गए कोड सैंपल में बताया गया है. इस प्रोसेस के तहत, remapCoordinateSystem() तरीके का इस्तेमाल करके, ओरिएंटेशन वैल्यू को अपने ऐप्लिकेशन के फ़्रेम ऑफ़ रेफ़रंस में बदला जा सकता है.

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.
    }
}

आम तौर पर, आपको डिवाइस के ओरिएंटेशन के रॉ ऐंगल के डेटा को प्रोसेस या फ़िल्टर करने की ज़रूरत नहीं होती. हालांकि, आपको सेंसर के कोऑर्डिनेट सिस्टम को अपने ऐप्लिकेशन के फ़्रेम ऑफ़ रेफ़रंस में बदलना पड़ सकता है.

जियोमैग्नेटिक फ़ील्ड सेंसर का इस्तेमाल करना

जियोमैग्नेटिक फ़ील्ड सेंसर की मदद से, पृथ्वी के चुंबकीय क्षेत्र में होने वाले बदलावों पर नज़र रखी जा सकती है. नीचे दिए गए कोड से, आपको डिफ़ॉल्ट जियोमैग्नेटिक फ़ील्ड सेंसर का इंस्टेंस पाने का तरीका पता चलेगा:

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);

ध्यान दें: अगर आपका ऐप्लिकेशन, Android 12 (एपीआई लेवल 31) या इसके बाद के वर्शन को टारगेट करता है, तो इस सेंसर के लिए रेट लिमिट लागू होती है.

यह सेंसर, तीनों कोऑर्डिनेट ऐक्सिस के लिए फ़ील्ड की ताकत का रॉ डेटा (μT में) उपलब्ध कराता है. आम तौर पर, आपको इस सेंसर का सीधे तौर पर इस्तेमाल करने की ज़रूरत नहीं होती. इसके बजाय, रोटेशन वेक्टर सेंसर का इस्तेमाल करके, रोटेशनल मूवमेंट का पता लगाया जा सकता है. इसके अलावा, एक्सलरोमीटर और जियोमैग्नेटिक फ़ील्ड सेंसर को getRotationMatrix() तरीके के साथ इस्तेमाल करके, रोटेशन मैट्रिक्स और झुकाव मैट्रिक्स का पता लगाया जा सकता है. इसके बाद, इन मैट्रिक्स का इस्तेमाल getOrientation() और getInclination() तरीकों के साथ किया जा सकता है, ताकि ऐज़िमुथ और जियोमैग्नेटिक झुकाव का डेटा हासिल किया जा सके.

ध्यान दें: अपने ऐप्लिकेशन की टेस्टिंग करते समय, डिवाइस को आठ के आकार में घुमाकर सेंसर की सटीकता को बेहतर बनाया जा सकता है.

कैलिब्रेट न किए गए मैग्नेटोमीटर का इस्तेमाल करना

कैलिब्रेट नहीं किया गया मैग्नेटोमीटर, जियोमैग्नेटिक फ़ील्ड सेंसर की तरह ही होता है. हालांकि, मैग्नेटिक फ़ील्ड पर हार्ड आयरन कैलिब्रेशन लागू नहीं होता है. मैग्नेटिक फ़ील्ड पर, फ़ैक्ट्री कैलिब्रेशन और तापमान के असर को कम करने की सुविधा अब भी लागू होती है. अनकैलिब्रेटेड मैग्नेटोमीटर, हार्ड आयरन के खराब अनुमानों को ठीक करने में मदद करता है. आम तौर पर, geomagneticsensor_event.values[0], uncalibrated_magnetometer_event.values[0] - uncalibrated_magnetometer_event.values[3] के आस-पास होगा. इसका मतलब है कि

calibrated_x ~= uncalibrated_x - bias_estimate_x

ध्यान दें: कैलिब्रेट न किए गए सेंसर से ज़्यादा रॉ डेटा मिलता है. साथ ही, इसमें कुछ पूर्वाग्रह शामिल हो सकते हैं. हालांकि, कैलिब्रेशन के ज़रिए किए गए सुधारों की वजह से, इनके मेज़रमेंट में कम अंतर होता है. कुछ ऐप्लिकेशन, बिना कैलिब्रेट किए गए इन नतीजों को ज़्यादा सटीक और भरोसेमंद मान सकते हैं. उदाहरण के लिए, अगर कोई ऐप्लिकेशन अपने सेंसर फ़्यूज़न को लागू करने की कोशिश कर रहा है, तो कैलिब्रेशन लागू करने से नतीजे खराब हो सकते हैं.

मैग्नेटिक फ़ील्ड के अलावा, बिना कैलिब्रेट किया गया मैग्नेटोमीटर, हर ऐक्सिस में हार्ड आयरन बायस का अनुमान भी देता है. यहां दिए गए कोड से, आपको डिफ़ॉल्ट रूप से बिना कैलिब्रेट किए गए मैग्नेटोमीटर का इंस्टेंस पाने का तरीका पता चलेगा:

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);

प्रॉक्सिमिटी सेंसर का इस्तेमाल करना

प्रॉक्सिमिटी सेंसर से यह पता लगाया जा सकता है कि कोई ऑब्जेक्ट, डिवाइस से कितनी दूर है. यहां दिए गए कोड से, आपको डिफ़ॉल्ट प्रॉक्सिमिटी सेंसर का इंस्टेंस पाने का तरीका पता चलेगा:

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);

आम तौर पर, प्रॉक्सिमिटी सेंसर का इस्तेमाल यह पता लगाने के लिए किया जाता है कि किसी व्यक्ति का सिर, हैंडसेट डिवाइस के सामने से कितनी दूर है. उदाहरण के लिए, जब कोई व्यक्ति फ़ोन कॉल कर रहा हो या उसे कॉल आ रहा हो. ज़्यादातर प्रॉक्सिमिटी सेंसर, सेंटीमीटर में दूरी की सटीक जानकारी देते हैं. हालांकि, कुछ सेंसर सिर्फ़ पास और दूर की वैल्यू देते हैं.

ध्यान दें: कुछ डिवाइस मॉडल में, प्रॉक्सिमिटी सेंसर स्क्रीन के नीचे होता है. अगर स्क्रीन चालू होने के दौरान यह सेंसर चालू होता है, तो स्क्रीन पर एक बिंदु चमकता हुआ दिख सकता है.

नीचे दिए गए कोड में, आस-पास की पहचान करने वाले सेंसर का इस्तेमाल करने का तरीका बताया गया है:

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);
    }
}

ध्यान दें: कुछ प्रॉक्सिमिटी सेंसर, बाइनरी वैल्यू दिखाते हैं. ये वैल्यू "पास" या "दूर" को दिखाती हैं. इस मामले में, सेंसर आम तौर पर दूर की स्थिति में अपनी ज़्यादा से ज़्यादा रेंज की वैल्यू और पास की स्थिति में कम वैल्यू रिपोर्ट करता है. आम तौर पर, फ़ार वैल्यू 5 सेमी से ज़्यादा होती है. हालांकि, यह सेंसर के हिसाब से अलग-अलग हो सकती है. getMaximumRange() तरीके का इस्तेमाल करके, किसी सेंसर की ज़्यादा से ज़्यादा रेंज का पता लगाया जा सकता है.

आपको यह भी पढ़ना चाहिए