API version 15

Runtime.RequestBondingメソッド変更履歴

iOSAndroidWindows

 

説明

指定したデバイスIDのデバイスに対してボンディング(ペアリング)を開始します。

 

このメソッドはボンディング処理を開始した直後に処理を返します。処理の終了を待機しません。

ボンディングの成功/失敗はBluetoothBondingFinishedイベントを使ってハンドリングします。

 

ボンディングに必要なPINコードの入力や互いのデバイス間でのPINコードの確認作業は、ユーザーの操作が必要です。

この時のダイアログはOSから表示されます。

 

呼出形式

Runtime.RequestBonding( deviceId )

 

戻り値

なし

引数

String deviceId

デバイスのBDアドレス(BDアドレスの形式はMACアドレスと同じです)

例外

RTM-54

端末のBluetooth機能へのアクセスに失敗しました。

 

RTM-83

Bluetoothが有効になっていません。

 

RTM-84

Bluetoothの使用が許可されていません。OSの設定でBluetoothの使用を許可してください。 *1

 

RTM-113

Bluetoothデバイス制御はサポートされていません。

 

RTM-117

現在ボンディング中です。

 

RTM-118

既にボンディング済です。

使用例

Function Start() {
    try {
        /* Bluetooth Classicデバイスのスキャン開始 */
        var params = new Array();
        params["CONNECTABLE_DEVICE_ONLY"] = true;
        Runtime.StartBluetoothScanning(Runtime.BLUETOOTH_CLASSIC, params);				
    } catch(e) {
        MessageBox(e.Message);
    }
}
Function OnBluetoothDeviceFound(e) {
    if (e.Name == "ExampleDeviceName") {
        try {
            Runtime.RequestBonding(e.DeviceId);		
        } catch (e) {
            //.MessageBox(e.Message);
        }
    }
}
Function OnBluetoothBondingFinished(e) {
    if (e.bonded) {
        //.MessageBox("ボンディングに成功しました。");
    } else {
        //.MessageBox("ボンディングに失敗しました。");
    }
}

 

関連項目

StartBluetoothScanningGetBondedDeviceListメソッド

 

変更履歴
*1 API version 26で追加されました。


「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る