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) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: 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及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/11/18