@tarojs/taro 3.8.0-canary.0 → 4.0.0-alpha.2

package/types/api/data-analysis/index.d.ts

@@ -1,6 +1,33 @@
 import Taro from '../../index'
 
 declare module '../../index' {
+  namespace getCommonConfig {
+    interface Option {
+      /** 需要获取的数据指标的对象数组，每个string的格式约定：配置类型_分表key */
+      keys?: string[]
+      /** 0：通用配置模式 1：实验模式, 参数与返回结果的使用等效于接口wx.getExptInfoSync */
+      mode: 0 | 1
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: SuccessCallbackResult) => void
+    }
+    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误码 */
+      errcode: number
+      /** 错误信息 */
+      errmsg: string
+      /** 配置类型, 1-表类型 2-kv类型 */
+      conf_type: number
+      /** 根据conf_type来确定conf内容, conf_type为1时conf是一个json数组, 类似"[{xxx},{xxx}]", 每一项对应表类型每一行配置内容, 其中conf_type为2时conf是一个json对象，类似"{xxxx}" */
+      conf: string
+      /** 过期时间,单位秒. 0表示当次有效 */
+      expire_sec: number
+    }
+  }
+
   interface TaroStatic {
     /** 自定义业务数据监控上报接口。
      *
@@ -21,7 +48,7 @@ declare module '../../index' {
     ): void
 
     /** 自定义分析数据上报接口。使用前，需要在小程序管理后台自定义分析中新建事件，配置好事件名与字段。
-     * @supported weapp, tt
+     * @supported weapp, swan, tt
      * @example
      * ```tsx
      * Taro.reportAnalytics('purchase', {
@@ -68,5 +95,28 @@ declare module '../../index' {
       /** 实验参数数组，不填则获取所有实验参数 */
       keys?: Array<string>
     ): TaroGeneral.IAnyObject
+
+    /** 给定实验参数数组，获取对应的实验参数值
+     * @supported weapp
+     * @example
+     * ```tsx
+     * Taro.getCommonConfig({
+     *   keys:["key1", "key2"],
+     *   mode: 0,
+     *   success: (res) => {
+     *     console.log("success")
+     *     console.log(res)
+     *   },
+     *   fail: (res) => {
+     *     console.log("fail")
+     *     console.log(res)
+     *   }
+     * })
+     * ```
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/data-analysis/wx.getCommonConfig.html
+     */
+    getCommonConfig(
+      option: getCommonConfig.Option
+    ): Promise<getCommonConfig.SuccessCallbackResult>
   }
 }

package/types/api/device/accelerometer.d.ts

@@ -56,7 +56,7 @@ declare module '../../index' {
      * ```tsx
      * Taro.startAccelerometer({ interval: 'game' })
      * ```
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.startAccelerometer.html
      */
     startAccelerometer (res?: startAccelerometer.Option): Promise<TaroGeneral.CallbackResult>
@@ -67,14 +67,14 @@ declare module '../../index' {
      * ```tsx
      * Taro.stopAccelerometer()
      * ```
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.stopAccelerometer.html
      */
     stopAccelerometer (res?: stopAccelerometer.Option): Promise<TaroGeneral.CallbackResult>
 
     /**
      * 监听加速度数据，频率：5次/秒，接口调用后会自动开始监听，可使用 `Taro.stopAccelerometer` 停止监听。
-     * @supported weapp, h5, rn, tt
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony
      * @example
      * ```tsx
      * Taro.onAccelerometerChange(res => {
@@ -85,16 +85,18 @@ declare module '../../index' {
      * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.onAccelerometerChange.html
      */
-    onAccelerometerChange (callback: onAccelerometerChange.Callback): void
+    onAccelerometerChange(
+      callback: onAccelerometerChange.Callback
+    ): void
 
     /**
      * 取消监听加速度数据事件，参数为空，则取消所有的事件监听。
-     * @supported weapp, h5, rn
+     * @supported weapp, alipay, swan, jd, tt, h5, rn, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accelerometer/wx.offAccelerometerChange.html
      */
     offAccelerometerChange(
       /** 加速度数据事件的回调函数 */
-      callback?: (...args: any[]) => any,
+      callback?: onAccelerometerChange.Callback
     ): void
   }
 }

package/types/api/device/accessibility.d.ts

@@ -18,7 +18,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 检测是否开启视觉无障碍功能。
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/accessibility/wx.checkIsOpenAccessibility.html
      */
     checkIsOpenAccessibility(option: checkIsOpenAccessibility.Option): Promise<TaroGeneral.CallbackResult>

package/types/api/device/battery.d.ts

@@ -6,7 +6,7 @@ declare module '../../index' {
       /** 是否正在充电中 */
       isCharging: boolean
       /** 设备电量，范围 1 - 100 */
-      level: string
+      level: number
     }
   }
 
@@ -32,13 +32,13 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** Taro.getBatteryInfo 的同步版本
-     * @supported weapp
+     * @supported weapp, alipay, swan, jd, qq, harmony
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/battery/wx.getBatteryInfoSync.html
      */
     getBatteryInfoSync(): getBatteryInfoSync.Result
 
     /** 获取设备电量。同步 API Taro.getBatteryInfoSync 在 iOS 上不可用。
-     * @supported weapp, h5
+     * @supported weapp, alipay, swan, jd, qq, h5, harmony, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/battery/wx.getBatteryInfo.html
      */
     getBatteryInfo(option?: getBatteryInfo.Option): Promise<getBatteryInfo.SuccessCallbackResult>

package/types/api/device/bluetooth-ble.d.ts

@@ -15,6 +15,8 @@ declare module '../../index' {
       serviceId: string
       /** 蓝牙设备特征值对应的二进制值 */
       value: ArrayBuffer
+      /** 蓝牙特征值的写模式设置，有两种模式，iOS 优先 write，安卓优先 writeNoResponse 。（基础库 2.22.0 开始支持） */
+      writeType?: keyof WriteType
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.BluetoothError) => void
       /** 接口调用失败的回调函数 */
@@ -22,6 +24,12 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.BluetoothError) => void
     }
+    interface WriteType {
+      /** 强制回复写，不支持时报错 */
+      write
+      /** 强制无回复写，不支持时报错 */
+      writeNoResponse
+    }
   }
 
   namespace setBLEMTU {
@@ -122,6 +130,10 @@ declare module '../../index' {
       serviceId: string
       /** 是否启用 notify */
       state: boolean
+      /** 设置特征订阅类型，有效值有 notification 和 indication
+       * @default "indication"
+       */
+      type?: keyof Type
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.BluetoothError) => void
       /** 接口调用失败的回调函数 */
@@ -129,6 +141,10 @@ declare module '../../index' {
       /** 接口调用成功的回调函数 */
       success?: (res: TaroGeneral.BluetoothError) => void
     }
+    interface Type {
+      notification
+      indication
+    }
   }
 
   namespace getBLEMTU {
@@ -138,7 +154,7 @@ declare module '../../index' {
       /** 写模式 （iOS 特有参数）
        * @default "write"
        */
-      writeType: keyof WriteType
+      writeType?: keyof WriteType
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.BluetoothError) => void
       /** 接口调用失败的回调函数 */
@@ -244,6 +260,10 @@ declare module '../../index' {
       read: boolean
       /** 该特征值是否支持 write 操作 */
       write: boolean
+      /** 该特征是否支持无回复写操作 */
+      writeNoResponse: boolean
+      /** 该特征是否支持有回复写操作 */
+      writeDefault: boolean
     }
   }
 
@@ -291,7 +311,7 @@ declare module '../../index' {
      * - 小程序不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小，超过最大字节数后会发生写入错误，建议每次写入不超过20字节。
      * - 若单次写入数据过长，iOS 上存在系统不会有任何回调的情况（包括错误回调）。
      * - 安卓平台上，在调用 `notifyBLECharacteristicValueChange` 成功后立即调用 `writeBLECharacteristicValue` 接口，在部分机型上会发生 10008 系统错误
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * // 向蓝牙设备发送一个0x00的16进制数据
@@ -319,7 +339,10 @@ declare module '../../index' {
     ): Promise<writeBLECharacteristicValue.Promised>
 
     /** 协商设置蓝牙低功耗的最大传输单元 (Maximum Transmission Unit, MTU)
-     * @supported weapp
+     *
+     * - 需在 Taro.createBLEConnection 调用成功后调用
+     * - 仅安卓系统 5.1 以上版本有效，iOS 因系统限制不支持。
+     * @supported weapp, alipay, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-ble/wx.setBLEMTU.html
      */
     setBLEMTU(
@@ -331,7 +354,7 @@ declare module '../../index' {
      * **注意**
      * - 并行调用多次会存在读失败的可能性。
      * - 接口读取到的信息需要在 `onBLECharacteristicValueChange` 方法注册的回调中获取。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * // 必须在这里的回调才能获取
@@ -372,7 +395,7 @@ declare module '../../index' {
     ): void
 
     /** 监听低功耗蓝牙连接状态的改变事件。包括开发者主动连接或断开连接，设备丢失，连接异常断开等等
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.onBLEConnectionStateChange(function (res) {
@@ -388,7 +411,7 @@ declare module '../../index' {
     ): void
 
     /** 监听低功耗蓝牙设备的特征值变化事件。必须先启用 `notifyBLECharacteristicValueChange` 接口才能接收到设备推送的 notification。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * // ArrayBuffer转16进制字符串示例
@@ -419,20 +442,20 @@ declare module '../../index' {
      */
     offBLEMTUChange(
       /** 蓝牙低功耗的最大传输单元变化事件的回调函数 */
-      callback: onBLEMTUChange.Callback,
+      callback?: onBLEMTUChange.Callback,
     ): void
 
     /** 取消监听蓝牙低功耗连接状态的改变事件
-     * @supported weapp
+     * @supported weapp, alipay
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-ble/wx.offBLEConnectionStateChange.html
      */
     offBLEConnectionStateChange(
       /** 蓝牙低功耗连接状态的改变事件的回调函数 */
-      callback: onBLEConnectionStateChange.Callback,
+      callback?: onBLEConnectionStateChange.Callback,
     ): void
 
     /** 取消监听蓝牙低功耗设备的特征值变化事件
-     * @supported weapp
+     * @supported weapp, alipay
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-ble/wx.offBLECharacteristicValueChange.html
      */
     offBLECharacteristicValueChange(
@@ -447,7 +470,7 @@ declare module '../../index' {
      * **注意**
      * - 订阅操作成功后需要设备主动更新特征值的 value，才会触发 Taro.onBLECharacteristicValueChange 回调。
      * - 安卓平台上，在调用 `notifyBLECharacteristicValueChange` 成功后立即调用 `writeBLECharacteristicValue` 接口，在部分机型上会发生 10008 系统错误
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.notifyBLECharacteristicValueChange({
@@ -474,7 +497,7 @@ declare module '../../index' {
      * 注意:
      *  - 小程序中 MTU 为 ATT_MTU，包含 Op-Code 和 Attribute Handle 的长度，实际可以传输的数据长度为 ATT_MTU - 3
      *  - iOS 系统中 MTU 为固定值；安卓系统中，MTU 会在系统协商成功之后发生改变，建议使用 [Taro.onBLEMTUChange](/docs/apis/device/bluetooth-ble/onBLEMTUChange) 监听。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.getBLEMTU({
@@ -492,7 +515,7 @@ declare module '../../index' {
     ): Promise<getBLEMTU.SuccessCallbackResult>
 
     /** 获取蓝牙设备所有服务(service)。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.getBLEDeviceServices({
@@ -510,7 +533,7 @@ declare module '../../index' {
     ): Promise<getBLEDeviceServices.SuccessCallbackResult>
 
     /** 获取蓝牙低功耗设备的信号强度 (Received Signal Strength Indication, RSSI)。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-ble/wx.getBLEDeviceRSSI.html
      */
     getBLEDeviceRSSI(
@@ -518,7 +541,7 @@ declare module '../../index' {
     ): Promise<getBLEDeviceRSSI.SuccessCallbackResult>
 
     /** 获取蓝牙设备某个服务中所有特征值(characteristic)。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.getBLEDeviceCharacteristics({
@@ -545,7 +568,7 @@ declare module '../../index' {
      * - 请保证尽量成对的调用 `createBLEConnection` 和 `closeBLEConnection` 接口。安卓如果多次调用 `createBLEConnection` 创建连接，有可能导致系统持有同一设备多个连接的实例，导致调用 `closeBLEConnection` 的时候并不能真正的断开与设备的连接。
      * - 蓝牙连接随时可能断开，建议监听 Taro.onBLEConnectionStateChange 回调事件，当蓝牙设备断开时按需执行重连操作
      * - 若对未连接的设备或已断开连接的设备调用数据读写操作的接口，会返回 10006 错误，建议进行重连操作。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.createBLEConnection({
@@ -561,7 +584,7 @@ declare module '../../index' {
     createBLEConnection(option: createBLEConnection.Option): Promise<createBLEConnection.Promised>
 
     /** 断开与低功耗蓝牙设备的连接。
-     * @supported weapp
+     * @supported weapp, alipay, jd
      * @example
      * ```tsx
      * Taro.closeBLEConnection({

package/types/api/device/bluetooth-peripheral.d.ts

@@ -13,7 +13,7 @@ declare module '../../index' {
       /** server 的 UUID */
       serverId: string
       /** 连接目前状态 */
-      connected: string
+      connected: boolean
     }
   }
 
@@ -38,7 +38,7 @@ declare module '../../index' {
    */
   interface BLEPeripheralServer {
     /** 添加服务
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.addService.html
      */
     addService(option: BLEPeripheralServer.addService.Option): Promise<TaroGeneral.BluetoothError>
@@ -48,20 +48,20 @@ declare module '../../index' {
      */
     close(option: BLEPeripheralServer.close.Option): Promise<TaroGeneral.BluetoothError>
     /** 取消监听已连接的设备请求读当前外围设备的特征值事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicReadRequest.html
      */
     offCharacteristicReadRequest(
       /** 已连接的设备请求读当前外围设备的特征值事件的回调函数 */
-      callback: BLEPeripheralServer.onCharacteristicReadRequest.Callback,
+      callback?: BLEPeripheralServer.onCharacteristicReadRequest.Callback,
     ): void
     /** 取消监听特征订阅事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicSubscribed.html
      */
     offCharacteristicSubscribed(
       /** 特征订阅事件的回调函数 */
-      callback: BLEPeripheralServer.onCharacteristicSubscribed.Callback,
+      callback?: BLEPeripheralServer.onCharacteristicSubscribed.Callback,
     ): void
     /** 取消监听取消特征订阅事件
      * @supported weapp
@@ -69,20 +69,20 @@ declare module '../../index' {
      */
     offCharacteristicUnsubscribed(
       /** 取消特征订阅事件的回调函数 */
-      callback: BLEPeripheralServer.onCharacteristicUnsubscribed.Callback,
+      callback?: BLEPeripheralServer.onCharacteristicUnsubscribed.Callback,
     ): void
     /** 取消监听已连接的设备请求写当前外围设备的特征值事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicWriteRequest.html
      */
     offCharacteristicWriteRequest(
       /** 已连接的设备请求写当前外围设备的特征值事件的回调函数 */
-      callback: BLEPeripheralServer.onCharacteristicWriteRequest.Callback,
+      callback?: BLEPeripheralServer.onCharacteristicWriteRequest.Callback,
     ): void
     /** 监听已连接的设备请求读当前外围设备的特征值事件
      *
      * 收到该消息后需要立刻调用 [writeCharacteristicValue](/docs/apis/device/bluetooth-peripheral/BLEPeripheralServer#writecharacteristicvalue) 写回数据，否则主机不会收到响应。
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicReadRequest.html
      */
     onCharacteristicReadRequest(
@@ -90,7 +90,7 @@ declare module '../../index' {
       callback: BLEPeripheralServer.onCharacteristicReadRequest.Callback,
     ): void
     /** 监听特征订阅事件，仅 iOS 支持
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicSubscribed.html
      */
     onCharacteristicSubscribed(
@@ -98,7 +98,7 @@ declare module '../../index' {
       callback: BLEPeripheralServer.onCharacteristicSubscribed.Callback,
     ): void
     /** 监听取消特征订阅事件，仅 iOS 支持
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicUnsubscribed.html
      */
     onCharacteristicUnsubscribed(
@@ -106,7 +106,7 @@ declare module '../../index' {
       callback: BLEPeripheralServer.onCharacteristicUnsubscribed.Callback,
     ): void
     /** 监听已连接的设备请求写当前外围设备的特征值事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicWriteRequest.html
      */
     onCharacteristicWriteRequest(
@@ -114,22 +114,22 @@ declare module '../../index' {
       callback: BLEPeripheralServer.onCharacteristicWriteRequest.Callback,
     ): void
     /** 移除服务
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.removeService.html
      */
     removeService(option: BLEPeripheralServer.removeService.Option): Promise<TaroGeneral.BluetoothError>
     /** 开始广播本地创建的外围设备
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.startAdvertising.html
      */
     startAdvertising(option: BLEPeripheralServer.startAdvertising.Option): Promise<TaroGeneral.BluetoothError>
     /** 停止广播
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.stopAdvertising.html
      */
     stopAdvertising(option: BLEPeripheralServer.stopAdvertising.Option): Promise<TaroGeneral.BluetoothError>
     /** 往指定特征写入二进制数据值，并通知已连接的主机，从机的特征值已发生变化，该接口会处理是走回包还是走订阅
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.writeCharacteristicValue.html
      */
     writeCharacteristicValue(option: BLEPeripheralServer.writeCharacteristicValue.Option): Promise<TaroGeneral.BluetoothError>
@@ -157,13 +157,13 @@ declare module '../../index' {
         /** characteristic 的 UUID */
         uuid: string
         /** 特征支持的操作 */
-        properties: properties
+        properties?: properties
         /** 特征权限 */
-        permission: characteristicPermission
+        permission?: characteristicPermission
         /** 特征对应的二进制值 */
-        value: ArrayBuffer
+        value?: ArrayBuffer
         /** 描述符数据 */
-        descriptors: descriptor[]
+        descriptors?: descriptor[]
       }
       /** 特征支持的操作 */
       interface properties {
@@ -212,7 +212,7 @@ declare module '../../index' {
         /** Descriptor 的 UUID */
         uuid: string
         /** 描述符的权限 */
-        permission: descriptorPermission
+        permission?: descriptorPermission
         /** 描述符数据 */
         value: ArrayBuffer
       }
@@ -402,7 +402,7 @@ declare module '../../index' {
 
   interface TaroStatic {
     /** 监听当前外围设备被连接或断开连接事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/wx.onBLEPeripheralConnectionStateChanged.html
      */
     onBLEPeripheralConnectionStateChanged(
@@ -411,16 +411,16 @@ declare module '../../index' {
     ): void
 
     /** 取消监听当前外围设备被连接或断开连接事件
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/wx.offBLEPeripheralConnectionStateChanged.html
      */
      offBLEPeripheralConnectionStateChanged(
       /** 当前外围设备被连接或断开连接事件的回调函数 */
-      callback: onBLEPeripheralConnectionStateChanged.Callback,
+      callback?: onBLEPeripheralConnectionStateChanged.Callback,
     ): void
 
     /** 建立本地作为蓝牙低功耗外围设备的服务端，可创建多个
-     * @supported weapp
+     * @supported weapp, jd
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth-peripheral/wx.createBLEPeripheralServer.html
      */
      createBLEPeripheralServer(