帝云应用:小程序在线生成,手机站打包小程序,PC建站,百度熊掌号生成
快打包唯一官网(kdabao.com)谨防山寨假冒!
首页JS-SDKAPP插件类正文

蓝牙数据传输

注意:所有JS-SDK使用之前,页面必须先引用YdbOnline,详情看左侧菜单【开始使用-概述】
YDB.OpenBluetooth();     
//参数说明:该方法不需要参数。
//示例:var YDB = new YDBOBJ();YDB.OpenBluetooth();

备注:开通蓝牙数据传输插件之后,才可使用此功能。此功能仅适用于安卓。

蓝牙 4.0

初始化蓝牙4.0管理器

YDB.BLinitManager(callback);     
//参数说明:callback 回调方法。
//返回数据样例:{"state": "poweredOn" } 
//字符串类型;蓝牙4.0设备连接状态,取值范围如下:
//poweredOn:设备开启状态 -- 可用状态
//poweredOff:设备关闭状态
//resetting:正在重置状态
//unauthorized:设备未授权状态
//unknown:初始的时候是未知的
//unsupported:设备不支持的状态
                                     
//示例:var YDB = new YDBOBJ();YDB.BLinitManager("getmanagerstate");  getmanagerstate是您的回调方法名。
function getmanagerstate(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


开始搜索蓝牙4.0设备

YDB.BLscan(callback);
//开始搜索蓝牙4.0设备,会不断的扫描跟新附近的蓝牙4.0设备信息,可通过 BLgetPeripheral 接口来获取扫描到的设备信息。若要停止、清空扫描则调用 BLstopScan 接口     
//参数说明:callback 回调方法。
//返回数据样例:{ "status": "true" }    //布尔类型;是否获取成功,true|false                 
                                     
//示例:var YDB = new YDBOBJ();YDB.BLscan("getscanstate");   getscanstate是您的回调方法名。
function getscanstate(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


获取当前扫描到的所有外围设备信息

YDB.BLgetPeripheral(callback);     
//参数说明:callback 回调方法。
//返回数据样例:{
"peripherals":[{ //数组类型;获取到的当前扫描到的蓝牙4.0设备
"uuid": "",    //字符串类型;扫描到的蓝牙设备的 UUID
"name": "",    //字符串类型;扫描到的蓝牙设备的名字
"rssi": ""       //数字类型;扫描到的蓝牙设备的信号强度
},...]
}      //JSON 对象          
                                     
//示例:var YDB = new YDBOBJ();YDB.BLgetPeripheral("getperipherals");   getperipherals是您的回调方法名。
function getperipherals(peripherals){ //peripherals是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


判断是否正在扫描

YDB.BLisScanning(callback);     
//参数说明:callback 回调方法。
//返回数据样例:{ "status": "true" }    //布尔类型;是否在扫描,true|false         
                                     
//示例:var YDB = new YDBOBJ();YDB.BLisScanning("isScanning");   isScanning是您的回调方法名。
function isScanning(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


停止搜索附近的蓝牙设备,并清空已搜索到的记录在本地的外围设备信息

YDB.BLstopScan();     
//参数说明:不需要传递参数。      
                                     
//示例:var YDB = new YDBOBJ();YDB.BLstopScan();

备注:开通蓝牙4.0插件之后,才可使用此功能。


连接指定外围设备

YDB.BLconnect(peripheralUUID,callback);     
//参数说明:peripheralUUID 要连接的外围设备的 UUID(字符串)   callback 回调方法。
//返回数据样例:{ "status": "true" }    //布尔类型;是否连接成功,true|false         
                                     
//示例:var YDB = new YDBOBJ();YDB.BLconnect('88:0F:10:86:6A:CF','connectstate');   connectstate是您的回调方法名。
function connectstate(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


断开与指定外围设备的连接

YDB.BLdisconnect(peripheralUUID,callback);     
//参数说明:peripheralUUID 要断开连接的外围设备的 UUID(字符串)   callback 回调方法。
//返回数据样例:{ "status": "true" }    //布尔类型;是否成功断开连接,true|false         
                                     
//示例:var YDB = new YDBOBJ();YDB.BLdisconnect('88:0F:10:86:6A:CF','disconnectstate');   disconnectstate是您的回调方法名。
function disconnectstate(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


判断与指定外围设备是否为连接状态

YDB.BLisConnected(peripheralUUID,callback);     
//参数说明:peripheralUUID 指定外围设备的 UUID(字符串)   callback 回调方法。
//返回数据样例:{ "status": "true" }    //布尔类型;是否连接,true|false         
                                     
//示例:var YDB = new YDBOBJ();YDB.BLisConnected('88:0F:10:86:6A:CF','getconnectstate');   getconnectstate是您的回调方法名。
function getconnectstate(state){ //state是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据 UUID 找到所有匹配的蓝牙外围设备信息

YDB.BLretrievePeripheral(peripheralUUIDs,callback);     
//参数说明:peripheralUUIDs 指定的蓝牙外围设备的 UUID 组成的数组(字符串)   callback 回调方法。
//返回数据样例:{
"peripherals":[{ //数组类型;获取到的蓝牙外围设备信息
"uuid": "",    //字符串类型;获取到的蓝牙设备的uuid
"name": "",    //字符串类型;获取到的蓝牙设备的名字
"rssi": "" ,     //数字类型;获取到的蓝牙设备的信号强度
"services":[]  //数组类型;获取到的蓝牙设备的所有服务 UUID 的集合
},...]
}        
                                     
//示例:var YDB = new YDBOBJ();YDB.BLretrievePeripheral('["88:0F:10:86:6A:CF","88:0F:10:80:6A:CF"]', 'getperipherals');   getperipherals是您的回调方法名。
function getperipherals(peripherals){ //peripherals是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。此功能仅适用于IOS。


根据指定的服务,找到当前系统处于连接状态的蓝牙中包含这个服务的所有蓝牙外围设备信息

YDB.BLretrieveConnectedPeripheral(serviceUUIDs,callback);     
//参数说明:serviceUUIDs 指定的蓝牙4.0设备的服务(service)的 UUID(字符串) 组成的数组(字符串)   callback 回调方法。
//返回数据样例:{
"peripherals":[{ //数组类型;获取到的当前处于连接状态的蓝牙外围设备
"uuid": "",    //字符串类型;处于连接状态的蓝牙设备的uuid
"name": "",    //字符串类型;处于连接状态的蓝牙设备的名字
"rssi":  "" ,    //数字类型;处于连接状态的蓝牙设备的信号强度
"services":[]  //数组类型;处于连接状态的蓝牙设备的所有服务 UUID 的集合
},...]
}
                                     
//示例:var YDB = new YDBOBJ();YDB.BLretrieveConnectedPeripheral('["00002902-0000-1000-8000-00805f9b34fb","00002902-0000-5685-8000-00805f9b34fb"]', 'getperipherals');   getperipherals是您的回调方法名。
function getperipherals(peripherals){ //peripherals是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。此功能仅适用于IOS。


根据指定的外围设备 UUID 获取该外围设备的所有服务

YDB.BLdiscoverService(peripheralUUID,callback);     
//参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串)   callback 回调方法。
//返回数据样例:{
"status": "true" ,   //布尔类型;是否获取成功,true|false
"services":[]      //数组类型;获取的所有服务号集合
}
                                     
//示例:var YDB = new YDBOBJ();YDB.BLdiscoverService('88:0F:10:86:6A:CF', 'getservices');   getservices是您的回调方法名。
function getservices(services){ //services是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 获取该外围设备的所有特征

YDB.BLdiscoverCharacteristics(peripheralUUID, serviceUUID,callback);     
//参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID   callback 回调方法。
//返回数据样例:{
"status": "true" ,      //布尔类型;是否获取成功,true|false
"characteristics":[{  //数组类型;获取的所有特征信息的集合
"uuid": "",        //字符串类型;特征的 UUID 
"serviceUUID": "", //字符串类型;服务的 UUID 
"permissions": "", //字符串类型;特征的权限,取值范围如下:
//readable:
//writeable:
//readEncryptionRequired:
//writeEncryptionRequired:
"propertie": ""    //字符串类型;特征的属性,取值范围如下:
//broadcast:
//read:
//writeWithoutResponse:
//write:
//notify:
//indicate:
//authenticatedSignedWrites:
//extendedProperties:
//notifyEncryptionRequired:
//indicateEncryptionRequired:
}]   
}
                                     
//示例:var YDB = new YDBOBJ();YDB.BLdiscoverCharacteristics('88:0F:10:86:6A:CF','00002902-0000-1000-8000-00805f9b34fb', 'getcharacteristics');   getcharacteristics是您的回调方法名。
function getcharacteristics(characteristics){ //characteristics是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 获取该外围设备的所有描述符

YDB.BLdiscoverDescriptorsForCharacteristic(peripheralUUID, serviceUUID, characteristicUUID,callback);     
//参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID   callback 回调方法。
//返回数据样例:
{
"status": "true" ,      //布尔类型;是否读取成功,true|false
"descriptors":[{      //数组类型;获取的所有描述符信息的集合
"uuid": "",        //字符串类型;描述符的 UUID 
"serviceUUID": "", //字符串类型;服务的 UUID 
"characteristicUUID":"",//字符串类型;特征的 UUID 
"decode":"" ,        //布尔类型;描述符的值是否是二进制类型数据
"value":""           //字符串类型;描述符的值,若 decode 为 true,则该值为转码后的值
  }]      
}
                                     
//示例:var YDB = new YDBOBJ();YDB.BLdiscoverDescriptorsForCharacteristic('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB', 'getdescriptors');   
getdescriptors是您的回调方法名。
function getdescriptors(descriptors){ //descriptors是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 监听数据回发

YDB.BLsetNotify(peripheralUUID, serviceUUID, characteristicUUID,callback);     
//参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID   callback 回调方法。
//返回数据样例:{
"status": "true" ,      //布尔类型;是否获取数据,true|false
"characteristic":{    //JSON对象;获取监听的特征的信息
"uuid": "",        //字符串类型;特征的 UUID 
"serviceUUID": "", //字符串类型;服务的 UUID 
"value": "" ,        //字符串类型;特征的值
"permissions": "", //字符串类型;特征的权限,取值范围如下:
//readable:
//writeable:
//readEncryptionRequired:
//writeEncryptionRequired:
"propertie": ""    //字符串类型;特征的属性,取值范围如下:
//broadcast:
//read:
//writeWithoutResponse:
//write:
//notify:
//indicate:
//authenticatedSignedWrites:
//extendedProperties:
//notifyEncryptionRequired:
//indicateEncryptionRequired:
  }      
}
                                     
//示例:var YDB = new YDBOBJ();YDB.BLsetNotify('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB', 'getcharacteristic');  
getcharacteristic是您的回调方法名。
function getcharacteristic(characteristic){ //characteristic是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 读取数据

                    YDB.BLreadValueForCharacteristic(peripheralUUID, serviceUUID, characteristicUUID,callback);     
                     //参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID   callback 回调方法。
                     //返回数据样例:{
                                         "status": "true" ,      //布尔类型;是否读取成功,true|false
                                         "characteristic":{    //JSON对象;获取监听的特征的信息
                                         "uuid": "",        //字符串类型;特征的 UUID 
                                         "serviceUUID": "", //字符串类型;服务的 UUID 
                                         "value": "" ,        //字符串类型;特征的值
                                         "permissions": "", //字符串类型;特征的权限,取值范围如下:
                                                            //readable:
                                                            //writeable:
                                                            //readEncryptionRequired:
                                                            //writeEncryptionRequired:
                                         "propertie": ""    //字符串类型;特征的属性,取值范围如下:
                                                            //broadcast:
                                                            //read:
                                                            //writeWithoutResponse:
                                                            //write:
                                                            //notify:
                                                            //indicate:
                                                            //authenticatedSignedWrites:
                                                            //extendedProperties:
                                                            //notifyEncryptionRequired:
                                                            //indicateEncryptionRequired:
                                        }      
                                    }
                                     
                    //示例:var YDB = new YDBOBJ();YDB.BLreadValueForCharacteristic('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB', 'getcharacteristic');   
                           getcharacteristic是您的回调方法名。
                   function getcharacteristic(characteristic){ //characteristic是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 及其描述符获取数据

                    YDB.BLreadValueForDescriptor(peripheralUUID, serviceUUID, characteristicUUID,descriptorUUID,callback);     
                     //参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID  descriptorUUID 指定的描述符的 UUID   callback 回调方法。
                     //返回数据样例:{
                                            "status": "true" ,      //布尔类型;是否读取成功,true|false
                                            "descriptor":{        //JSON对象;获取的所有描述符信息
                                            "uuid": "",        //字符串类型;描述符的 UUID 
                                            "serviceUUID": "", //字符串类型;服务的 UUID 
                                            "characteristicUUID":"",//字符串类型;特征的 UUID 
                                            "decode":"" ,        //布尔类型;描述符的值是否是二进制类型数据
                                            "value":""           //字符串类型;描述符的值,若 decode 为 true,则该值为转码后的值
                                            }      
                                    }
                                     
                    //示例:var YDB = new YDBOBJ();YDB.BLreadValueForDescriptor('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB', '00002A43-0000-1000-8000-00805F9B34FB', 'getcharacteristic');   getcharacteristic是您的回调方法名。
                   function getcharacteristic(characteristic){ //characteristic是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 写数据

                    YDB.BLwriteValueForCharacteristic(peripheralUUID, serviceUUID, characteristicUUID,value,callback);     
                     //参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID  value 要写入的数据 ,十六进制的字符串   callback 回调方法。
                     //返回数据样例:{
                                                "status": "true" ,      //布尔类型;是否发送成功,true|false
                                                "characteristic":{    //JSON对象;获取监听的特征的信息
                                                "uuid": "",        //字符串类型;特征的 UUID 
                                                "serviceUUID": "", //字符串类型;服务的 UUID 
                                                "permissions": "", //字符串类型;特征的权限,取值范围如下:
                                                                 //readable:
                                                                 //writeable:
                                                                 //readEncryptionRequired:
                                                                 //writeEncryptionRequired:
                                                "propertie": ""    //字符串类型;特征的属性,取值范围如下:
                                                                 //broadcast:
                                                                 //read:
                                                                 //writeWithoutResponse:
                                                                 //write:
                                                                 //notify:
                                                                 //indicate:
                                                                 //authenticatedSignedWrites:
                                                                 //extendedProperties:
                                                                 //notifyEncryptionRequired:
                                                                 //indicateEncryptionRequired:
                                             }      
                                        }
                                     
                    //示例:var YDB = new YDBOBJ();YDB.BLwriteValueForCharacteristic('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB', 'ceshishuju', 'getcharacteristic');   
                           getcharacteristic是您的回调方法名。
                   function getcharacteristic(characteristic){ //characteristic是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 及其描述符发送数据

                    YDB.BLwriteValueForDescriptor(peripheralUUID, serviceUUID, characteristicUUID,descriptorUUID,value,callback);     
                     //参数说明:peripheralUUID 指定的蓝牙外围设备的 UUID(字符串) serviceUUID 指定的服务的 UUID  characteristicUUID 指定的特征的 UUID  descriptorUUID 指定的描述符的 UUID  value 要发送的数据 ,十六进制的字符串   callback 回调方法。
                     //返回数据样例:{
                                                "status": "true" ,      //布尔类型;是否发送成功,true|false
                                                "characteristic":{    //JSON对象;获取监听的特征的信息
                                                "uuid": ",        //字符串类型;特征的 UUID 
                                                "serviceUUID": "", //字符串类型;服务的 UUID 
                                                "permissions": "", //字符串类型;特征的权限,取值范围如下:
                                                                 //readable:
                                                                 //writeable:
                                                                 //readEncryptionRequired:
                                                                 //writeEncryptionRequired:
                                                "propertie": "" ,  //字符串类型;特征的属性,取值范围如下:
                                                                 //broadcast:
                                                                 //read:
                                                                 //writeWithoutResponse:
                                                                 //write:
                                                                 //notify:
                                                                 //indicate:
                                                                 //authenticatedSignedWrites:
                                                                 //extendedProperties:
                                                                 //notifyEncryptionRequired:
                                                                 //indicateEncryptionRequired:
                                                "descriptors":[{        //数组类型;获取的所有描述符信息的集合
                                                    "uuid": "",         //字符串类型;描述符的 UUID 
                                                    "serviceUUID": "",  //字符串类型;服务的 UUID 
                                                    "characteristicUUID":"",//字符串类型;特征的 UUID 
                                                    "decode":"" ,         //布尔类型;描述符的值是否是二进制类型数据
                                                    "value": ""           //字符串类型;描述符的值,若 decode 为 true,则该值为转码后的值
                                                }] 
                                             }       
                                        }
                    //示例:var YDB = new YDBOBJ();YDB.BLwriteValueForDescriptor('88:0F:10:86:6A:CF', '00002902-0000-1000-8000-00805f9b34fb', '00002A43-0000-1000-8000-00805F9B34FB','00002A43-0000-1000-8000-00805F9B34FB', 'ceshishuju', 'getcharacteristic');   getcharacteristic是您的回调方法名。
                   function getcharacteristic(characteristic){ //characteristic是手机端给您返回的json对象 }

备注:开通蓝牙4.0插件之后,才可使用此功能。


微信公众号
微信公众号
网站导航
成品APP
Cms App
案例展示
套餐价格
APP管理面版
文档教程
JS-SDK
帮助教程
联系我们
联系方式
合作代理
付款方式