宜信同城网交流论坛技术专版技术专区iBeacon模块用于搜索附件的iBeacon设备HBuilderX1.1.0及以上版本支持此功能。方法： startBeaconDiscovery: 开始搜索附近的iBeacon设备stopB ...

admin 发表于 2023-2-16 18:54:52

iBeacon模块用于搜索附件的iBeacon设备

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 HBuilderX1.1.0及以上版本支持此功能。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.startBeaconDiscovery">startBeaconDiscovery</a>: 开始搜索附近的iBeacon设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.stopBeaconDiscovery">stopBeaconDiscovery</a>: 停止搜索附近的iBeacon设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.getBeacons">getBeacons</a>: 获取已搜索到的iBeacon设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.onBeaconUpdate">onBeaconUpdate</a>: 监听iBeacon设备更新</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.onBeaconServiceChange">onBeaconServiceChange</a>: 监听iBeacon服务状态变化</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconInfo">IBeaconInfo</a>: iBeacon设备信息</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconSuccessCallback">IBeaconSuccessCallback</a>: 成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconFailCallback">IBeaconFailCallback</a>: 失败回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconCompleteCallback">IBeaconCompleteCallback</a>: 操作完成回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconUpdateCallback">IBeaconUpdateCallback</a>: 获取iBeacon设备信息回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconServiceChangeCallback">IBeaconServiceChangeCallback</a>: iBeacon服务状态变化回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"iBeacon": {
"description": "iBeacon"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">startBeaconDiscovery</h1>
开始搜索附近的iBeacon设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ibeacon.startBeaconDiscovery(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
搜索成功后触发successCB回调，失败触发errorCB回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>uuids: ( Array ) 可选 要搜索设备的uuid </li><li>ignoretoothAvailable: ( Boolean ) 可选 是否校验蓝牙开关 Android平台忽略此属性，iOS平台默认值为false。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconSuccessCallback">IBeaconSuccessCallback</a> ) 可选 搜索设备成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconFailCallback">IBeaconFailCallback</a> ) 可选 搜索设备失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconCompleteCallback">IBeaconCompleteCallback</a> ) 可选 搜索设备操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>iBeacon Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener('plusready', onPlusReady, false);
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){

}
// 搜索iBeacon设备
function startBeaconDiscovery(){
plus.ibeacon.startBeaconDiscovery({
success;function(){
plus.nativeUI.alert('start success');
},
fail:function(e){
plus.nativeUI.alert('start error: '+JSON.stringify(e));
}
});
}
</script>
</head>
<body >
<button onclick="startBeaconDiscovery()">开始搜索</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">stopBeaconDiscovery</h1>
停止搜索附近的iBeacon设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ibeacon.stopBeaconDiscovery(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
取消成功后触发successCB回调，失败触发errorCB回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconSuccessCallback">IBeaconSuccessCallback</a> ) 可选 停止搜索成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconFailCallback">IBeaconFailCallback</a> ) 可选 停止搜索失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/ibeacon.html#plus.ibeacon.IBeaconCompleteCallback">IBeaconCompleteCallback</a> ) 可选 停止搜索操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>iBeacon Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener('plusready', onPlusReady, false);
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){

}
// 搜索iBeacon设备
function startBeaconDiscovery(){
plus.ibeacon.startBeaconDiscovery({
success: function(){
plus.nativeUI.alert('start success');
},
failed: function(e){
plus.nativeUI.alert('start error: '+JSON.stringify(e));
}
});
}
// 停止搜索iBeacon设备
function stopBeaconDiscovery(){
plus.ibeacon.stopBeaconDiscovery({
success: function(){
plus.nativeUI.alert('stop success');
},
failed: function(e){
plus.nativeUI.alert('stop error: '+JSON.stringify(e));
}
});
}
</script>
</head>
<body >
<button onclick="startBeaconDiscovery()">开始搜索</button>
 
<button onclick="stopBeaconDiscovery()">停止搜索</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBeacons</h1>
获取已搜索到的iBeacon设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ibeacon.getBeacons(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取成功后触发successCB回调，失败触发errorCB回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconSuccessCallback">IBeaconSuccessCallback</a> ) 可选 获取设备成功回调函数 回调函数参数event对象包括以下属性： beacons - Array<IBeaconInfo>类型，iBeacon设备列表信息。 </li><li>fail: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconFailCallback">IBeaconFailCallback</a> ) 可选 获取设备失败回调函数 </li><li>complete: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconCompleteCallback">IBeaconCompleteCallback</a> ) 可选 获取设备操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>iBeacon Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener('plusready', onPlusReady, false);
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){

}
// 获取iBeacon设备
function getBeacons(){
plus.ibeacon.startBeaconDiscovery({
success: function(){
plus.ibeacon.getBeacons({
success: function(e){
var beacons = e.beacons;
var uuids = null;
for(var i in beacons){
if(uuids){
uuids += ', '+beacons[i].uuid;
}else{
uuids = beacons[i].uuid;
}
}
plus.nativeUI.alert('Beacons: '+uuids);
},
failed: function(e){
plus.nativeUI.alert('getBeacons error: '+JSON.stringify(e));
}
});
},
failed: function(e){
plus.nativeUI.alert('start error: '+JSON.stringify(e));
}
});
}
</script>
</head>
<body >
<button onclick="getBeacons()">获取iBeacon设备</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBeaconUpdate</h1>
监听iBeacon设备更新
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ibeacon.onBeaconUpdate(updateCB);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
iBeacon设备更新后触发updateCB回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>updateCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconUpdateCallback">IBeaconUpdateCallback</a> ) 必选 更新iBeacon设备回调函数 回调函数参数event对象包括以下属性： beacons - Array<IBeaconInfo>类型，iBeacon设备列表信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>iBeacon Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener('plusready', onPlusReady, false);
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){

}
// 监听iBeacon设备更新
function listenerBeacons(){
plus.ibeacon.startBeaconDiscovery({
success:function(){
plus.ibeacon.onBeaconUpdate(function(e){
var beacons = e.beacons;
var uuids = null;
for(var i in beacons){
if(uuids){
uuids += ', '+beacons[i].uuid;
}else{
uuids = beacons[i].uuid;
}
}
plus.nativeUI.alert('Beacons updated: '+uuids);
});
},
failed: function(e){
plus.nativeUI.alert('start error: '+JSON.stringify(e));
}
});
}
</script>
</head>
<body >
<button onclick="listenerBeacons()">监听iBeacon设备更新</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBeaconServiceChange</h1>
监听iBeacon服务状态变化
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.ibeacon.onBeaconServiceChange(changeCB);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
iBeacon服务状态变化时触发changeCB回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>changeCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122818986#plus.ibeacon.IBeaconServiceChangeCallback">IBeaconServiceChangeCallback</a> ) 必选 iBeacon服务状态变化回调函数 回调函数参数event对象包括以下属性： available - Boolean类型，iBeacon服务目前是否可用； discovering - Boolean类型，是否处于搜索iBeacon设备状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>iBeacon Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener('plusready', onPlusReady, false);
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady(){
// 监听iBeacons服务状态变化
plus.ibeacon.onBeaconServiceChange(function(e){
console.log('BeaconServiceChanged: available='+e.available+', discovering='+e.discovering);
});
}
// 搜索iBeacon设备
function startBeaconDiscovery(){
plus.ibeacon.startBeaconDiscovery({
success: function(){
console.log('start success');
},
failed: function(e){
console.log('start error: '+JSON.stringify(e));
}
});
}
// 停止搜索iBeacon设备
function stopBeaconDiscovery(){
plus.ibeacon.stopBeaconDiscovery({
success: function(){
console.log('stop success');
},
failed: function(e){
console.log('stop error: '+JSON.stringify(e));
}
});
}
</script>
</head>
<body >
<button onclick="startBeaconDiscovery()">开始搜索</button>
 
<button onclick="stopBeaconDiscovery()">停止搜索</button>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">IBeaconInfo</h1>
iBeacon设备信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface IBeaconInfo {
readonly attribute String uuid;
readonly attribute String major;
readonly attribute String minor;
readonly attribute Number proximity;
readonly attribute Number accuracy;
readonly attribute Number rssi;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>uuid: (String 类型 )iBeacon设备广播的uuid</li><li>major: (String 类型 )iBeacon设备的主id</li><li>minor: (String 类型 )iBeacon设备的次id</li><li>proximity: (Number 类型 )iBeacon设备的距离</li><li>accuracy: (Number 类型 )iBeacon设备的距离精度信息</li><li>rssi: (String 类型 )iBeacon设备的信号强度</li></ul>
<h1 style="margin-left:0;">IBeaconSuccessCallback</h1>
成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 回调参数 回调参数包含的属性由调用接口决定，具体参考对应的接口描述说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IBeaconFailCallback</h1>
失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onFail(Exception error){
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 回调参数，错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IBeaconCompleteCallback</h1>
操作完成回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onComplete(event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用成功或失败都会触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 回调参数 调用成功时回调参数与IBeaconSuccessCallback一致，调用失败时回调参数与IBeaconFailCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IBeaconUpdateCallback</h1>
获取iBeacon设备信息回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
// 通过beacons获取iBeacon设备列表信息
var beacons = event.beacons;
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 设备信息 可通过event.beacons（Array<IBeaconInfo>类型）获取iBeacon设备列表信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">IBeaconServiceChangeCallback</h1>
iBeacon服务状态变化回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
// 通过available、discovering获取iBeacon服务状态
var available = event.available;
var discovering = event.discovering;
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 iBeacon服务状态信息 可通过event.available（Boolean类型）获取iBeacon服务目前是否可用； 可通过event.discovering（Boolean类型）获取是否处于搜索iBeacon设备状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

iBeacon模块用于搜索附件的iBeacon设备