mathieu/bixi-android

Android library interacting with Bixi bluetooth device

Bixi Android library

Bixi library is an Android service receiving gesture events from Bixi Bluetooth devices

Download Bixi library Showcase from Google Play :

What is Bixi ?

Bixi is a small bluetooth touch-free controller with built in battery made by Bluemint Labs

Gestures

List of gesture events :

• CENTER_TO_TOP
• CENTER_TO_BOTTOM
• CENTER_TO_LEFT
• CENTER_TO_RIGHT
• LINEAR_END
• LINEAR_CHANGE (the specific value is given)
• DOUBLE_TAP

How to include it in your Android project ?

with Gradle, from jcenter or maven central :

compile 'fr.bmartel:bixi-service:1.1'

How to use it ?

Use BixiClient service wrapper :

• Kotlin example :

class MainActivity : Activity() {

    private lateinit var bixiClient: BixiClient

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        bixiClient = BixiClient(this, object : IBixiListener {
            override fun onServiceConnected() {
                Log.v("bixi-lib", "service is connected - ready to receive events")

                //start scanning
                bixiClient.startScan()
            }

            override fun onStartScan() {
                Log.v("bixi-lib", "scan started")
            }

            override fun onEndScan() {
                Log.v("bixi-lib", "scan stopped")
            }

            override fun onDeviceDiscovered(device: BtDevice) {
                Log.v("bixi-lib", "new Bixi device discovered : " + device.deviceName)

                //stop scanning
                bixiClient.stopScan()

                //connect to this device
                bixiClient.connectDevice(device.deviceAddress)
            }

            override fun onDeviceDisconnected(device: BtDevice) {
                Log.v("bixi-lib", "device disconnected : " + device.deviceName)
            }

            override fun onDeviceConnected(device: BtDevice) {
                Log.v("bixi-lib", "device connected : " + device.deviceName)

                //set a listener to be notified when a gesture event occur
                bixiClient.getDevice(device)!!.setBixiGestureListener(object : IGestureListener {
                    override fun onGestureChange(event: BixiEvent) {
                        Log.v("bixi-lib", "received gesture event : " + event.gesture)
                    }
                })
            }

            override fun onBluetoothOff() {
                Log.v("bixi-lib", "bluetooth hasn't been activated (user refused the popup)")
            }

            override fun onPermissionDenied() {
                Log.v("bixi-lib", "location permission was denied (necessary to scan)")
            }
        })
        bixiClient.init(this)
    }

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        bixiClient.onRequestPermissionsResult(requestCode, grantResults)
    }
}

• Java example :

public class MainActivity extends Activity {

    BixiClient bixiClient;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        bixiClient = new BixiClient(this, new IBixiListener() {
            @Override
            public void onServiceConnected() {
                Log.v("bixi-lib", "service is connected - ready to receive events");

                //start scanning
                bixiClient.startScan();
            }

            @Override
            public void onStartScan() {
                Log.v("bixi-lib", "scan started");
            }

            @Override
            public void onEndScan() {
                Log.v("bixi-lib", "scan stopped");
            }

            @Override
            public void onDeviceDiscovered(BtDevice device) {
                Log.v("bixi-lib", "new Bixi device discovered : " + device.getDeviceName());

                //stop scanning
                bixiClient.stopScan();

                //connect to this device
                bixiClient.connectDevice(device.getDeviceAddress());
            }

            @Override
            public void onDeviceDisconnected(BtDevice device) {
                Log.v("bixi-lib", "device disconnected : " + device.getDeviceName());
            }

            @Override
            public void onDeviceConnected(BtDevice device) {
                Log.v("bixi-lib", "device connected : " + device.getDeviceName());

                //set a listener to be notified when a gesture event occur
                bixiClient.getDevice(device).setBixiGestureListener(new IGestureListener() {
                    @Override
                    public void onGestureChange(BixiEvent event) {
                        Log.v("bixi-lib", "received gesture event : " + event.getGesture());
                    }
                });
            }

            @Override
            public void onBluetoothOff() {
                Log.v("bixi-lib", "bluetooth hasn't been activated (user refused the popup)");
            }

            @Override
            public void onPermissionDenied() {
                Log.v("bixi-lib", "location permission was denied (necessary to scan)");
            }
        });
        bixiClient.init(this);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        bixiClient.onRequestPermissionsResult(requestCode, grantResults);
    }
}

In the app module, you can find an example using a Singleton

Requirements

This project require Android SDK 19+

Build Library

Get source code

git clone [email protected]:bertrandmartel/bixi-android.git
cd bixi-android

Build

./gradlew build

About

• Hexagon Icon by Ayse Muskara from the Noun Project, https://thenounproject.com/term/hexagon/318525/
• appcompat-v7, design & recyclerview-v7
• source of Bixi image (on the drawer header) : http://gadgetsin.com/bixi-remote-control-lets-you-control-smart-devices-with-gestures.htm

License

The MIT License (MIT) Copyright (c) 2017-2018 Bertrand Martel