微信小程序API_设备应用API（续）_交互反馈API

 #设备应用API

        >拨打电话

                >wx.makePhoneCall(OBJECT) 

属性	类型	必填	说明
phoneNumber	string	是	需要拨打的电话号码
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

wx.makePhoneCall({
    phoneNumber: '13999991111'
})

        >扫码

                >wx.scanCode(OBJECT)

属性	类型	必填	说明
onlyFromCamera	boolean	否	是否只能从相机扫码，不允许从相册选择图片
scanType	Array.<string>		扫码类型
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

        >剪贴板

                >wx.setClipboardData(OBJECT) ：设置剪贴板的内容

                >wx.getClipboardData(OBJECT) ：获取剪贴板的内容

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

        示例代码：

Page({
    onLoad:function(){
        wx.setClipboardData({
            data: '我是剪贴板内容',
            complete: function(res){
                wx.getClipboardData({
                    success:function(res){
                        console.log(res.data)
                    }
                })
            }
        })
    }
})

        >蓝牙

                >初始化蓝牙设备

                        >wx.openBluetoothAdapter(object)

                        >初始化小程序蓝牙功能

                >监听蓝牙状态

                        >wx.onBluetoothAdapterStateChange(CallBack)

                        >用来监听蓝牙状态

                        >返回值available为true时代表蓝牙适配器可用

                        >返回值discovering为true时代表蓝牙适配器处于搜索状态

                >获取蓝牙状态

                        >wx.getBluetoothAdapterState(OBJECT)

                        >用来获取蓝牙状态

                        >返回值available为true时代表蓝牙适配器可用

                        >返回值discovering为true时为正在搜索设备

                >关闭蓝牙模块

                        >关闭蓝牙模块，使其进入未初始化状态

                        >调用该方法将断开所有已建立的链接并释放系统资源

        示例代码：

Page({
    onLoad: function(){
        wx.openBluetoothAdapter({
            success: function(res) {
                console.log(res)
            }
        })
        wx.closeBluetoothAdapter({
            success: function(res) {
                console.log(res)
            }
        })
        wx.onBluetoothAdapterStateChange(function(res){
            console.log('adapterStatechanged, now is',res)
        })
        wx.getBluetoothAdapterState({
            complete: function(res) {
                console.log(res)
            }
        })
    }
})

        >蓝牙设备

                >wx.startBluetoothDevicesDiscovery(OBJECT)

                        >开始搜寻附近的蓝牙外围设备

                        >该操作比较耗费系统资源

wx.startBluetoothDevicesDiscovery参数说明

属性	类型	必填	说明
services	Array.<string>	否	要搜索的蓝牙设备主 service 的 uuid 列表。
allowDuplicatesKey	boolean	否	是否允许重复上报同一设备。如果允许重复上报， 则 wx.onBlueToothDeviceFound 方法会多次上报 同一设备，但是 RSSI 值会有不同。
interval	number	否	上报设备的间隔。0 表示找到新设备立即上报，其他 数值根据传入的间隔上报。
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

                >wx.stopBluetoothDevicesDiscovery(OBJ ECT)

                        >停止搜寻附近的蓝牙外围设备

                >wx.getBluetoothDevices(OBJECT)

                        >获取在小程序蓝牙模块生效期间所有已发现的蓝 牙设备，包括已经和本机处于连接状态的设备

                >wx.getConnectedBluetoothDevices(OBJ ECT)

                        >根据uuid获取处于已连接状态的设备

                >wx.onBluetoothDeviceFound(CallBack)

                        >监听寻找到新设备的事件

        >低功耗蓝牙设备

                > wx.createBLEConnection(OBJECT) ：连接低功耗蓝牙设备

                > wx.closeBLEConnection(OBJECT) ：断开与低功耗蓝牙设备的连接

                > wx.onBLEConnectionStateChange(CallBack) ： 监听低功耗蓝牙连接状态的改变事件

                > wx.ontifyBLECharacteristicValueChange(OBJECT) ：启用低功耗蓝牙设备特征值变化时的notify功能

                > wx.readBLECharacteristicValue(OBJECT) ：读取低功耗蓝牙设备的特征值的二进制数据值

                >wx.writeBLECharacteristicValue(OBJECT)：向低功耗蓝牙设备特征值中写入二进制数据

        >蓝牙设备服务

                >wx.getBLEDeviceServices(OBJECT)：用来获取蓝牙设备所有service

                >wx.getBLEDeviceCharacteristics(OBJEC T) ：用来获取蓝牙某个服务中的所有characteristi

        >屏幕亮度

                >wx.setScreenBrightness(OBJECT)

                        >设置屏幕亮度

                        >一个参数值value，范围是0~1，0代表最暗，1代表最亮

                >wx.getScreenBrightness(OBJECT)

                        >获取屏幕亮度

                >wx.setKeepScreenOn(OBJECT)

                        >用来设置是否保持常亮状态

                        >仅在当前小程序生效，离开小程序后设置失效

                        >它有一个保持屏幕长亮keepScreenOn的参数设置

        >用户截屏事件

                >wx.onUserCaptureScreen(CallBack)

                        >监听用户主动截屏事件

                        >用户使用系统截屏按键截屏时触发此事件

wx.onUserCaptureScreen(function(res){
    console.log()
})

        >振动

                >wx.vibrateLong(OBJECT) ：使手机发生较长时间的振动(400ms)

                >wx.vibrateShort(OBJECT) ：使手机发生较短时间的振动(15ms)

        >手机联系人

                >wx.addPhoneContact(OBJECT)

                        >调用该API后，用户可以选择将该表单以“新增联系人” 或“添加到已有联系人”的方式，写入手机系统通信录， 完成手机通信录联系人和联系方式的增加。

wx.addPhoneContact(OBJECT)参数说明

属性	说明
firstName	名字
photoFilePath	头像本地文件路径
nickName	昵称
lastName	姓氏
middleName	中间名
remark	备注
mobilePhoneNumber	手机号
weChatNumber	微信号
addressCountry	联系地址国家
addressState	联系地址省份
addressCity	联系地址城市
addressStreet	联系地址街道
addressPostalCode	联系地址邮政编码
organization	公司
title	职位
workFaxNumber	工作传真
workPhoneNumber	工作电话
hostNumber	公司电话
email	电子邮件
url	网站
workAddressCountry	工作地址国家
workAddressState	工作地址省份
workAddressCity	工作地址城市
workAddressStreet	工作地址街道
workAddressPostalCode	工作地址邮政编码
homeFaxNumber	住宅传真
homePhoneNumber	住宅电话
homeAddressCountry	住宅地址国家
homeAddressState	住宅地址省份
homeAddressCity	住宅地址城市
homeAddressStreet	住宅地址街道
homeAddressPostalCode	住宅地址邮政编码
success	接口调用成功的回调函数
fail	接口调用失败的回调函数
complete	接口调用结束的回调函数（调用成功、失败都会执行）

#交互反馈API

        >消息提示框

                >消息提示框是一种经常用来提交成功或者加载中的友好提示方式

                >消息提示框可以设置提示框的内容、类型、时间以及相应的事件

                >若想显示消息提示框，可使用 wx.showToast(OBJECT)的API

属性	类型	必填	说明
title	string	是	提示的内容
icon	string	否	图标
image	string	否	自定义图标的本地路径，image 的优先级高于 icon
duration	number	否	提示的延迟时间
mask	boolean	否	是否显示透明蒙层，防止触摸穿透
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

        示例代码：

//1
Page({
    onLoad:function(){
        wx.showToast({
            title: '成功',
            icon:'success',
            duration:2000
        })
    }
})
//2
Page({
    onLoad:function(){
        wx.showToast({
            title: '加载中',
            icon:'loading',
            duration:2000
        })
    }
})

        >模态弹窗

                >模态弹窗用来对整个界面进行覆盖，防止用户操作界面中的其他内容

                >使用wx.showModal(OBJECT)显示模态弹窗

                >可以设置提示的标题、内容、取消按钮和样式、确定按钮和样式及一些绑定事件

属性	类型	必填	说明
title	string	否	提示的标题
content	string	否	提示的内容
showCancel	boolean	否	是否显示取消按钮
cancelText	string	否	取消按钮的文字，最多 4 个字符
cancelColor	string	否	取消按钮的文字颜色，必须是 16 进制格式的颜色字符串
confirmText	string	否	确认按钮的文字，最多 4 个字符
confirmColor	string	否	确认按钮的文字颜色，必须是 16 进制格式的颜色字 符串
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

        示例代码：

Page({
    onLoad:function(){
        wx.showModal({
            title:'提示',
            content:'这是一个模态弹窗',
            success:function(res){
                if(res.confirm){
                    console.log('用户点击确定')
                }
            }
        })
    }
})

        >操作菜单

                >微信小程序中可以借助wx.showActionSheet(OBJECT)实现从底部弹出操作菜单的功能

属性	类型	必填	说明
itemList	Array.<string>	是	按钮的文字数组，数组长度最大为 6
itemColor	string	否	按钮的文字颜色，默认为”#000000”
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

        示例代码：

Page({
    onLoad:function(){
        wx.showActionSheet({
            itemList: ['语文','数学','英语','化学','物理','生物'],
            success:function(res){
                if(!res.cancel){
                    console.log(res.tapIndex)
                }
            }
        })
    }
})

 ...持续学习完善中。

---

#学无止境#