wx.startLocalServiceDiscovery(Object object)

基础库 2.4.0 开始支持,低版本需做兼容处理

本接口从基础库版本 2.15.0 起支持在小程序插件中使用

开始搜索局域网下的 mDNS 服务。搜索的结果会通过 wx.onLocalService* 事件返回。

参数

Object object

属性类型默认值必填说明
serviceTypestring要搜索的服务类型
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.fail 回调函数

参数
Object res
属性类型说明
errMsgstring错误信息

res.errMsg 的合法值

说明最低版本
invalid paramserviceType 为空
scan task already exist在当前 startLocalServiceDiscovery 发起的搜索未停止的情况下,再次调用 startLocalServiceDiscovery

示例代码

  1. wx.startLocalServiceDiscovery({
  2. // 当前手机所连的局域网下有一个 _http._tcp. 类型的服务
  3. serviceType: '_http._tcp.',
  4. success: console.log,
  5. fail: console.log
  6. })

注意

  1. wx.startLocalServiceDiscovery 是一个消耗性能的行为,开始 30 秒后会自动 stop 并执行 wx.onLocalServiceDiscoveryStop 注册的回调函数。
  2. 在调用 wx.startLocalServiceDiscovery 后,在这次搜索行为停止后才能发起下次 wx.startLocalServiceDiscovery。停止本次搜索行为的操作包括调用 wx.stopLocalServiceDiscovery 和 30 秒后系统自动 stop 本次搜索。