@tarojs/taro-h5 3.4.0-beta.0 → 3.4.0

package/src/api/canvas/canvasToTempFilePath.ts

@@ -0,0 +1,24 @@
+import Taro from '@tarojs/api'
+import { findDOM } from '../utils'
+import { MethodHandler } from '../utils/handler'
+
+/**
+ * 把当前画布指定区域的内容导出生成指定大小的图片。在 draw() 回调里调用该方法才能保证图片导出成功。
+ * @todo 暂未支持尺寸相关功能
+ */
+export const canvasToTempFilePath: typeof Taro.canvasToTempFilePath = ({ canvasId, fileType, quality, success, fail, complete }, inst) => {
+  const handle = new MethodHandler({ name: 'canvasToTempFilePath', success, fail, complete })
+  const el = findDOM(inst) as HTMLElement
+  const canvas = el?.querySelector(`canvas[canvas-id="${canvasId}"]`) as HTMLCanvasElement
+
+  try {
+    const dataURL = canvas?.toDataURL(`image/${fileType || 'png'}`, quality)
+    return handle.success({
+      tempFilePath: dataURL
+    })
+  } catch (e) {
+    return handle.fail({
+      errMsg: e.message
+    })
+  }
+}

package/src/api/canvas/createCanvasContext.ts

@@ -0,0 +1,18 @@
+import Taro from '@tarojs/api'
+import { findDOM } from '../utils'
+import { CanvasContext } from './CanvasContext'
+
+/**
+ * 创建 canvas 的绘图上下文 CanvasContext 对象
+ */
+export const createCanvasContext: typeof Taro.createCanvasContext = (canvasId, inst) => {
+  const el = findDOM(inst) as HTMLElement
+  const canvas = el?.querySelector(`canvas[canvas-id="${canvasId}"]`) as HTMLCanvasElement
+  const ctx = canvas?.getContext('2d') as CanvasRenderingContext2D
+  const context = new CanvasContext(canvas, ctx)
+  if (!ctx) return context
+  context.canvas = canvas
+  context.ctx = ctx
+
+  return context
+}

package/src/api/canvas/index.ts

@@ -0,0 +1,10 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 画布
+export const createOffscreenCanvas = temporarilyNotSupport('createOffscreenCanvas')
+export * from './createCanvasContext'
+export * from './canvasToTempFilePath'
+export * from './canvasPutImageData'
+export * from './canvasGetImageData'
+
+export const drawCanvas = temporarilyNotSupport('drawCanvas')

package/src/api/cloud/index.ts

@@ -0,0 +1,27 @@
+import Taro from '@tarojs/api'
+import { temporarilyNotSupport } from '../utils'
+
+export class cloud implements Taro.cloud {
+  Cloud: new (options: Taro.cloud.IOptions) => Taro.Cloud
+
+  init = temporarilyNotSupport('cloud.init')
+
+  CloudID = temporarilyNotSupport('cloud.CloudID')
+
+  callFunction = temporarilyNotSupport('cloud.callFunction')
+
+  // @ts-ignore
+  uploadFile = temporarilyNotSupport('cloud.uploadFile')
+
+  // @ts-ignore
+  downloadFile = temporarilyNotSupport('cloud.downloadFile')
+
+  getTempFileURL = temporarilyNotSupport('cloud.getTempFileURL')
+
+  deleteFile = temporarilyNotSupport('cloud.deleteFile')
+
+  // @ts-ignore
+  database = temporarilyNotSupport('cloud.database')
+
+  callContainer = temporarilyNotSupport('cloud.callContainer')
+}

package/src/api/data-analysis/index.ts

@@ -0,0 +1,6 @@
+import { temporarilyNotSupport } from '../utils'
+
+export const reportMonitor = temporarilyNotSupport('reportMonitor')
+export const reportAnalytics = temporarilyNotSupport('reportAnalytics')
+export const reportEvent = temporarilyNotSupport('reportEvent')
+export const getExptInfoSync = temporarilyNotSupport('getExptInfoSync')

package/src/api/device/accelerometer.ts

@@ -0,0 +1,87 @@
+import Taro from '@tarojs/api'
+import { CallbackManager, MethodHandler } from '../utils/handler'
+
+const callbackManager = new CallbackManager()
+let devicemotionListener
+
+/**
+ * 停止监听加速度数据。
+ */
+export const stopAccelerometer: typeof Taro.stopAccelerometer = ({ success, fail, complete } = {}) => {
+  const res: Partial<TaroGeneral.CallbackResult> = {}
+  const handle = new MethodHandler({ name: 'stopAccelerometer', success, fail, complete })
+  try {
+    window.removeEventListener('devicemotion', devicemotionListener, true)
+    return handle.success(res)
+  } catch (e) {
+    res.errMsg = e.message
+    return handle.fail(res)
+  }
+}
+
+const INTERVAL_MAP = {
+  game: {
+    interval: 20,
+    frequency: 50
+  },
+  ui: {
+    interval: 60,
+    frequency: 16.67
+  },
+  normal: {
+    interval: 200,
+    frequency: 5
+  }
+}
+
+const getDevicemotionListener = interval => {
+  let lock
+  let timer
+  return evt => {
+    if (lock) return
+    lock = true
+    timer && clearTimeout(timer)
+    callbackManager.trigger({
+      x: evt.acceleration.x || 0,
+      y: evt.acceleration.y || 0,
+      z: evt.acceleration.z || 0
+    })
+    timer = setTimeout(() => { lock = false }, interval)
+  }
+}
+
+/**
+ * 开始监听加速度数据。
+ */
+export const startAccelerometer: typeof Taro.startAccelerometer = ({ interval = 'normal', success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'startAccelerometer', success, fail, complete })
+  try {
+    if (window.DeviceMotionEvent) {
+      const intervalObj = INTERVAL_MAP[interval]
+      if (devicemotionListener) {
+        stopAccelerometer()
+      }
+      devicemotionListener = getDevicemotionListener(intervalObj.interval)
+      window.addEventListener('devicemotion', devicemotionListener, true)
+    } else {
+      throw new Error('accelerometer is not supported')
+    }
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+/**
+ * 监听加速度数据事件。频率根据 Taro.startAccelerometer() 的 interval 参数。可使用 Taro.stopAccelerometer() 停止监听。
+ */
+export const onAccelerometerChange: typeof Taro.onAccelerometerChange = callback => {
+  callbackManager.add(callback)
+}
+
+/**
+ * 取消监听加速度数据事件，参数为空，则取消所有的事件监听
+ */
+export const offAccelerometerChange: typeof Taro.offAccelerometerChange = callback => {
+  callbackManager.remove(callback)
+}

package/src/api/device/accessibility.ts

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 无障碍
+export const checkIsOpenAccessibility = temporarilyNotSupport('checkIsOpenAccessibility')

package/src/api/device/battery.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 电量
+export const getBatteryInfoSync = temporarilyNotSupport('getBatteryInfoSync')
+export const getBatteryInfo = temporarilyNotSupport('getBatteryInfo')

package/src/api/device/bluetooth-ble.ts

@@ -0,0 +1,19 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 蓝牙-低功耗中心设备
+export const writeBLECharacteristicValue = temporarilyNotSupport('writeBLECharacteristicValue')
+export const setBLEMTU = temporarilyNotSupport('setBLEMTU')
+export const readBLECharacteristicValue = temporarilyNotSupport('readBLECharacteristicValue')
+export const onBLEMTUChange = temporarilyNotSupport('onBLEMTUChange')
+export const onBLEConnectionStateChange = temporarilyNotSupport('onBLEConnectionStateChange')
+export const onBLECharacteristicValueChange = temporarilyNotSupport('onBLECharacteristicValueChange')
+export const offBLEMTUChange = temporarilyNotSupport('offBLEMTUChange')
+export const offBLEConnectionStateChange = temporarilyNotSupport('offBLEConnectionStateChange')
+export const offBLECharacteristicValueChange = temporarilyNotSupport('offBLECharacteristicValueChange')
+export const notifyBLECharacteristicValueChange = temporarilyNotSupport('notifyBLECharacteristicValueChange')
+export const getBLEMTU = temporarilyNotSupport('getBLEMTU')
+export const getBLEDeviceServices = temporarilyNotSupport('getBLEDeviceServices')
+export const getBLEDeviceRSSI = temporarilyNotSupport('getBLEDeviceRSSI')
+export const getBLEDeviceCharacteristics = temporarilyNotSupport('getBLEDeviceCharacteristics')
+export const createBLEConnection = temporarilyNotSupport('createBLEConnection')
+export const closeBLEConnection = temporarilyNotSupport('closeBLEConnection')

package/src/api/device/bluetooth-peripheral.ts

@@ -0,0 +1,6 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 蓝牙-低功耗外围设备
+export const onBLEPeripheralConnectionStateChanged = temporarilyNotSupport('onBLEPeripheralConnectionStateChanged')
+export const offBLEPeripheralConnectionStateChanged = temporarilyNotSupport('offBLEPeripheralConnectionStateChanged')
+export const createBLEPeripheralServer = temporarilyNotSupport('createBLEPeripheralServer')

package/src/api/device/bluetooth.ts

@@ -0,0 +1,16 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 蓝牙-通用
+export const stopBluetoothDevicesDiscovery = temporarilyNotSupport('stopBluetoothDevicesDiscovery')
+export const startBluetoothDevicesDiscovery = temporarilyNotSupport('startBluetoothDevicesDiscovery')
+export const openBluetoothAdapter = temporarilyNotSupport('openBluetoothAdapter')
+export const onBluetoothDeviceFound = temporarilyNotSupport('onBluetoothDeviceFound')
+export const onBluetoothAdapterStateChange = temporarilyNotSupport('onBluetoothAdapterStateChange')
+export const offBluetoothDeviceFound = temporarilyNotSupport('offBluetoothDeviceFound')
+export const offBluetoothAdapterStateChange = temporarilyNotSupport('offBluetoothAdapterStateChange')
+export const makeBluetoothPair = temporarilyNotSupport('makeBluetoothPair')
+export const isBluetoothDevicePaired = temporarilyNotSupport('isBluetoothDevicePaired')
+export const getConnectedBluetoothDevices = temporarilyNotSupport('getConnectedBluetoothDevices')
+export const getBluetoothDevices = temporarilyNotSupport('getBluetoothDevices')
+export const getBluetoothAdapterState = temporarilyNotSupport('getBluetoothAdapterState')
+export const closeBluetoothAdapter = temporarilyNotSupport('closeBluetoothAdapter')

package/src/api/device/calendar.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 日历
+export const addPhoneRepeatCalendar = temporarilyNotSupport('addPhoneRepeatCalendar')
+export const addPhoneCalendar = temporarilyNotSupport('addPhoneCalendar')

package/src/api/device/clipboard.ts

@@ -0,0 +1,67 @@
+/**
+ * 剪贴板部分的api参考了Chameleon项目的实现：
+ *
+ * setClipboardData: https://github.com/chameleon-team/chameleon-api/tree/master/src/interfaces/setClipBoardData
+ * getClipboardData: https://github.com/chameleon-team/chameleon-api/tree/master/src/interfaces/getClipBoardData
+ */
+
+import Taro from '@tarojs/api'
+import { setStorage, setStorageSync, getStorageSync } from '../storage/index'
+import { MethodHandler } from '../utils/handler'
+
+const CLIPBOARD_STORAGE_NAME = 'taro_clipboard'
+
+document.addEventListener('copy', () => {
+  setStorage({
+    key: CLIPBOARD_STORAGE_NAME,
+    data: window.getSelection()?.toString()
+  }).catch(e => {
+    console.error(e)
+  })
+})
+
+/**
+ * 设置系统剪贴板的内容
+ */
+export const setClipboardData: typeof Taro.setClipboardData = async ({ data, success, fail, complete }) => {
+  const handle = new MethodHandler({ name: 'setClipboardData', success, fail, complete })
+  try {
+    setStorageSync(CLIPBOARD_STORAGE_NAME, data)
+    /**
+     * 已于 iPhone 6s Plus iOS 13.1.3 上的 Safari 测试通过
+     * iOS < 10 的系统可能无法使用编程方式访问剪贴板，参考：
+     * https://stackoverflow.com/questions/34045777/copy-to-clipboard-using-javascript-in-ios/34046084
+     */
+    if (typeof document.execCommand === 'function') {
+      const textarea = document.createElement('textarea')
+      textarea.readOnly = true
+      textarea.value = data
+      textarea.style.position = 'absolute'
+      textarea.style.width = '100px'
+      textarea.style.left = '-10000px'
+      document.body.appendChild(textarea)
+      textarea.select()
+      textarea.setSelectionRange(0, textarea.value.length)
+      document.execCommand('copy')
+      document.body.removeChild(textarea)
+    } else {
+      throw new Error('Unsupported Function: \'document.execCommand\'.')
+    }
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+/**
+ * 获取系统剪贴板的内容
+ */
+export const getClipboardData: typeof Taro.getClipboardData = async ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler<Taro.getClipboardData.SuccessCallbackOption>({ name: 'getClipboardData', success, fail, complete })
+  try {
+    const data: string = getStorageSync(CLIPBOARD_STORAGE_NAME)
+    return handle.success({ data })
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}

package/src/api/device/compass.ts

@@ -0,0 +1,67 @@
+import Taro from '@tarojs/api'
+import { CallbackManager, MethodHandler } from '../utils/handler'
+
+const callbackManager = new CallbackManager()
+let compassListener
+
+/**
+ * 停止监听罗盘数据
+ */
+export const stopCompass: typeof Taro.stopCompass = ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'stopCompass', success, fail, complete })
+  try {
+    window.removeEventListener('deviceorientation', compassListener, true)
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+const getDeviceOrientationListener = interval => {
+  let lock
+  let timer
+  return evt => {
+    if (lock) return
+    lock = true
+    timer && clearTimeout(timer)
+    callbackManager.trigger({
+      direction: 360 - evt.alpha
+    })
+    timer = setTimeout(() => { lock = false }, interval)
+  }
+}
+
+/**
+ * 开始监听罗盘数据
+ */
+export const startCompass: typeof Taro.startCompass = ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'startCompass', success, fail, complete })
+  try {
+    if (window.DeviceOrientationEvent) {
+      if (compassListener) {
+        stopCompass()
+      }
+      compassListener = getDeviceOrientationListener(200)
+      window.addEventListener('deviceorientation', compassListener, true)
+    } else {
+      throw new Error('compass is not supported')
+    }
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+/**
+ * 监听罗盘数据变化事件。频率：5 次/秒，接口调用后会自动开始监听，可使用 wx.stopCompass 停止监听。
+ */
+export const onCompassChange: typeof Taro.onCompassChange = callback => {
+  callbackManager.add(callback)
+}
+
+/**
+ * 取消监听罗盘数据变化事件，参数为空，则取消所有的事件监听。
+ */
+export const offCompassChange: typeof Taro.offCompassChange = callback => {
+  callbackManager.remove(callback)
+}

package/src/api/device/contact.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 联系人
+export const chooseContact = temporarilyNotSupport('chooseContact')
+export const addPhoneContact = temporarilyNotSupport('addPhoneContact')

package/src/api/device/crypto.ts

@@ -0,0 +1,4 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 加密
+export const getRandomValues = temporarilyNotSupport('getRandomValues')

package/src/api/device/gyroscope.ts

@@ -0,0 +1,7 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 陀螺仪
+export const stopGyroscope = temporarilyNotSupport('stopGyroscope')
+export const startGyroscope = temporarilyNotSupport('startGyroscope')
+export const onGyroscopeChange = temporarilyNotSupport('onGyroscopeChange')
+export const offGyroscopeChange = temporarilyNotSupport('offGyroscopeChange')

package/src/api/device/iBeacon.ts

@@ -0,0 +1,10 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 蓝牙-信标(Beacon)
+export const stopBeaconDiscovery = temporarilyNotSupport('stopBeaconDiscovery')
+export const startBeaconDiscovery = temporarilyNotSupport('startBeaconDiscovery')
+export const onBeaconUpdate = temporarilyNotSupport('onBeaconUpdate')
+export const onBeaconServiceChange = temporarilyNotSupport('onBeaconServiceChange')
+export const offBeaconUpdate = temporarilyNotSupport('offBeaconUpdate')
+export const offBeaconServiceChange = temporarilyNotSupport('offBeaconServiceChange')
+export const getBeacons = temporarilyNotSupport('getBeacons')

package/src/api/device/index.ts

@@ -0,0 +1,22 @@
+export * from './accelerometer'
+export * from './accessibility'
+export * from './battery'
+export * from './bluetooth'
+export * from './bluetooth-ble'
+export * from './bluetooth-peripheral'
+export * from './calendar'
+export * from './clipboard'
+export * from './compass'
+export * from './contact'
+export * from './crypto'
+export * from './gyroscope'
+export * from './iBeacon'
+export * from './keyboard'
+export * from './memory'
+export * from './motion'
+export * from './nfc'
+export * from './phone'
+export * from './scan'
+export * from './screen'
+export * from './vibrate'
+export * from './wifi'

package/src/api/device/keyboard.ts

@@ -0,0 +1,7 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 键盘
+export const onKeyboardHeightChange = temporarilyNotSupport('onKeyboardHeightChange')
+export const offKeyboardHeightChange = temporarilyNotSupport('offKeyboardHeightChange')
+export const hideKeyboard = temporarilyNotSupport('hideKeyboard')
+export const getSelectedTextRange = temporarilyNotSupport('getSelectedTextRange')

package/src/api/device/memory.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 内存
+export const onMemoryWarning = temporarilyNotSupport('onMemoryWarning')
+export const offMemoryWarning = temporarilyNotSupport('offMemoryWarning')

package/src/api/device/motion.ts

@@ -0,0 +1,85 @@
+import Taro from '@tarojs/api'
+import { CallbackManager, MethodHandler } from '../utils/handler'
+
+const callbackManager = new CallbackManager()
+let deviceMotionListener
+
+const INTERVAL_MAP = {
+  game: {
+    interval: 20,
+    frequency: 50
+  },
+  ui: {
+    interval: 60,
+    frequency: 16.67
+  },
+  normal: {
+    interval: 200,
+    frequency: 5
+  }
+}
+
+/**
+ * 停止监听设备方向的变化。
+ */
+export const stopDeviceMotionListening: typeof Taro.stopDeviceMotionListening = ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'stopDeviceMotionListening', success, fail, complete })
+  try {
+    window.removeEventListener('deviceorientation', deviceMotionListener, true)
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+const getDeviceOrientationListener = interval => {
+  let lock
+  let timer
+  return evt => {
+    if (lock) return
+    lock = true
+    timer && clearTimeout(timer)
+    callbackManager.trigger({
+      alpha: evt.alpha,
+      beta: evt.beta,
+      gamma: evt.gamma
+    })
+    timer = setTimeout(() => { lock = false }, interval)
+  }
+}
+
+/**
+ * 开始监听设备方向的变化。
+ */
+export const startDeviceMotionListening: typeof Taro.startDeviceMotionListening = ({ interval = 'normal', success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'startDeviceMotionListening', success, fail, complete })
+  try {
+    const intervalObj = INTERVAL_MAP[interval]
+    if (window.DeviceOrientationEvent) {
+      if (deviceMotionListener) {
+        stopDeviceMotionListening()
+      }
+      deviceMotionListener = getDeviceOrientationListener(intervalObj.interval)
+      window.addEventListener('deviceorientation', deviceMotionListener, true)
+    } else {
+      throw new Error('deviceMotion is not supported')
+    }
+    return handle.success()
+  } catch (e) {
+    return handle.fail({ errMsg: e.message })
+  }
+}
+
+/**
+ * 监听设备方向变化事件。
+ */
+export const onDeviceMotionChange: typeof Taro.onDeviceMotionChange = callback => {
+  callbackManager.add(callback)
+}
+
+/**
+ * 取消监听设备方向变化事件，参数为空，则取消所有的事件监听。
+ */
+export const offDeviceMotionChange: typeof Taro.offDeviceMotionChange = callback => {
+  callbackManager.remove(callback)
+}

package/src/api/device/nfc.ts

@@ -0,0 +1,10 @@
+import { temporarilyNotSupport } from '../utils'
+
+// NFC
+export const stopHCE = temporarilyNotSupport('stopHCE')
+export const startHCE = temporarilyNotSupport('startHCE')
+export const sendHCEMessage = temporarilyNotSupport('sendHCEMessage')
+export const onHCEMessage = temporarilyNotSupport('onHCEMessage')
+export const offHCEMessage = temporarilyNotSupport('offHCEMessage')
+export const getNFCAdapter = temporarilyNotSupport('getNFCAdapter')
+export const getHCEState = temporarilyNotSupport('getHCEState')

package/src/api/device/phone.ts

@@ -0,0 +1,30 @@
+import Taro from '@tarojs/api'
+import { shouldBeObject, getParameterError } from '../utils'
+import { MethodHandler } from '../utils/handler'
+
+export const makePhoneCall: typeof Taro.makePhoneCall = (options) => {
+  // options must be an Object
+  const isObject = shouldBeObject(options)
+  if (!isObject.flag) {
+    const res = { errMsg: `makePhoneCall:fail ${isObject.msg}` }
+    console.error(res.errMsg)
+    return Promise.reject(res)
+  }
+
+  const { phoneNumber, success, fail, complete } = options
+  const handle = new MethodHandler({ name: 'makePhoneCall', success, fail, complete })
+
+  if (typeof phoneNumber !== 'string') {
+    return handle.fail({
+      errMsg: getParameterError({
+        para: 'phoneNumber',
+        correct: 'String',
+        wrong: phoneNumber
+      })
+    })
+  }
+
+  window.location.href = `tel:${phoneNumber}`
+
+  return handle.success()
+}

package/src/api/device/scan.ts

@@ -0,0 +1,7 @@
+import { processOpenApi } from '../utils'
+
+// 扫码
+export const scanCode = processOpenApi('scanQRCode', { needResult: 1 }, res => ({
+  errMsg: res.errMsg === 'scanQRCode:ok' ? 'scanCode:ok' : res.errMsg,
+  result: res.resultStr
+}))

package/src/api/device/screen.ts

@@ -0,0 +1,9 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 屏幕
+export const setVisualEffectOnCapture = temporarilyNotSupport('setVisualEffectOnCapture')
+export const setScreenBrightness = temporarilyNotSupport('setScreenBrightness')
+export const setKeepScreenOn = temporarilyNotSupport('setKeepScreenOn')
+export const onUserCaptureScreen = temporarilyNotSupport('onUserCaptureScreen')
+export const offUserCaptureScreen = temporarilyNotSupport('offUserCaptureScreen')
+export const getScreenBrightness = temporarilyNotSupport('getScreenBrightness')

package/src/api/device/vibrate.ts

@@ -0,0 +1,36 @@
+import Taro from '@tarojs/api'
+import { MethodHandler } from '../utils/handler'
+
+const vibrator = function vibrator (mm) {
+  try {
+    return window.navigator.vibrate(mm)
+  } catch (e) {
+    console.warn('当前浏览器不支持vibrate')
+  }
+}
+
+/**
+ * 使手机发生较短时间的振动（15 ms）。仅在 iPhone 7 / 7 Plus 以上及 Android 机型生效
+ */
+export const vibrateShort: typeof Taro.vibrateShort = ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'vibrateShort', success, fail, complete })
+  if (vibrator) {
+    vibrator(15)
+    return handle.success()
+  } else {
+    return handle.fail()
+  }
+}
+
+/**
+ * 使手机发生较长时间的振动（400 ms)
+ */
+export const vibrateLong: typeof Taro.vibrateLong = ({ success, fail, complete } = {}) => {
+  const handle = new MethodHandler({ name: 'vibrateLong', success, fail, complete })
+  if (vibrator) {
+    vibrator(400)
+    return handle.success()
+  } else {
+    return handle.fail()
+  }
+}

package/src/api/device/wifi.ts

@@ -0,0 +1,13 @@
+import { temporarilyNotSupport } from '../utils'
+
+// Wi-Fi
+export const stopWifi = temporarilyNotSupport('stopWifi')
+export const startWifi = temporarilyNotSupport('startWifi')
+export const setWifiList = temporarilyNotSupport('setWifiList')
+export const onWifiConnected = temporarilyNotSupport('onWifiConnected')
+export const onGetWifiList = temporarilyNotSupport('onGetWifiList')
+export const offWifiConnected = temporarilyNotSupport('offWifiConnected')
+export const offGetWifiList = temporarilyNotSupport('offGetWifiList')
+export const getWifiList = temporarilyNotSupport('getWifiList')
+export const getConnectedWifi = temporarilyNotSupport('getConnectedWifi')
+export const connectWifi = temporarilyNotSupport('connectWifi')

package/src/api/ext/index.ts

@@ -0,0 +1,5 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 第三方平台
+export const getExtConfigSync = temporarilyNotSupport('getExtConfigSync')
+export const getExtConfig = temporarilyNotSupport('getExtConfig')