---
title: Motion Recognizer
description: "## WHAT'S THIS? Motion recognizer is a component that recognizes device movements. It is still in the experimental stage, and many improvements are still required. ## HOW TO ENABLE MOTION RECOGNIZER? Go to Project Settings > Plugins > Touch Interface…"
url: "https://www.lostingamestudio.com/documentation/touch-interface-designer/recognizer/motion-recognizer/"
updated: "2025-12-18"
category: Recognizer
---

# Motion Recognizer

## WHAT'S THIS?

Motion recognizer is a component that recognizes device movements. It is still in the experimental stage, and many improvements are still required.

## HOW TO ENABLE MOTION RECOGNIZER?

Go to Project Settings > Plugins > Touch Interface and in the Motion Recognizer category, check the Enable Motion Recognizer setting. Then you just need to add the Motion Recognizer component on a class where you want to bind a function to a device motion.

## MOTION RECOGNIZER COMPONENT SETTINGS

**Input**

- **Auto Receive Input** : Automatically registers this actor to receive input from a player (Gyroscope data).

**Quick Acceleration**

Detects rapid movement of the device. A simple tab can be enough to trigger the event.

- **Quick Acceleration Threshold** : Min acceleration value needed to trigger Quick Acceleration event.
- **Delay Between Quick Acc Detection** : Delay between quick acceleration detection. Avoids multiple detections in one direction.

**Shake**

Detects when the device is shaken by the user.

- **Shake Detection Threshold** : Min acceleration value needed to trigger shake event.
- **Shake Allowed Time** : Shake detection time. e.g. If acceleration to the right is detected, acceleration to the left must be detected within the allotted time.
- **Call Shake Each Frame** : If enabled, when shaking is detected, On Shaking event is called each frame. If disabled, On Shaking is only called when quick acceleration is detected.

**Motion Based Rotation**

Use device movements to control the camera.

- **Turn Rate** : Rotation speed.
- **Invert Axis** : Invert axis.
- **Limit Rotation** : Whether or not camera rotation should be limited.
- **Max Amplitude** : Max angle for rotation limiter.

## HOW TO GET DEVICE MOTION EVENTS?

In the events part of the component, you just have to click on the event you want to retrieve. You can bind/unbind a function too if you want.

## WHAT DEVICE MOTION EVENTS ARE RECOGNIZED?

The current algorithm in v2024.1 is able to recognize the following device motion :

- **On Quick Acceleration** : Called when quick acceleration is detected.
- **On Shake Start** : Called when shake is detected.
- **On Shaking** : Called every time the direction changes. Can be called each tick.
- **On Shake End** : Called when shake is ended.
- **On Motion Based Rotation** : Control camera view with gyroscope. X=Roll, Y=Pitch, Z=Yaw