微信小程序API mDNS

2022-05-11 16:18 更新

wx.stopLocalServiceDiscovery(Object object)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

停止搜索 mDNS 服務(wù)

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

object.fail 回調(diào)函數(shù)

參數(shù)
Object res
屬性 類型 說明
errMsg string 錯誤信息

res.errMsg 的合法值

說明 最低版本
task not found 在當(dāng)前沒有處在搜索服務(wù)中的情況下調(diào)用 stopLocalServiceDiscovery

wx.startLocalServiceDiscovery(Object object)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

開始搜索局域網(wǎng)下的 mDNS 服務(wù)。搜索的結(jié)果會通過 wx.onLocalService* 事件返回。

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
serviceType string 要搜索的服務(wù)類型
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

object.fail 回調(diào)函數(shù)

參數(shù)
Object res
屬性 類型 說明
errMsg string 錯誤信息

res.errMsg 的合法值

說明 最低版本
invalid param serviceType 為空
scan task already exist 在當(dāng)前 startLocalServiceDiscovery 發(fā)起的搜索未停止的情況下,再次調(diào)用 startLocalServiceDiscovery

示例代碼


    wx.startLocalServiceDiscovery({
      // 當(dāng)前手機所連的局域網(wǎng)下有一個 _http._tcp. 類型的服務(wù)
      serviceType: '_http._tcp.',
      success: console.log,
      fail: console.log
    })

注意

  1. wx.startLocalServiceDiscovery 是一個消耗性能的行為,開始 30 秒后會自動 stop 并執(zhí)行 wx.onLocalServiceDiscoveryStop 注冊的回調(diào)函數(shù)。
  2. 在調(diào)用 wx.startLocalServiceDiscovery 后,在這次搜索行為停止后才能發(fā)起下次 wx.startLocalServiceDiscovery。停止本次搜索行為的操作包括調(diào)用 wx.stopLocalServiceDiscovery 和 30 秒后系統(tǒng)自動 stop 本次搜索。

wx.onLocalServiceResolveFail(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

監(jiān)聽 mDNS 服務(wù)解析失敗的事件

參數(shù)

function callback

mDNS 服務(wù)解析失敗的事件的回調(diào)函數(shù)

參數(shù)

Object res
屬性 類型 說明
serviceType string 服務(wù)的類型
serviceName string 服務(wù)的名稱

wx.onLocalServiceLost(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理

監(jiān)聽 mDNS 服務(wù)離開的事件

參數(shù)

function callback

mDNS 服務(wù)離開的事件的回調(diào)函數(shù)

參數(shù)

Object res
屬性 類型 說明
serviceType string 服務(wù)的類型
serviceName string 服務(wù)的名稱

wx.onLocalServiceFound(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理

監(jiān)聽 mDNS 服務(wù)發(fā)現(xiàn)的事件

參數(shù)

function callback

mDNS 服務(wù)發(fā)現(xiàn)的事件的回調(diào)函數(shù)

參數(shù)

Object res
屬性 類型 說明
serviceType string 服務(wù)的類型
serviceName string 服務(wù)的名稱
ip string 服務(wù)的 ip 地址
port number 服務(wù)的端口

wx.onLocalServiceDiscoveryStop(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

監(jiān)聽 mDNS 服務(wù)停止搜索的事件

參數(shù)

function callback

mDNS 服務(wù)停止搜索的事件的回調(diào)函數(shù)


wx.offLocalServiceResolveFail(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

取消監(jiān)聽 mDNS 服務(wù)解析失敗的事件

參數(shù)

function callback

mDNS 服務(wù)解析失敗的事件的回調(diào)函數(shù)


wx.offLocalServiceLost(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

取消監(jiān)聽 mDNS 服務(wù)離開的事件

參數(shù)

function callback

mDNS 服務(wù)離開的事件的回調(diào)函數(shù)


wx.offLocalServiceFound(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

取消監(jiān)聽 mDNS 服務(wù)發(fā)現(xiàn)的事件

參數(shù)

function callback

mDNS 服務(wù)發(fā)現(xiàn)的事件的回調(diào)函數(shù)


wx.offLocalServiceDiscoveryStop(function callback)

基礎(chǔ)庫 2.4.0 開始支持,低版本需做兼容處理。

取消監(jiān)聽 mDNS 服務(wù)停止搜索的事件

參數(shù)

function callback

mDNS 服務(wù)停止搜索的事件的回調(diào)函數(shù)


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號