Controller Detector

Detect and recognize input controllers (HID) and receive feedback based on connectivity changes.

Installation

You can easily install this module using JCenter or Maven, by adding the following dependency to your build.gradle file:

dependencies {
 compile 'com.aptoide.pt:controller-detector:1.0.0'
 //...
}

Usage

Apart from this section, a complete example can be downloaded from this repo.

You need to create a InputDeviceConnector object and implement ControllerListener interface. For InputDeviceConnector you also need to:

• Implement startDetectingDevices() to start detecting controllers (e.g. onCreate).
• Implement stopDetectingDevices() to stop detecting controllers (e.g. onDestroy).

public class MainActivity extends AppCompatActivity implements ControllerListener {
    private InputDeviceConnector connector;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // ...
        connector = new InputDeviceConnector(getApplicationContext(), this);
        connector.startDetectingDevices();
        // ...
    }

    @Override
    protected void onDestroy(){
        super.onDestroy();
        // ...
        connector.stopDetectingDevices();
        // ...
    }
    
    @Override
    public void onControllerChange(DeviceController controller) {
        // ...
    }

    @Override
    public void onControllerConnect(DeviceController controller) {
        // ...
    }

    @Override
    public void onControllerDisconnect(int id) {
        // ...
    }
}

Notice onControllerDisconnect only an id is passed since the Device has been disconnected. This is the same id that you retrieve from DeviceController.getDevice().getId().

DeviceController

DeviceController defines two useful attributes that you can retrieve: an InputDevice and a DeviceInputType (enum).

For InputDevice you can read further here.

For DeviceInputType, it defines the following values: DPAD, GAMEPAD, KEYBOARD, MOUSE, STYLUS, TOUCHPAD, TOUCHSCREEN, TRACKBALL, TVREMOTE, UNRECOGNIZED

Tested Devices

An analysis of several devices was made in order to check the correctness of the recognition algorithm. This analysis and the list of confirmed supported devices is here.