vivo 智能终端设备侧

更新时间:

用于和搭配使用的手机 app 进行通信,收发手机 app 数据。

接口声明

{ "name": "blueos.bluexlink.connectionManager" }
复制代码

导入模块

import interconnect from '@blueos.bluexlink.connectionManager'const interconnect = require('@blueos.bluexlink.connectionManager')
复制代码

interconnect.getPeerDeviceStatus(OBJECT)

获取 vivo 智能终端设备和手机的连接状态

参数:

属性 必填 类型 说明
success Function 成功回调
fail Function 失败回调

success 返回值:

属性 类型 说明
status number 0:未连接。1:已连接

示例:

interconnect.getPeerDeviceStatus({
  success: function (data) {
    if (data.status == 1) {
      console.log('已连接')
    } else if (data.status == 0) {
      console.log('未连接')
    }
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
复制代码

interconnect.instance(OBJECT)

创建连接实例

参数:

属性 必填 类型 说明
package string 手机 APP 包名
fingerprint string 手机 APP 的证书指纹信息。 证书指纹的获取方法

返回值:

Connect

示例:

const connnect = interconnect.instance({ package: 'com.xx.xx', fingerprint: 'xxxxx' })
复制代码

connect

getReadyState(OBJECT)

获取 App 连接状态

参数:

属性 必填 类型 说明
success Function 成功回调
fail Function 失败回调

success 返回值:

属性 类型 说明
status number 1:连接成功。2:连接断开

fail 返回值:

参数 类型 说明
data string 错误信息
code number 错误码,1006 表示 连接断开

示例:

connect.getReadyState({
  success: function (data) {
    if (data.status == 1) {
      console.log('连接成功')
    } else if (data.status == 2) {
      console.log('连接失败')
    }
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
复制代码

getPeerDeviceClientVersion(OBJECT)

查询 App 版本状态

参数:

属性 必填 类型 说明
success Function 成功回调
fail Function 失败回调

success 返回值:

属性 类型 说明
version number 手机应用版本号,有则正常返回,-1:未安装

fail 返回值:

参数 类型 说明
data string 错误信息
code number 错误码,1006 表示 连接断开

示例:

connect.getPeerDeviceClientVersion({
  success: function (data) {
    console.log(`handling success, version = ${data.version}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
复制代码

send(OBJECT)

发送数据到手机 App 端

参数:

属性 必填 类型 说明
data Object 发送的数据
success Function 成功回调
fail Function 失败回调

fail 返回值:

参数 类型 说明
data string 错误信息
code number 错误码,1006 表示 连接断开

示例:

connect.send({
  data: { name: 'zangsan' },
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log('handling fail')
  },
})
复制代码

sendFile(OBJECT)

发送文件到手机 App 端

参数:

属性 必填 类型 说明
uri String 目录的 uri
success Function 成功回调
fail Function 失败回调

fail 返回值:

参数 类型 说明
data string 错误信息
code number 错误码,1006 表示 连接断开

示例:

connect.sendFile({
  uri: 'internal://files/work/demo',
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log('handling fail')
  },
})
复制代码

close(OBJECT)

关闭当前连接

参数:

参数名 类型 必填 说明
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数

示例:

connect.close({
  success() {
    console.log(`close success`)
  },
  fail(data, code) {
    console.log(`handling fail, code = ${code}`)
  },
})
复制代码

onOpen

用于指定连接打开时的回调

示例:

connect.onOpen = function () {
  console.log('connection opened')
}
复制代码

onClose

用于指定连接关闭时回调

示例:

connect.onClose = function () {
  console.log('connection closed')
}
复制代码

onMessage

用于指定接收手机 App 端数据的回调

回调返回:

属性 类型 说明
isFileType boolean 是否是文件
fileUri string 文件存储路径
fileName string 文件名称

示例:

// 监听手机app的数据
connect.onMessage = function (data) {
  if (data && data.isFileType) {
    console.log('filename is', data.fileName)
  } else {
    console.log('msg is', data.data)
  }
}
复制代码

onError

用于指定连接失败后的回调

回调返回:

属性 类型 说明
data string 错误信息
code number 错误码, 1000:未知错误, 1001:手机 APP 未安装, 1002:手机三方 APP 和健康未连接,1006:蓝牙未连接,1007:指纹校验失败

示例:

connect.onError = function (error) {
  console.log(`connection error code =${error.code} data = ${error.data}`)
}
复制代码
上一篇
手机侧
下一篇
通信能力
以上内容对您是否有帮助?
  • 毫无帮助
  • 帮助不大
  • 一般
  • 很好
  • 非常好
意见反馈