API version 15

Runtime.GetBondedDeviceListメソッド変更履歴

iOSAndroidWindows

説明

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

呼出形式

var devices = Runtime.GetBondedDeviceList()

戻り値

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

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

型	名前	説明
String	*DeviceId*	対象のBluetoothデバイスを識別するIDが格納されます。 Android版 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-83

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

RTM-84

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

RTM-113

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

使用例

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