智能小程序 Ray 开发设备 API —— 蓝牙、Wi-Fi、剪切板 API 合集

蓝牙-通用 API 

onBluetoothAdapterStateChange

监听蓝牙适配器状态变化事件

引入

import { onBluetoothAdapterStateChange } from '@ray-js/ray';

需引入BaseKit，且在>=1.2.10版本才可使用

参数

function callback

监听蓝牙适配器状态变化事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
available	boolean		是	蓝牙适配器是否可用

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

offBluetoothAdapterStateChange

取消监听蓝牙适配器状态变化事件

引入

import { offBluetoothAdapterStateChange } from '@ray-js/ray';

需引入BaseKit，且在>=1.2.10版本才可使用

参数

function callback

取消监听蓝牙适配器状态变化事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
available	boolean		是	蓝牙适配器是否可用

 

Wi-Fi API 

getConnectedWifi

获取当前连接的 wifi 信息

iOS: 返回 SSID 和 BSSID

引入

import { getConnectedWifi } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
partialInfo	boolean		否	是否需要返回部分 Wi-Fi 信息 安卓 ty.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID 属性的 WifiInfo 对象。 iOS ty.getConnectedWifi 若设置了 partialInfo:true ，将会返回只包含 SSID、BSSID 属性的 WifiInfo 对象，且需要用户开启定位权限才能正确返回结果。 默认值：false
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
SSID	string	wifi 的 SSID
BSSID	string	wifi 的 BSSID
signalStrength	number	Wi-Fi 信号强度, 安卓取值 0 ～ 100 ，iOS 取值 0 ～ 1 ，值越大强度越大
secure	boolean	Wi-Fi 是否安全 Android：Android 系统 12 开始支持。
frequency	number	Wi-Fi 频段单位 MHz

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

 

getWifiList

获取手机附近的 Wi-Fi 列表；列表数据通过 onGetWifiList 事件发送

引入

import { getWifiList } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

 

onGetWifiList

监听获取到 Wi-Fi 列表数据事件

引入

import { onGetWifiList } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用

参数

function callback

监听获取到 Wi-Fi 列表数据事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
wifiList	array		是	Wi-Fi 列表

 

offGetWifiList

取消监听：监听获取到 Wi-Fi 列表数据事件

引入

import { offGetWifiList } from '@ray-js/ray';

需引入BaseKit，且在>=2.4.3版本才可使用

参数

function callback

取消监听：监听获取到 Wi-Fi 列表数据事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
wifiList	array		是	Wi-Fi 列表

 

剪切板 API 

setClipboardData

设置系统剪贴板的内容

引入

import { setClipboardData } from '@ray-js/ray';

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
data	string		是	剪贴板的内容
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

 

getClipboardData

获取系统剪贴板的内容

引入

import { getClipboardData } from '@ray-js/ray';

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
data	string	剪贴板的内容

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。