wx.startLocalServiceDiscovery

wx.startLocalServiceDiscovery(Object object)

2.4.0 新版功能: 低版本需做 兼容处理

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

参数 Object object 属性 类型 默认值 必填 说明 serviceType string 是 要搜索的服务类型 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数(调用成功、失败都会执行)

object.fail 回调函数 参数 Object res 属性 类型 说明 errMsg string 错误信息

res.errMsg 的合法值

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

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

注意

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