API version 23

SmaPriBluetooth.CreateBondメソッド変更履歴

iOSAndroidWindows

 

説明

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

 

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

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

 

pinでPINコードを指定した場合、もしくは「プリンタ設定」で「自動ペアリング」がオンになっている場合は、PINコードを自動で入力します。

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

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

 

「プリンタ設定」に関してはこちらを参照してください。

 

呼出形式

sb.CreateBonding( deviceId [, pin] )

 

戻り値

なし

引数

String deviceId

BDアドレスを指定します。(BDアドレスの形式はMACアドレスと同じです)

 

String pin

PINコードを指定します。

例外

RTM-47

位置情報へのアクセスに失敗しました。

 

RTM-54

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

 

RTM-83

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

 

RTM-84

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

 

RTM-113

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

 

RTM-117

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

 

RTM-118

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

 

使用例

SmaPriBluetooth sb;
Function Start() {
    try {
        /* Bluetoothデバイスのスキャン開始 */
        var devices = ^.sb.Discover(10, $FALSE);
        for (var i = 0; i < devices.length; i++) {
            if (devices[i].Name == "SATO Printer") {
                ^.sb.CreateBond(devices[i].DeviceId);
            }
        }
    } catch(e) {
        MessageBox(e.Message);
    }
}
Function OnBluetoothBondingFinished(e) {
    if (e.bonded) {
        //.MessageBox("ボンディングに成功しました。");
    } else {
        //.MessageBox("ボンディングに失敗しました。");
    }
}

 

関連項目

DiscoverGetBondedDevicesメソッド

 

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


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