bluetooth


该插件用于蓝牙传输字符串,图片,视频,文件.

方法:

  • start : 启用蓝牙.
  • send : 发送数据或者文件.
  • stop : 终止发送.

回调方法

start


启动蓝牙连接.

rd.bluetooth.start(oprationCallBack,errorCallBack,DISPLAYNAME);
说明:

调用此方法后,自动广播本机蓝牙ID,同时搜索周围蓝牙设备.通过设备列表选择要连接的设备.

参数:
  • oprationCallBack: ( operationCallBack ) 必选 操作回调函数.
  • errorCallBack: ( errorCallBack ) 必选 错误回调.
  • DISPLAYNAME: ( String ) 必选 设备名称.
返回值:

无返回值

示例:
function oprationCallBack(progress,data){
     alert(progress +'::'+data);
}

function errorCallBack(err){
        alert(err);
}

rd.bluetooth.start(oprationCallBack,errorCallBack,'369Cloud');

send


发送数据或者文件

rd.bluetooth.send( TYPE, CONTENT);    
说明:

调用此方法发送字符串或者文件,图片,视频等.通过参数type来设置发送的文件类型.

参数:
  • TYPE: ( String ) 必选 要发送的文件类型 可设置为:'ALBUM'(发送相册里的图片或者视频,自动弹出相册,让用户选择图片或者视频), 'FILE'(发送文件), 'STRING'(发送字符串)
  • CONTENT: ( String ) 可选 根据要发送的文件类型,填写对应的内容:'ALBUM'(不填写任何内容), 'FILE'(填写本地文件路径), 'STRING'(填写字符串)
返回值:

无返回值

示例:
rd.bluetooth.send('STRING','hello World');//发送字符串
rd.bluetooth.send('FILE','cache://abc.txt');//发送文件 
rd.bluetooth.send('ALBUM');//发送相册里的图片或者视频

stop


终止发送文件.

rd.bluetooth.stop();    
说明:

调用此方法终止正在发送的文件.

参数:

返回值:

无返回值

示例:
rd.bluetooth.stop();

operationCallBack


操作回调.

function oprationCallBack(progress,data){
     alert(progress +'::'+data);
}
说明:

发送状态: 通过此回调函数返回发送进度(progress),data参数始终为空字符串. 接收状态: 通过此回调函数返回接收到的文件路径,如果是字符串,直接返回字符串.progress参数始终为1.

参数:
  • progress : (Number) 发送文件的进度.范围 0 ~ 1.
  • data : (String) 接收文件的路径,如果接收到的时字符串,直接返回字符串.

errorCallBack


错误回调.

function errorCallBack(err){
        alert(err);
}
说明:

当插件出现错误时,通过此函数回调.

参数:
  • error : ( String ) 错误描述.