applican

マイページに戻る

Bluetooth

Bluetoothの状態取得やON／OFF、シリアル通信が行えます。（Androidのみ）

機能

Bluetoothに対応しているか調べる 【 isSupported 】

Bluetoothが有効かチェックする 【 isEnabled 】

Bluetoothの設定を有効にする 【 enable 】

Bluetoothの設定を無効にする 【 disable 】

Bluetoothデバイスを検索する 【 discover 】

Bluetoothデバイス検索をキャンセルする 【 cancelDiscovery 】

接続したことのあるデバイスを取得する 【 getBondedDevices 】

自デバイスの検出を有効する 【 discoverableOn 】

接続待ち状態する(サーバ側) 【 watchConnection 】

Bluetooth接続する(クライアント側) 【 connect 】

接続中の相手へ文字列データを送信する 【 send 】

Bluetooth通信を切断する 【 disconnect 】

利用用途

Bluetoothを利用した通信やメッセージの送受信を実装したい場合、こちらの機能をご利用ください。

【対応ランタイムバージョン】

ランタイムのバージョン毎に最適化したサンプルをダウンロードしてご使用ください。

サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth
サンプル Bluetooth

メソッド

  • isSupported(Function successCallback, Function errorCallback)
  • isEnabled(Function successCallback, Function errorCallback)
  • enable(Function successCallback, Function errorCallback)
  • disable(Function successCallback, Function errorCallback)
  • discover(Function discoverCallback, Function finishedCallback, Function errorCallback)
  • cancelDiscovery(Function successCallback, Function errorCallback)
  • getBondedDevices(Function successCallback, Function errorCallback)
  • discoverableOn(Number duration, successCallback, Function errorCallback)
  • watchConnection(Function successCallback, Function messageCallback, Function disConnectCallback, Function errorCallback)
  • connect(String address, Function successCallback, Function messageCallback, Function disConnectCallback, Function errorCallback)
  • send(String text)
  • disconnect()

isSupported

メソッド説明

applican.bluetooth.isSupported(Function successCallback, Function errorCallback)

Bluetoothに対応しているかを調べます。

パラメータ

successCallback : Function 成功時のCallbackにはtrue(対応)又は、false(非対応)が返ります。
errorCallback : Function Bluetoothの対応可否が読み取れなかった場合にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.isSupported(bluetoothIsSupported_Success, bluetoothIsSupported_Error);
function bluetoothIsSupported_Success(result){
	alert(result);
}
function bluetoothIsSupported_Error(error){
	var dump = "bluetoothIsSupported_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

isEnabled

メソッド説明

isEnabled(Function successCallback, Function errorCallback)

Bluetoothが有効かどうかチェックします。

パラメータ

successCallback : Function 成功時のCallbackにはtrue(有効)又は、false(無効)が返ります。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.isEnabled(bluetoothIsEnabled_Success, bluetoothIsEnabled_Error);
function bluetoothIsEnabled_Success(result){
	alert(result);
}
function bluetoothIsEnabled_Error(error){
	var dump = "bluetoothIsEnabled_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

enable

メソッド説明

enable(Function successCallback, Function errorCallback)

Bluetoothの設定を有効にします。

パラメータ

successCallback : Function 成功時のCallbackに引数はありません。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.enable(bluetoothEnable_Success, bluetoothEnable_Error);
function bluetoothEnable_Success(){
	alert("有効にしました");
}
function bluetoothEnable_Error(error){
	var dump = "bluetoothEnable_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

disable

メソッド説明

disable(Function successCallback, Function errorCallback)

Bluetoothの設定を無効にします。

パラメータ

successCallback : Function 成功時のCallbackに引数はありません。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.disable(bluetoothDisable_Success, bluetoothDisable_Error);
function bluetoothDisable_Success(){
	alert("無効にしました");
}
function bluetoothDisable_Error(error){
	var dump = "bluetoothDisable_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

discover

メソッド説明

discover(Function discoverCallback, Function finishedCallback, Function errorCallback)

Bluetoothデバイスを検索します。

パラメータ

discoverCallback : Function デバイスを1台発見する毎に関数がCallbackされます。Callbackの引数にはオブジェクト形式でnameとaddressが渡されます。
finishedCallback : Function 一定時間経過して検索が完了した場合か、検索がキャンセルされると設定した関数がCallbackされます。Callbackの引数にはデバイス情報の配列が渡されます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.discover(bluetoothDiscover_Discovered, bluetoothDiscover_Finished, bluetoothDiscover_Error);
function bluetoothDiscover_Discovered(result){
	var dump = "bluetoothDiscover_Discovered\n";
	dump += result.name +", "+result.address+"\n";
	console.log(dump);
}
function bluetoothDiscover_Finished(result){
	var dump = "bluetoothDiscover_Finished\n";
	if(result!=null && result.length>0){
		var cnt = result.length;
		for(var i=0; i<cnt; i++){
			dump += result[i].name +", "+result[i].address+"\n";
		}
	}
	alert(dump);
}
function bluetoothDiscover_Error(error){
	var dump = "bluetoothDiscover_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

cancelDiscovery

メソッド説明

cancelDiscovery(Function successCallback, Function errorCallback)

Bluetoothデバイス検索をキャンセルます。

パラメータ

successCallback : Function 成功時のCallbackに引数はありません。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.cancelDiscovery(bluetoothCancelDiscovery_Success, bluetoothCancelDiscovery_Error);
function bluetoothCancelDiscovery_Success(){
	alert("キャンセルしました");
}
function bluetoothCancelDiscovery_Error(error){
	var dump = "bluetoothCancelDiscovery_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

getBondedDevices

メソッド説明

getBondedDevices(Function successCallback, Function errorCallback)

接続したことのあるデバイスを取得します。

パラメータ

successCallback : Function 成功時のCallback引数にはデバイス情報の配列が渡されます。（nameとaddressのリスト）
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.getBondedDevices(bluetoothGetBondedDevices_Success, bluetoothGetBondedDevices_Error);
function bluetoothGetBondedDevices_Success(result){
	var dump = "bluetoothGetBondedDevices_Success\n";
	if(result!=null && result.length>0){
		var cnt = result.length;
		for(var i=0; i<cnt; i++){
			dump += result[i].name +", "+result[i].address+"\n";
		}
	}
	alert(dump);
}
function bluetoothGetBondedDevices_Error(error){
	var dump = "bluetoothGetBondedDevices_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

discoverableOn

メソッド説明

discoverableOn(Number duration, Function successCallback, Function errorCallback)

自デバイスの検出を有効にします。

パラメータ

duration : Number 検出有効時間を設定します。上限は300秒まで設定可能です。
successCallback : Function 成功時のCallbackにはtrue(有効化)又は、false(ユーザキャンセル)が返ります。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.discoverableOn(300, bluetoothDiscoverableOn_Success, bluetoothDiscoverableOn_Error);
function bluetoothDiscoverableOn_Success(result){
	var dump = "bluetoothDiscoverableOn_Success\n";
	dump += "result : "+result;
	alert(dump);
}
function bluetoothDiscoverableOn_Error(error){
	var dump = "bluetoothDiscoverableOn_Error\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

watchConnection

メソッド説明

watchConnection(Function successCallback, Function messageCallback, Function disConnectCallback, Function errorCallback)

接続待ち状態にします。(サーバ側)

パラメータ

successCallback : Function 接続完了時に実行される関数がCallbackされます。
messageCallback : Function メッセージ受信時に実行される関数がCallbackされます。
受信メッセージはコールバックの引数に文字列として渡されます。
メッセージは、シリアル通信を定期的にポーリングして受信するため、長いデータは分割されて通知される場合があります。
disConnectCallback : Function 接断時に実行される関数がCallbackされます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

applican.bluetooth.watchConnection(
	bluetoothServerOnOpen,
	bluetoothServerOnMessage,
	bluetoothServerOnClose,
	bluetoothServerOnError
);
function bluetoothServerOnOpen(){
	alert("onOpen");
}
function bluetoothServerOnMessage(message){
	alert("onMessage:"+message);
}
function bluetoothServerOnClose(){
	alert("onClose");
}
function bluetoothServerOnError(error){
	var dump = "bluetoothServerOnError\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

connect

メソッド説明

watchConnection(String address, Function successCallback, Function messageCallback, Function disConnectCallback, Function errorCallback)

Bluetooth接続します。(クライアント側)

パラメータ

address : String 接続先のBluetoothアドレスを指定します。
successCallback : Function 接続完了時に実行される関数がCallbackされます。
messageCallback : Function メッセージ受信時に実行される関数がCallbackされます。
受信メッセージはコールバックの引数に文字列として渡されます。
メッセージは、シリアル通信を定期的にポーリングして受信するため、長いデータは分割されて通知される場合があります。
disConnectCallback : Function 接断時に実行される関数がCallbackされます。
errorCallback : Function 失敗時に実行される関数がCallbackされます。

Return

void

サンプルコード

applican.bluetooth.connect(
	“00:00:00:00:00”,
	bluetoothClientOnOpen,
	bluetoothClientOnMessage,
	bluetoothClientOnClose,
	bluetoothClientOnError
);

function bluetoothClientOnOpen(){
	alert("onOpen");
}
function bluetoothClientOnMessage(message){
	alert("message:"+message);
}
function bluetoothClientOnClose(){
	alert("onOnClose");
}
function bluetoothClientOnError(error){
	var dump = "bluetoothClientOnError\n";
	dump += "code:"+error.code+"\n";
	dump += "message:"+error.message+"\n";
	alert(dump);
}

send

メソッド説明

send(String text)

接続中の相手へ文字列データを送信することができます。

パラメータ

text : String 送信する文字列データを入力します。

Return

void

サンプルコード

applican.bluetooth.send(“test send”);

disconnect

メソッド説明

disconnect()

Bluetooth通信を切断します。

Return

void