feat: update baselib defs to 3.14.3

Author: osmanthuspeace

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 2026-03-13 v3.8.19
+- 更新 API 定义到 3.14.3
+
 ## 2026-02-25 v3.8.18
 - 解决依赖安全问题
 

types/wx/lib.wx.api.d.ts

@@ -1531,7 +1531,7 @@ CustomAd.offClose(listener) // 需传入与监听时同一个的函数对象
 ``` */
         offClose(
             /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
-            listener?: UDPSocketOffCloseCallback
+            listener?: CustomAdOffCloseCallback
         ): void
         /** [CustomAd.offError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/ad/CustomAd.offError.html)
 *
@@ -1601,10 +1601,10 @@ CustomAd.offResize(listener) // 需传入与监听时同一个的函数对象
         ): void
         /** [CustomAd.onClose(function listener)](https://developers.weixin.qq.com/minigame/dev/api/ad/CustomAd.onClose.html)
          *
-         * 监听原生模板广告关闭事件（仅部分可被用户关闭的模板支持）。 */
+         * 监听原生模板广告关闭事件。 */
         onClose(
             /** 原生模板广告关闭事件的监听函数 */
-            listener: UDPSocketOnCloseCallback
+            listener: CustomAdOnCloseCallback
         ): void
         /** [CustomAd.onError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/ad/CustomAd.onError.html)
          *
@@ -13117,7 +13117,7 @@ InterstitialAd.offClose(listener) // 需传入与监听时同一个的函数对
 ``` */
         offClose(
             /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
-            listener?: UDPSocketOffCloseCallback
+            listener?: CustomAdOffCloseCallback
         ): void
         /** [InterstitialAd.offError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/ad/InterstitialAd.offError.html)
 *
@@ -13156,7 +13156,7 @@ InterstitialAd.offLoad(listener) // 需传入与监听时同一个的函数对
          * 监听插屏广告关闭事件。 */
         onClose(
             /** 插屏广告关闭事件的监听函数 */
-            listener: UDPSocketOnCloseCallback
+            listener: CustomAdOnCloseCallback
         ): void
         /** [InterstitialAd.onError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/ad/InterstitialAd.onError.html)
          *
@@ -14141,7 +14141,7 @@ TCPSocket.offClose(listener) // 需传入与监听时同一个的函数对象
 ``` */
         offClose(
             /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
-            listener?: UDPSocketOffCloseCallback
+            listener?: CustomAdOffCloseCallback
         ): void
         /** [TCPSocket.offConnect(function listener)](https://developers.weixin.qq.com/minigame/dev/api/network/tcp/TCPSocket.offConnect.html)
 *
@@ -14205,7 +14205,7 @@ TCPSocket.offMessage(listener) // 需传入与监听时同一个的函数对象
          * 监听一旦 socket 完全关闭就发出该事件 */
         onClose(
             /** 一旦 socket 完全关闭就发出该事件的监听函数 */
-            listener: UDPSocketOnCloseCallback
+            listener: CustomAdOnCloseCallback
         ): void
         /** [TCPSocket.onConnect(function listener)](https://developers.weixin.qq.com/minigame/dev/api/network/tcp/TCPSocket.onConnect.html)
          *
@@ -14261,7 +14261,7 @@ UDPSocket.offClose(listener) // 需传入与监听时同一个的函数对象
 ``` */
         offClose(
             /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
-            listener?: UDPSocketOffCloseCallback
+            listener?: CustomAdOffCloseCallback
         ): void
         /** [UDPSocket.offError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/network/udp/UDPSocket.offError.html)
 *
@@ -14316,7 +14316,7 @@ UDPSocket.offMessage(listener) // 需传入与监听时同一个的函数对象
          * 监听关闭事件 */
         onClose(
             /** 关闭事件的监听函数 */
-            listener: UDPSocketOnCloseCallback
+            listener: CustomAdOnCloseCallback
         ): void
         /** [UDPSocket.onError(function listener)](https://developers.weixin.qq.com/minigame/dev/api/network/udp/UDPSocket.onError.html)
          *
@@ -19915,39 +19915,108 @@ wx.reportScene({
 *
 * 需要基础库： `3.11.2`
 *
-* 发起人脸识别验证，用于对可疑用户进行身份验证和防沉迷检查。该接口会调起微信的人脸识别系统，验证用户身份以确保游戏安全和合规性。
+* 腾讯游戏人脸识别验证功能是基于健康系统防沉迷体系，用于识别疑似未成年人冒用成年人账号游玩游戏的行为，是防止未成年人沉迷网络游戏的一项重要措施。本接口是为开通虚拟支付功能的小游戏开发者提供的，此接口是基于人脸识别的未成年人身份核验接口。本次识别是根据用户在腾讯健康系统中留存的实名信息进行验证，结果将直接返回至开发者。
+*
+* **接口限额**
+*
+* - **后台调用限制**：1000 次/天（每个小程序 AppID）
+* - 超出限额后将返回错误码 2002008（频率控制）
+* - 1天内全部游戏对一个用户只能调起1次人脸识别
+* - 若用户人脸识别通过：7天内不能再被弹出人脸识别
+* - 根据小游戏评级每个月限制使用次数，一旦发现恶意滥用接口，会取消使用资格。具体使用次数如下：
+*   - S级：300次/月
+*   - A级：100次/月
+*   - B级：30次/月
 *
 * **处理流程**
 *
-* 1. 开发者调用 `wx.requestFacialRecognition` 发起人脸识别。
-* 2. 系统根据策略判定是否需要展示授权弹窗。
-*    - 若判定为"不展示弹窗"：立即回调结果，示例：`{ errCode: 0, errMsg: '本用户7天内人脸识别已通过' }`
-*    - 若判定为"需展示弹窗"：进入步骤 3。
-* 3. 系统展示授权弹窗。
-*    - 玩家拒绝：立即回调 `fail`，`errCode = 2002006`
-*    - 玩家同意：进入步骤 4。
-* 4. 系统开始进行人脸识别验证
-*    - 玩家在跳转页面中完成活体/人脸识别；关闭页面返回游戏。
-* 5. 系统回调最终识别结果返回
+* <img src="https://mmgame.qpic.cn/image/2034b86e1e8f3541629d4b4d16cf41ff84fd99efe25f4fac181603edd8a29e14/0" width="600" alt="人脸识别流程图" />
 *
 * **示例代码**
 *
 * ```js
-wx.requestFacialRecognition({
-  success(res) {
-    // 人脸识别通过或 7 天内已通过
-    // 形如：{ errCode: 0, errMsg: 'ok' }
-    console.log('requestFacialRecognition success:', res)
-  },
-  fail(err) {
-    // 失败或受限等场景
-    console.log('requestFacialRecognition fail:', err)
-  },
-  complete(res) {
-    // 无论成功失败均会触发
-    console.log('requestFacialRecognition complete:', res)
-  }
-})
+// 实际业务场景：防沉迷身份验证
+function checkUserIdentity() {
+  wx.requestFacialRecognition({
+    success(res) {
+      // 场景 1：本次人脸识别通过
+      // res = { errCode: 0, errMsg: 'ok' }
+      console.log('人脸识别成功:', res)
+      // 允许继续游戏
+      startGame()
+    },
+    fail(err) {
+      console.error('人脸识别失败:', err)
+
+      let tipMessage = ''
+      let shouldBlock = false  // 是否需要阻断游戏
+
+      // 根据错误码进行不同处理
+      switch (err.errCode) {
+        case 2002004:
+          // 人脸识别失败（需要阻断）
+          // err = { errCode: 2002004, errMsg: '人脸识别失败' }
+          tipMessage = '识别失败，请稍后重试'
+          shouldBlock = true
+          break
+
+        case 2002006:
+          // 用户取消/超时/不同意，导致未完成人脸识别（需要阻断）
+          // err = { errCode: 2002006, errMsg: '用户取消' }
+          tipMessage = '您已取消验证，无法继续游戏'
+          shouldBlock = true
+          break
+
+        case 2002007:
+          // 本用户7天内人脸识别已通过（可以继续游戏）
+          // err = { errCode: 2002007, errMsg: '本用户7天内人脸识别已通过，通过日期为2024-01-15' }
+          tipMessage = '您已完成验证'
+          shouldBlock = false
+          break
+
+        case 2002008:
+          // 频率控制：本日已调起过人脸识别 or 本月调用次数已达上限（可以继续游戏）
+          // err = { errCode: 2002008, errMsg: '本日已调起过人脸识别' }
+          // 或 err = { errCode: 2002008, errMsg: '本月调用次数已达上限' }
+          tipMessage = '今日验证次数已达上限'
+          shouldBlock = false
+          break
+
+        case 2002009:
+          // 无权限发起人脸识别（可以继续游戏）
+          // err = { errCode: 2002009, errMsg: '无权限发起人脸识别' }
+          tipMessage = '暂无权限使用此功能'
+          shouldBlock = false
+          break
+
+        default:
+          // 系统异常等其他错误（可以继续游戏，避免影响正常用户）
+          tipMessage = '系统异常，请稍后重试'
+          shouldBlock = false
+      }
+
+      if (tipMessage) {
+        wx.showModal({
+          title: '提示',
+          content: tipMessage,
+          showCancel: false
+        })
+      }
+
+      if (shouldBlock) {
+        // 仅对识别失败(2002004)和用户取消(2002006)阻断游戏
+        restrictGameFeatures()
+      } else {
+        // 其他情况允许继续游戏
+        startGame()
+      }
+    },
+    complete(res) {
+      // 无论成功失败均会触发
+      console.log('人脸识别流程结束:', res)
+    }
+  })
+}
 ``` */
         requestFacialRecognition(option?: RequestFacialRecognitionOption): void
         /** [wx.requestMidasFriendPayment(Object object)](https://developers.weixin.qq.com/minigame/dev/api/midas-payment/wx.requestMidasFriendPayment.html)
@@ -21379,10 +21448,13 @@ wx.writeBLECharacteristicValue({
     type CreateRoomSuccessCallback = (
         result: CreateRoomSuccessCallbackResult
     ) => void
+    /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
+    type CustomAdOffCloseCallback = (res: GeneralCallbackResult) => void
     /** onError 传入的监听函数。不传此参数则移除所有监听函数。 */
     type CustomAdOffErrorCallback = (
         result: CustomAdOnErrorListenerResult
     ) => void
+    type CustomAdOnCloseCallback = (res: GeneralCallbackResult) => void
     /** 原生模板广告错误事件的监听函数 */
     type CustomAdOnErrorCallback = (
         result: CustomAdOnErrorListenerResult
@@ -23588,15 +23660,12 @@ wx.writeBLECharacteristicValue({
     type TruncateFailCallback = (res: FileError) => void
     /** 接口调用成功的回调函数 */
     type TruncateSuccessCallback = (res: FileError) => void
-    /** onClose 传入的监听函数。不传此参数则移除所有监听函数。 */
-    type UDPSocketOffCloseCallback = (res: GeneralCallbackResult) => void
     /** onError 传入的监听函数。不传此参数则移除所有监听函数。 */
     type UDPSocketOffErrorCallback = (result: GeneralCallbackResult) => void
     /** onMessage 传入的监听函数。不传此参数则移除所有监听函数。 */
     type UDPSocketOffMessageCallback = (
         result: UDPSocketOnMessageListenerResult
     ) => void
-    type UDPSocketOnCloseCallback = (res: GeneralCallbackResult) => void
     type UDPSocketOnErrorCallback = (result: GeneralCallbackResult) => void
     /** 收到消息的事件的监听函数 */
     type UDPSocketOnMessageCallback = (