bl.startLocalServiceDiscovery
以 Promise 风格 调用:支持
相关文档: 局域网通信
功能描述
开始搜索局域网下的 mDNS 服务。搜索的结果会通过 bl.onLocalService* 事件返回。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| serviceType | string | 是 | 要搜索的服务类型 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.fail 回调函数
参数
Object res
| 属性 | 类型 | 说明 |
|---|---|---|
| errMsg | string | 错误信息 |
| 合法值说明invalid paramserviceType 为空scan task already exist在当前 startLocalServiceDiscovery 发起的搜索未停止的情况下,再次调用 startLocalServiceDiscovery |
示例代码
bl.startLocalServiceDiscovery({
// 当前手机所连的局域网下有一个 _http._tcp. 类型的服务
serviceType: '_http._tcp.',
success: console.log,
fail: console.log
})
注意
- 由于操作系统相关能力变更,iOS bilibili客户端 7.0.18 及以上版本无法使用 mDNS 相关接口,安卓版本不受影响
- bl.startLocalServiceDiscovery 是一个消耗性能的行为,开始 30 秒后会自动 stop 并执行 bl.onLocalServiceDiscoveryStop 注册的回调函数。
- 在调用 bl.startLocalServiceDiscovery 后,在这次搜索行为停止后才能发起下次 bl.startLocalServiceDiscovery。停止本次搜索行为的操作包括调用 bl.stopLocalServiceDiscovery 和 30 秒后系统自动 stop 本次搜索。