Skip to content

mDNS

stopLocalServiceDiscovery

TIP

該API使用方法為: wx.stopLocalServiceDiscovery(Object object)

  • 功能說明: 停止蒐索mDNS服務。

  • 參數及說明: Object object。

    内容類型預設值必填說明
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • object.fail回呼函數參數: Object res。

    内容類型說明
    errMsgstring錯誤資訊,其合法值為task not found:在當前沒有處在蒐索服務中的情况下調用stopLocalServiceDiscovery

startLocalServiceDiscovery

TIP

該API使用方法為: wx.startLocalServiceDiscovery(Object object)

TIP

  • iOS需要接入TMFMiniAppExtMDNS擴展庫才能使用mDNS相關接口。
  • wx.startLocalServiceDiscovery是一個消耗效能的行為,開始30秒後會自動stop並執行 wx.onLocalServiceDiscoveryStop 注册的回呼函數。
  • 在調用wx.startLocalServiceDiscovery後,在這次蒐索行為停止後才能發起下次wx.startLocalServiceDiscovery,停止本次蒐索行為的操作包括調用wx.stopLocalServiceDiscovery和30秒後系統自動stop本次蒐索。
  • 功能說明: 開始蒐索局域網下的mDNS服務。 蒐索的結果會通過wx.onLocalService*事件返回。

  • 參數及說明: Object object。

    内容類型預設值必填說明
    serviceTypestring-要蒐索的服務類型
    successFunction-接口調用成功的回呼函數
    failFunction-接口調用失敗的回呼函數
    completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • object.fail回呼函數參數: Object res。

    内容類型說明
    errMsgstring錯誤資訊,合法值為
    invalid param: serviceType為空
    scan task already exist: 在當前startLocalServiceDiscovery發起的蒐索未停止的情况下,再次調用startLocalServiceDiscovery
  • 示例代碼:

js
wx.startLocalServiceDiscovery({
    // There is a service of type _http._tcp. in the local area network connected to the current mobile phone.
    serviceType: '_http._tcp.',
    success: console.log,
    fail: console.log
})

offLocalServiceResolveFail

TIP

該API使用方法為: wx.offLocalServiceResolveFail(function listener)

  • 功能說明: 移除mDNS服務解析失敗的事件的監聽函數

  • 參數及說明: function listener, onLocalServiceResolveFail傳入的監聽函數。 不傳此參數則移除所有監聽函數。

  • 示例代碼:

js
const listener = function (res) { console.log(res) }

wx.onLocalServiceResolveFail(listener)
wx.offLocalServiceResolveFail(listener)  // Pass the same function object used for listening.

onLocalServiceResolveFail

TIP

該API使用方法為: wx.onLocalServiceResolveFail(function listener)

  • 功能說明: 監聽mDNS服務解析失敗的事件

  • 參數及說明: function listener, mDNS服務解析失敗的事件的監聽函數,參數Object res如下。

    内容類型說明
    serviceTypestring服務的類型
    serviceNamestring服務的名稱

offLocalServiceLost

TIP

該API使用方法為: wx.offLocalServiceLost(function listener)

  • 功能說明: 移除mDNS服務離開的事件的監聽函數。

  • 參數及說明: function listener, onLocalServiceLost傳入的監聽函數,不傳此參數則移除所有監聽函數。

  • 示例代碼:

js
const listener = function (res) { console.log(res) }

wx.onLocalServiceLost(listener)
wx.offLocalServiceLost(listener)  // Pass the same function object used for listening.

onLocalServiceLost

TIP

該API使用方法為: wx.onLocalServiceLost(function listener)

  • 功能說明: 監聽mDNS服務離開的事件。

  • 參數及說明: function listener, mDNS服務離開的事件的監聽函數,參數Object res如下:

    内容類型說明
    serviceTypestring服務的類型
    serviceNamestring服務的名稱

offLocalServiceFound

TIP

該API使用方法為: wx.offLocalServiceFound(function listener)

  • 功能說明: 移除mDNS服務發現的事件的監聽函數。

  • 參數及說明: function listener, onLocalServiceFound傳入的監聽函數,不傳此參數則移除所有監聽函數。

  • 示例代碼:

js
const listener = function (res) { console.log(res) }

wx.onLocalServiceFound(listener)
wx.offLocalServiceFound(listener) // Pass the same function object used for listening.

onLocalServiceFound

TIP

該API使用方法為: wx.onLocalServiceFound(function listener)

  • 功能說明: 監聽mDNS服務發現的事件。

  • 參數及說明: function listener, mDNS服務發現的事件的監聽函數,參數Object res如下:

    内容類型說明
    serviceTypestring服務的類型
    serviceNamestring服務的名稱
    ipstring服務的ip地址
    portnumber服務的埠

offLocalServiceDiscoveryStop

TIP

該API使用方法為: wx.offLocalServiceDiscoveryStop(function listener)

  • 功能說明: 移除mDNS服務停止蒐索的事件的監聽函數。

  • 參數及說明: function listener, onLocalServiceDiscoveryStop傳入的監聽函數。 不傳此參數則移除所有監聽函數。

  • 示例代碼:

js
const listener = function (res) { console.log(res) }

wx.onLocalServiceDiscoveryStop(listener)
wx.offLocalServiceDiscoveryStop(listener) // Pass the same function object used for listening.

onLocalServiceDiscoveryStop

TIP

該API使用方法為: wx.onLocalServiceDiscoveryStop(function listener)

  • 功能說明: 監聽mDNS服務停止蒐索的事件。
  • 參數及說明: function listener, mDNS服務停止蒐索的事件的監聽函數。