概述

bluetooth 模块封装了系统的蓝牙功能，使用此模块可实现两台设备间无缝传输数据。可传输字符串、图片、视频、文件等各种数据。使用此模块需打开设备蓝牙功能

注意：本模块中 iOS 端封装了 GameKit 相关接口。只能用于 iOS 设备且为同一个应用程序之间的连接。适合发送较小的数据。对其它蓝牙设备的连接请使用模块 ble

connect

打开蓝牙连接

connect({params}, callback(ret, err))

params

codeType：

• 类型：字符串
• 描述：（可选项）要发送的数据的编码格式，取值范围：utf-8、gbk
• 默认值：utf-8

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    progress:    //发送接收数据时的进度
    message：    //收到的数据信息，如果是字符串则直接显示，如果是文件则返回其路径
}

示例代码

var bluetooth = api.require('bluetooth');
bluetooth.connect({
    codeType: 'utf-8',
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

send

发送数据

send({params})

params

type：

• 类型：数字
• 描述：要发送的数据类型
• 取值范围：
  • 0：字符串
  • 1：文件
  • 2：本地相册里的图片
  • 3：本地视频库里的视频

data：

• 类型：字符串
• 描述：要发送的数据

示例代码

var bluetooth = api.require('bluetooth');
bluetooth.send({
    type: 0,
    data: 'bluetooth send string test'
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cancel

取消蓝牙连接

cancel()

示例代码

var bluetooth = api.require('bluetooth');
bluetooth.cancel();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本