com.serenegiant.bluetooth

Class BluetoothManager

java.lang.Object

com.serenegiant.bluetooth.BluetoothManager

public class BluetoothManager
extends java.lang.Object

Created by saki on 16/08/30. Bluetooth機器の探索・接続・接続待ち・通信処理を行うためのヘルパークラス・メソッド のパーミッションが必要

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BluetoothManager.BluetoothManagerCallback

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATE_CONNECTED
static int	STATE_CONNECTING
static int	STATE_LISTEN
static int	STATE_NONE
static int	STATE_RELEASED
static java.util.UUID	UUID_SPP SPP(Serial Port Profile)の場合のUUID

Constructor Summary

Constructors

Constructor and Description
BluetoothManager(android.content.Context context, java.lang.String name, java.util.UUID secureProfileUUID, BluetoothManager.BluetoothManagerCallback callback) コンストラクタ
BluetoothManager(android.content.Context context, java.lang.String name, java.util.UUID secureProfileUUID, java.util.UUID inSecureProfileUUID, BluetoothManager.BluetoothManagerCallback callback) コンストラクタ

Method Summary

Modifier and Type	Method and Description
void	addCallback(BluetoothManager.BluetoothManagerCallback callback)
protected void	callOnConnect(android.bluetooth.BluetoothDevice device) 接続待ち中にリモート機器から接続された、 または#connectによるリモート機器への接続要求が成功した時
protected void	callOnDisConnect() リモート機器との接続が切断された時の処理
protected void	callOnDiscover() #startDiscoveryの呼び出しによって新しいリモート機器が見つかった時
protected void	callOnFailed() #connectによるリモート機器との接続要求が失敗した時
protected void	callOnReceive(byte[] message, int length) リモート機器からデータを受信した時
void	connect(android.bluetooth.BluetoothDevice device) 指定したリモートBluetooth機器に接続開始する(クライアントサイド)
void	connect(BluetoothDeviceInfo info) 指定したリモートBluetooth機器へ接続開始する(クライアントサイド)
void	connect(java.lang.String macAddress) 指定したMACアドレスを持つリモートBluetooth機器へ接続開始する(クライアントサイド)
static java.util.Set<android.bluetooth.BluetoothDevice>	getBondedDevices() ペアリング済みのBluetooth機器一覧を取得する
protected android.content.Context	getContext()
java.util.Collection<BluetoothDeviceInfo>	getPairedDevices() 既にペアリング済みのBluetooth機器一覧を取得する
int	getState() 現在の接続状態を取得
static boolean	isAvailable() 端末がBluetoothに対応しているかどうかを確認
boolean	isConnected() 接続されているかどうかを取得
static boolean	isEnabled() 端末がBluetoothに対応していてBluetoothが有効になっているかどうかを確認 パーミッションがなければfalse
boolean	isListening() 接続待機中かどうかを取得
boolean	isReleased() 既に破棄されているかどうかを取得
protected void	onConnect(android.bluetooth.BluetoothSocket socket, android.bluetooth.BluetoothDevice device) 通信スレッドを生成して通信開始 接続待ちスレッドまたは接続要求スレッドでリモート機器との接続に成功した時に呼ばれる
void	release() 関連するリソースを破棄する
void	removeCallback(BluetoothManager.BluetoothManagerCallback callback)
static boolean	requestBluetoothEnable(android.app.Activity activity, int requestCode) 端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る
static boolean	requestBluetoothEnable(android.support.v4.app.Fragment fragment, int requestCode) 端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る
static boolean	requestBluetoothEnable(android.app.Fragment fragment, int requestCode) 端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る
static boolean	requestDiscoverable(android.app.Activity activity, int duration) 他の機器から探索可能になるように要求する bluetoothに対応していないか無効になっている時はIllegalStateException例外を投げる
static boolean	requestDiscoverable(android.app.Fragment fragment, int duration) 他の機器から探索可能になるように要求する bluetoothに対応していないか無効になっている時はIllegalStateException例外を投げる
void	send(byte[] message) 指定したデータを送信する
void	send(byte[] message, int offset, int len) 指定したデータを送信する
void	startDiscovery() Bluetooth機器の探索を開始する。
void	startListen() 接続待ち(サーバーサイド)
void	stop() 接続中なら切断する
void	stopDiscovery() Bluetooth機器の探索中ならキャンセルする

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UUID_SPP

public static final java.util.UUID UUID_SPP

SPP(Serial Port Profile)の場合のUUID

STATE_RELEASED

public static final int STATE_RELEASED

See Also:

Constant Field Values

STATE_NONE

public static final int STATE_NONE

See Also:

Constant Field Values

STATE_LISTEN

public static final int STATE_LISTEN

See Also:

Constant Field Values

STATE_CONNECTING

public static final int STATE_CONNECTING

See Also:

Constant Field Values

STATE_CONNECTED

public static final int STATE_CONNECTED

See Also:

Constant Field Values

Constructor Detail

BluetoothManager

public BluetoothManager(android.content.Context context,
                        java.lang.String name,
                        java.util.UUID secureProfileUUID,
                        BluetoothManager.BluetoothManagerCallback callback)

コンストラクタ

Parameters:

context -

name - サービス名, 任意, nullまたは空文字列ならば端末のモデルとIDを使う

secureProfileUUID - 接続に使用するプロトコル(プロファイル)を識別するためのUUID。セキュア接続用。Android同士でつなぐなら任意で可。PC等のBluetoothシリアル通信を行うならUUID_SPPを使う

callback -

BluetoothManager

public BluetoothManager(android.content.Context context,
                        java.lang.String name,
                        java.util.UUID secureProfileUUID,
                        java.util.UUID inSecureProfileUUID,
                        BluetoothManager.BluetoothManagerCallback callback)

コンストラクタ

Parameters:

context -

name - サービス名, 任意, nullまたは空文字列ならば端末のモデルとIDを使う

secureProfileUUID - 接続に使用するプロトコル(プロファイル)を識別するためのUUID。セキュア接続用。Android同士でつなぐなら任意で可。PC等のBluetoothシリアル通信を行うならUUID_SPPを使う

inSecureProfileUUID - 接続に使用するプロトコル(プロファイル)を識別するためのUUID。インセキュア接続用。Android同士でつなぐなら任意で可。PC等のBluetoothシリアル通信を行うならUUID_SPPを使う nullならsecureProfileUUIDを使う

callback -

Method Detail

isAvailable

public static boolean isAvailable()

端末がBluetoothに対応しているかどうかを確認

Returns:

true Bluetoothに対応している

isEnabled

public static boolean isEnabled()

端末がBluetoothに対応していてBluetoothが有効になっているかどうかを確認 パーミッションがなければfalse

Returns:

true Bluetoothが有効

requestBluetoothEnable

public static boolean requestBluetoothEnable(android.app.Activity activity,
                                             int requestCode)
                                      throws java.lang.SecurityException

端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る

Parameters:

activity -

requestCode -

Returns:

true Bluetoothに対応していて既に有効になっている

Throws:

java.lang.SecurityException - パーミッションがなければSecurityExceptionが投げられる

requestBluetoothEnable

public static boolean requestBluetoothEnable(android.app.Fragment fragment,
                                             int requestCode)
                                      throws java.lang.SecurityException

端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る

Parameters:

fragment -

requestCode -

Returns:

true Bluetoothに対応していて既に有効になっている

Throws:

java.lang.SecurityException - パーミッションがなければSecurityExceptionが投げられる

requestBluetoothEnable

public static boolean requestBluetoothEnable(android.support.v4.app.Fragment fragment,
                                             int requestCode)
                                      throws java.lang.SecurityException

端末がBluetoothに対応しているが無効になっていれば有効にするように要求する 前もってbluetoothAvailableで対応しているかどうかをチェックしておく Bluetoothを有効にするように要求した時は#onActivityResultメソッドで結果を受け取る 有効にできればRESULT_OK, ユーザーがキャンセルするなどして有効に出来なければRESULT_CANCELEDが返る

Parameters:

fragment -

requestCode -

Returns:

true Bluetoothに対応していて既に有効になっている

Throws:

java.lang.SecurityException - パーミッションがなければSecurityExceptionが投げられる

getBondedDevices

public static java.util.Set<android.bluetooth.BluetoothDevice> getBondedDevices()

ペアリング済みのBluetooth機器一覧を取得する

Returns:

Bluetoothに対応していないまたは無効ならnull

requestDiscoverable

public static boolean requestDiscoverable(android.app.Activity activity,
                                          int duration)
                                   throws java.lang.IllegalStateException

他の機器から探索可能になるように要求する bluetoothに対応していないか無効になっている時はIllegalStateException例外を投げる

Parameters:

activity -

duration - 探索可能時間[秒]

Returns:

既に探索可能であればtrue

Throws:

java.lang.IllegalStateException

requestDiscoverable

public static boolean requestDiscoverable(android.app.Fragment fragment,
                                          int duration)
                                   throws java.lang.IllegalStateException

他の機器から探索可能になるように要求する bluetoothに対応していないか無効になっている時はIllegalStateException例外を投げる

Parameters:

fragment -

duration - 0以下ならデフォルトの探索可能時間で120秒、 最大300秒まで設定できる

Returns:

Throws:

java.lang.IllegalStateException

release

public void release()

関連するリソースを破棄する

addCallback

public void addCallback(BluetoothManager.BluetoothManagerCallback callback)

removeCallback

public void removeCallback(BluetoothManager.BluetoothManagerCallback callback)

getPairedDevices

public java.util.Collection<BluetoothDeviceInfo> getPairedDevices()

既にペアリング済みのBluetooth機器一覧を取得する

Returns:

startDiscovery

public void startDiscovery()
                    throws java.lang.IllegalStateException

Bluetooth機器の探索を開始する。 bluetoothに対応していないか無効になっている時はIllegalStateException例外を投げる 新しく機器が見つかった時はBluetoothDevice.ACTION_FOUNDがブロードキャストされるので ブロードキャストレシーバーを登録しておく必要がある

Throws:

java.lang.IllegalStateException

stopDiscovery

public void stopDiscovery()

Bluetooth機器の探索中ならキャンセルする

startListen

public void startListen()

接続待ち(サーバーサイド)

connect

public void connect(BluetoothDeviceInfo info)
             throws java.lang.IllegalStateException

指定したリモートBluetooth機器へ接続開始する(クライアントサイド)

Parameters:

info -

Throws:

java.lang.IllegalStateException

connect

public void connect(java.lang.String macAddress)
             throws java.lang.IllegalArgumentException,
                    java.lang.IllegalStateException

指定したMACアドレスを持つリモートBluetooth機器へ接続開始する(クライアントサイド)

Parameters:

macAddress -

Throws:

java.lang.IllegalArgumentException - アドレスが不正

java.lang.IllegalStateException

connect

public void connect(android.bluetooth.BluetoothDevice device)
             throws java.lang.IllegalStateException

指定したリモートBluetooth機器に接続開始する(クライアントサイド)

Parameters:

device -

Throws:

java.lang.IllegalStateException

stop

public void stop()

接続中なら切断する

send

public void send(byte[] message)
          throws java.lang.IllegalStateException

指定したデータを送信する

Parameters:

message -

Throws:

java.lang.IllegalStateException

send

public void send(byte[] message,
                 int offset,
                 int len)
          throws java.lang.IllegalStateException

指定したデータを送信する

Parameters:

message -

offset -

len -

Throws:

java.lang.IllegalStateException

getState

public int getState()

現在の接続状態を取得

Returns:

isReleased

public boolean isReleased()

既に破棄されているかどうかを取得

Returns:

isConnected

public boolean isConnected()

接続されているかどうかを取得

Returns:

isListening

public boolean isListening()

接続待機中かどうかを取得

Returns:

getContext

protected android.content.Context getContext()

callOnDiscover

protected void callOnDiscover()

#startDiscoveryの呼び出しによって新しいリモート機器が見つかった時

callOnConnect

protected void callOnConnect(android.bluetooth.BluetoothDevice device)
                      throws java.lang.IllegalStateException

接続待ち中にリモート機器から接続された、 または#connectによるリモート機器への接続要求が成功した時

Parameters:

device -

Throws:

java.lang.IllegalStateException

callOnDisConnect

protected void callOnDisConnect()

リモート機器との接続が切断された時の処理

callOnFailed

protected void callOnFailed()

#connectによるリモート機器との接続要求が失敗した時

callOnReceive

protected void callOnReceive(byte[] message,
                             int length)

リモート機器からデータを受信した時

Parameters:

message -

length -

onConnect

protected void onConnect(android.bluetooth.BluetoothSocket socket,
                         android.bluetooth.BluetoothDevice device)

通信スレッドを生成して通信開始 接続待ちスレッドまたは接続要求スレッドでリモート機器との接続に成功した時に呼ばれる

Parameters:

socket -

device -