FirstMaBeeeAndroid

概要

• 簡単にMaBeeeAndroidSDKを使ってみることを目的としたサンプルプロジェクトです。
• ここではこのサンプルプロジェクトを最初からつくる手順をご紹介します。

ライブラリのインポート

AndroidStudioでappモジュールのbuild.gradle(Module: app)に以下を追加します。

// GithubPackagesを追加
repositories {
    maven {
        url 'https://maven.pkg.github.com/novars-jp/MaBeeeAndroidSDK'
    }
}

dependencies {
    implementation 'jp.novars.mabeee.sdk:sdk:1.5.1'
    implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.1.0'
}

ソースの編集

1. activity_main.xmlのレイアウト編集

接続開始用Scanボタン1つと、出力調整用SeekBarをもつ画面を作ります。

• activity_main.xml

2. ライブラリの初期化

• MainActivity.javaのonCreateに以下のソース追加します。

App.getInstance().initializeApp(getApplicationContext());

• AppクラスはこのSDKの中心となるクラスです。 Android端末のBluetoothや接続済みのMaBeeeデバイスを管理します。
• App.getInstance()でAppクラスのSingletonインスタンスを取得します。
• AppクラスのinitializeApp(Context context)関数で、Appクラス、ライブラリの初期化を行ないます。
• これは一般的にはApplicationクラスで最初に呼び出すか、複数回呼び出しても問題ないので、最初のActivityのonCreateなどで呼び出してください。

3. Scanボタンのイベント編集

• ScanボタンにOnClickListenerを設定し、ScanAcitivtyを呼び出す処理を追加します。

Button scanButton = (Button)findViewById(R.id.scanButton);
scanButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
       Intent intent = new Intent(MainActivity.this, ScanActivity.class);
       startActivity(intent);
    }
 });

• ScanActivityを使うとMaBeeeデバイスのスキャンと接続を簡単に実装できることができます。

4. SeekBarのイベント編集

• SeekBarにOnSeeekBarChangeListenerを設定し、MaBeeeデバイスの出力を変更する処理を追加します。

SeekBar seekBar = (SeekBar)findViewById(R.id.seekBar);
seekBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
    @Override
    public void onProgressChanged(SeekBar seekBar, int i, boolean b) {
        //Log.d("", "" + seekBar.getProgress());
        Device[] devices = App.getInstance().getDevices();
        for (Device device : devices) {
            device.setPwmDuty(seekBar.getProgress());
        }
    }

    @Override
    public void onStartTrackingTouch(SeekBar seekBar) {
    }

    @Override
    public void onStopTrackingTouch(SeekBar seekBar) {
    }
});

• App.getInstance().getDevices()で接続済みのMaBeeeデバイスの配列が取得できます。
• DeviceクラスのsetPwmDuty関数で、MaBeeeデバイスの出力を0%から100%の範囲で調整できます。

スキャン実行

• ビルドして実行します。
• AndroidのBluetoothがONになっているかを確認してください。
• MaBeeeをおもちゃなどにセットして、おもちゃなどの電源をONにしてください。
• スキャンボタンを押すと、ScanActivityが表示されます。
• セルには、MaBeeeの名前、RSSI、接続しているかどうかのアイコンが表示されます。

接続

• セルをタップすると接続します。
• 接続が完了すると赤いアイコンになります。
• バックボタンを押してScanActivityから戻ります。

出力の調整

• SeekBarを調整すると、MaBeeeデバイスの出力が変化します。