API version 23

SmaPriBluetooth.GetBondedDevicesメソッド変更履歴

iOSAndroidWindows

 

説明

ボンディング(ペアリング)済みデバイスの一覧を取得します。

 

呼出形式

var devices = sb.GetBondedDevices()

 

戻り値

デバイス情報を格納したRecordの配列を返します。

Recordには下記オブジェクトが含まれます。

名前

説明

String

DeviceId

BDアドレスが格納されます。

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

String

Name

対象のBluetoothデバイスの名称が格納されます。

Number

ConnectableAsBluetoothClassic

Bluetooth Classicデバイスとして接続できるデバイスであれば$TRUEが、接続できなければ$FALSEが格納されます。

Number

ConnectableAsBluetoothLE

BLE(Bluetooth Low Energy)デバイスとして接続できるデバイスであれば$TRUEが、接続できなければ$FALSEが格納されます。

Number

HasRssi

RSSI値(Received Signal Strength Indication)を持つ場合は$TRUEが、持たない場合は$FALSEが格納されます。

BLEデバイスでも稀にRSSI値を持たないものがあります。

Number

Rssi

HasRssiが$TRUEの場合、RSSI値が格納されます。単位はdBmです。

HasRssiが$FALSEの場合、このオブジェクトは付加されません。

Number

HasTxPowerLevel

送信出力値を持つ場合は$TRUEが、持たない場合は$FALSEが格納されます。

Number

TxPowerLevel

HasTxPowerLevelが$TRUEの場合、送信出力値が格納されます。単位はdBmです。

HasTxPowerLevelが$FALSEの場合、このオブジェクトは付加されません。

Array

ServiceUuidList

アドバタイズされているサービス一覧が格納されます。

なお、アドバタイズされていないだけで使用できるサービスがある場合があります。

 

引数

なし

 

例外

RTM-47

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

 

RTM-83

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

 

RTM-84

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

 

使用例

SmaPriBluetooth sm;
Form form1 {
    Width = 424;
    Height = 320;
    Button btnGetBondedDeviceList {
        X = 16;
        Y = 16;
        Width = 120;
        Height = 40;
        Title = "デバイスリスト取得";
        Function OnTouch( e ) {
            try {
                var devices = ^.sb.GetBondedDevices();
                for (var i = 0; i < devices.length; i++) {
                    print(devices[i].DeviceId + "\n");
                 }				
            } catch(e) {
                MessageBox(e.Message);
            }
        }
    }
}

 

関連項目

CreateBondメソッド

 

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


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