bluetooth

来自于:官方立即使用

概述

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及更高版本