npm 包 unifi-hotspot 使用教程

阅读时长 5 分钟读完

简介

Npm 包 unifi-hotspot 是一个用于管理 UniFi 热点的 JavaScript 库,它可以通过代码调用 UniFi 控制器 API 来实现创建、修改和删除热点等操作。本文将详细介绍 unifi-hotspot 的使用方法,包括安装、配置、创建热点等,帮助读者快速上手并学会使用该库。

安装

使用 unifi-hotspot 首先需要在 Node.js 环境中安装该 npm 包。可以通过以下命令完成安装:

配置

在使用 unifi-hotspot 之前,需要通过 config 对象配置 UniFi 控制器的 IP、用户名、密码等信息。配置示例代码如下:

-- -------------------- ---- -------
----- ----- - -------------------------

----- ------ - -
  -------- --------------------------------------------
  --------- --------
  --------- -----------
  ----- ----------
--

------------------------

其中,baseUrl 指定 UniFi 控制器的地址和端口号,usernamepassword 指定登录控制器的用户名和密码,site 指定站点名称,默认为 default

创建热点

创建热点是 unifi-hotspot 的核心功能之一,可以通过以下示例代码创建一个名为 guest-wifi 的热点:

-- -------------------- ---- -------
----- ---- - --------------------

----- ------- - -
  ----- -------------
  ------------ -----
  ---------- --------
  -------------------- -----
  ------------- --------------------- -----------------------
--

----------------------------- --------
  --------------- -- -
    -------------------- -------- ------------------
  --
  -------------- -- -
    ------------------ -------- -------- -------------------
  ---

上面的代码中,unifi.getSites()[0] 获取到了第一个站点的信息,options 对象定义了热点的配置信息,包括 SSID、VLAN、用户组、围栏等。unifi.createHotspot(site._id, options) 调用了 unifi-hotspot 的创建热点 API,并返回了一个 Promise 对象,可以通过 then()catch() 方法处理创建热点的结果。

更新热点

更新热点是 unifi-hotspot 的另一个重要功能,可以通过以下示例代码修改名为 guest-wifi 的热点的配置信息:

-- -------------------- ---- -------
----- ---- - --------------------

----- --------- - ---------------------------

----- ------- - -
  ------------ ------
  ---------- ---------
--

----------------------------- ---------- --------
  --------------- -- -
    -------------------- -------- ------------------
  --
  -------------- -- -
    ------------------ -------- -------- -------------------
  ---

上面的代码中,hotspotId 指定要更新的热点的 ID,options 对象定义了要修改的配置信息,包括 VLAN 和用户组。unifi.updateHotspot(site._id, hotspotId, options) 调用了 unifi-hotspot 的更新热点 API,并返回了一个 Promise 对象,可以通过 then()catch() 方法处理更新热点的结果。

删除热点

删除热点也是 unifi-hotspot 的一个重要功能,可以通过以下示例代码删除名为 guest-wifi 的热点:

-- -------------------- ---- -------
----- ---- - --------------------

----- --------- - ---------------------------

----------------------------- ----------
  -------- -- -
    -------------------- -------- ---------------
  --
  -------------- -- -
    ------------------ -------- -------- -------------------
  ---

上面的代码中,hotspotId 指定要删除的热点的 ID。unifi.deleteHotspot(site._id, hotspotId) 调用了 unifi-hotspot 的删除热点 API,并返回了一个 Promise 对象,可以通过 then()catch() 方法处理删除热点的结果。

总结

本文简要介绍了 npm 包 unifi-hotspot 的使用方法,包括安装、配置、创建热点、更新热点和删除热点等。通过阅读本文,读者可以快速上手 unifi-hotspot,并在实际项目中使用该库实现 UniFi 热点管理的相关功能。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600572ca81e8991b448e8f8b

纠错
反馈