Added in [API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/hardware/TriggerEventListener#pubctors) \| [Methods](https://developer.android.com/reference/android/hardware/TriggerEventListener#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/hardware/TriggerEventListener#inhmethods)

# TriggerEventListener

*** ** * ** ***

` public abstract class TriggerEventListener `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.hardware.TriggerEventListener |

<br />

*** ** * ** ***

This class is the listener used to handle Trigger Sensors. Trigger Sensors are sensors that trigger an event and are automatically disabled. `https://developer.android.com/reference/android/hardware/Sensor#TYPE_SIGNIFICANT_MOTION` is one such example.

`https://developer.android.com/reference/android/hardware/SensorManager` lets you access the device's `https://developer.android.com/reference/android/hardware/Sensor`. Get an instance of `https://developer.android.com/reference/android/hardware/SensorManager` by calling `https://developer.android.com/reference/android/content/Context#getSystemService(java.lang.String)` with the argument `https://developer.android.com/reference/android/content/Context#SENSOR_SERVICE`.

Here's an example setup for a TriggerEventListener:

```
class TriggerListener extends TriggerEventListener {
    public void onTrigger(TriggerEvent event) {
         // Do Work.

    // As it is a one shot sensor, it will be canceled automatically.
    // SensorManager.requestTriggerSensor(this, mSigMotion); needs to
    // be called again, if needed.
    }
}
public class SensorActivity extends Activity {
    private final SensorManager mSensorManager;
    private final Sensor mSigMotion;
    private final TriggerEventListener mListener = new TriggerEventListener();

    public SensorActivity() {
        mSensorManager = (SensorManager)getSystemService(SENSOR_SERVICE);
        mSigMotion = mSensorManager.getDefaultSensor(Sensor.TYPE_SIGNIFICANT_MOTION);
    }

    protected void onResume() {
        super.onResume();
        mSensorManager.requestTriggerSensor(mListener, mSigMotion);
    }

    protected void onPause() {
        super.onPause();
        // Call disable to ensure that the trigger request has been canceled.
        mSensorManager.cancelTriggerSensor(mListener, mSigMotion);
    }

}
```

<br />

**See also:**

- `https://developer.android.com/reference/android/hardware/TriggerEvent`
- `https://developer.android.com/reference/android/hardware/Sensor`

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/hardware/TriggerEventListener#TriggerEventListener()() ` |

| ### Public methods ||
|---|---|
| ` abstract void` | ` https://developer.android.com/reference/android/hardware/TriggerEventListener#onTrigger(android.hardware.TriggerEvent)(https://developer.android.com/reference/android/hardware/TriggerEvent event) ` The method that will be called when the sensor is triggered. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Public constructors

### TriggerEventListener

```
public TriggerEventListener ()
```

<br />

<br />

## Public methods

### onTrigger

Added in [API level 18](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public abstract void onTrigger (TriggerEvent event)
```

The method that will be called when the sensor is triggered. Override this method in your implementation of this class.

<br />

| Parameters ||
|---|---|
| `event` | `TriggerEvent`: The details of the event. <br /> |