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:已连接 |
fail 返回值:
示例：
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 的证书指纹信息。 证书指纹的获取方法 |
返回值：
interconnect 的链接实例 connect 对象
示例：
const connnect = interconnect.instance({ package: 'com.xx.xx', fingerprint: 'xxxxx' })复制代码
connect 对象方法
connect.getReadyState(OBJECT)
获取 App 连接状态
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| success | 否 | Function | 成功回调 |
| fail | 否 | Function | 失败回调 |
success 返回值:
| 属性 | 类型 | 说明 |
|---|---|---|
| status | Number | 1:连接成功。2:连接断开 |
fail 返回值:
| 错误码 | 说明 |
|---|---|
| 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}`)
},
})复制代码
connect.getPeerDeviceClientVersion(OBJECT)
查询 App 版本状态
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| success | 否 | Function | 成功回调 |
| fail | 否 | Function | 失败回调 |
success 返回值:
| 属性 | 类型 | 说明 |
|---|---|---|
| version | Number | 手机应用版本号，有则正常返回，-1:未安装 |
fail 返回值:
| 错误码 | 说明 |
|---|---|
| 1006 | 连接断开 |
示例：
connect.getPeerDeviceClientVersion({
success: function (data) {
console.log(`handling success, version = ${data.version}`)
},
fail: function (data, code) {
console.log(`handling fail, code = ${code}`)
},
})复制代码
connect.onOpen = function(){}
用于指定连接打开时的回调函数
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| callback | 否 | Function | 连接打开回调 |
示例：
connect.onOpen = function () {
console.log('connection opened')
}复制代码
connect.onClose = function(data,code){}
用于指定连接关闭时回调函数
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| callback | 否 | Function | 连接关闭时回调 |
callback 参数:
无
示例：
connect.onClose = function () {
console.log('connection closed')
}复制代码
connect.onError = function(data,code){}
用于指定连接失败后的回调函数
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| callback | 否 | Function | 连接出错回调 |
callback 参数:
| 属性 | 类型 | 说明 |
|---|---|---|
| data | String | 错误信息 |
| code | Number | 错误码, 1000：未知错误， 1001：手机 APP 未安装， 1002：手机三方 APP 和健康未连接，1006：蓝牙未连接，1007：指纹校验失败 |
示例：
connect.onError = function (data, code) {
console.log('connection error')
}复制代码
connect.send(OBJECT)
发送数据到手机 App 端
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| data | 否 | Object | 发送的数据 |
| success | 否 | Function | 成功回调 |
| fail | 否 | Function | 失败回调 |
success 返回值:
无
fail 返回值:
| 错误码 | 说明 |
|---|---|
| 1006 | 连接断开 |
示例：
connect.send({
data: { name: 'zangsan' },
success: function () {
console.log('handling success')
},
fail: function (data, code) {
console.log('handling fail')
},
})复制代码
connect.sendFile(OBJECT)
发送数据到手机 App 端
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| uri | 否 | String | 目录的 uri |
| success | 否 | Function | 成功回调 |
| fail | 否 | Function | 失败回调 |
success 返回值:
无
fail 返回值:
| 错误码 | 说明 |
|---|---|
| 1006 | 连接断开 |
示例：
connect.sendFile({
uri: 'internal://files/work/demo',
success: function () {
console.log('handling success')
},
fail: function (data, code) {
console.log('handling fail')
},
})复制代码
connect.close(OBJECT)
关闭当前连接
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
示例：
connect.close({
success() {
console.log(`close success`)
},
fail(data, code) {
console.log(`handling fail, code = ${code}`)
},
})复制代码
connect.onMessage(OBJECT)
接收手机 App 端数据
参数：
| 属性 | 必填 | 类型 | 说明 |
|---|---|---|---|
| callback | 否 | Function | 接收手机 App 端数据回调 |
callback 参数:
| 属性 | 类型 | 说明 |
|---|---|---|
| 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)
}
}复制代码