基础

对标wx小游戏基础api部分 (opens new window)

下列api的调用中，我们能够自动兼容前缀为 wx 和 mt 的接口，在打包过程中会对wx开头的api进行调用替换，无需手工处理。

系统

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.getSystemInfoSync		同步获得系统信息	11.2.200	11.2.200
  mt.getSystemInfo		获得系统信息	11.2.200	11.2.200

• 不支持API：

  无

• 容器差异性：

  iOS侧不支持 screenTop, batteryLevel, deviceOrientation, fontSizeSetting, benchmarkLevel 值的获取。

更新

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.getUpdateManager		同步获得系统信息	11.12.200	11.12.200
  	UpdateManager.applyUpdate	触发强制小游戏更新	11.12.200	11.12.200
  	UpdateManager.onCheckForUpdate	检查更新	11.12.200	11.12.200
  	UpdateManager.onUpdateFailed	监听更新失败	11.12.200	11.12.200
  	UpdateManager.onUpdateReady	监听更新完成	11.12.200	11.12.200

• 不支持API：

无

• 容器差异性：

  无

生命周期

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.onShow		监听小游戏切前台	11.2.200	11.2.200
  mt.onHide		监听小游戏切后台	11.2.200	11.2.200
  mt.offShow		取消监听小游戏切前台	11.2.200	11.2.200
  mt.offHide		取消监听小游戏切后台	11.2.200	11.2.200
  mt.getLaunchOptionsSync		获得小游戏运行参数	11.2.200	11.2.200
  mt.exitMiniProgram		退出小游戏	11.2.200	11.2.200

• 不支持API：

  无

• 容器差异性：

  无

全局事件

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.onUnhandledRejection		监听未处理的 Promise 拒绝事件		11.12.200
  mt.offUnhandledRejection		取消监听未处理 Promise 拒绝事件		11.12.200
  mt.onError		监听全局错误事件	11.12.200	11.12.200
  mt.offError		取消监听全局错误事件	11.12.200	11.12.200

• 不支持API：

  • mt.onAudioInterruptionBegin
  • mt.offAudioInterruptionBegin
  • mt.onAudioInterruptionEnd
  • mt.offAudioInterruptionEnd

• 容器差异性：

  无

触摸事件

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.onTouchStart		监听触摸开始	11.2.200	11.2.200
  mt.offTouchStart		取消监听触摸开始	11.2.200	11.2.200
  mt.onTouchMove		监听触摸移动	11.2.200	11.2.200
  mt.offTouchMove		取消监听触摸移动	11.2.200	11.2.200
  mt.onTouchEnd		监听触摸结束	11.2.200	11.2.200
  mt.offTouchEnd		取消监听触摸结束	11.2.200	11.2.200
  mt.onTouchCancel		监听触摸取消	11.2.200	11.2.200
  mt.offTouchCancel		取消监听触摸取消	11.2.200	11.2.200

• 不支持API：

  无

• 容器差异性：

  无

键盘事件

• 已支持API：

  无

• 不支持API：

  • mt.onKeyUp
  • mt.onKeyDown
  • mt.offKeyUp
  • mt.offKeyDown

• 容器差异性：

  无

鼠标事件

• 已支持API：

  无

• 不支持API：

  • mt.onMouseUp
  • mt.onMouseDown
  • mt.offMouseUp
  • mt.offMouseDown
  • mt.onMouseMove
  • mt.offMouseMove

• 容器差异性：

  无

滚轮事件

• 已支持API：

  无

• 不支持API：

  • mt.onWheel
  • mt.offWheel

• 容器差异性：

  无

剪切板功能

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.setClipboardData		复制内容到剪贴板	支持	支持
  mt.getClipboardData		获取剪贴板内容	支持	支持

• 不支持API：

  无

• 容器差异性：

  读写用户剪贴板能力属于平台隐私合规范畴，使用时需要携带隐私合规参数，游戏接入时可以暂时使用 pt-2454aa2749da0a8c。

  // 使用示例：
  mt.setClipboardData({
    data: '内容',
    sceneToken: 'pt-2454aa2749da0a8c',
    success: () => {},
    fail: () => {}
  })
  
  mt.getClipboardData({
    sceneToken: 'pt-2454aa2749da0a8c',
    success: (data) => {},
    fail: () => {}
  })
  

性能

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.triggerGC		触发垃圾回收	11.6.400	11.14.400
  mt.reportPerformance		测速上报	11.7.200	11.5.400

• 不支持API：

  • mt.getPerformance
  • Performance
  • Performance.now

• 容器差异性：

  无

分包加载

• 注意：主包不超过 4M，单个分包不限制大小，游戏整体包不能超过40M。

• 已支持API：

  API	实例 API	说明	iOS	Android
  mt.loadSubpackage		加载分包	11.18.200	11.20.200
  	LoadSubpackageTask.onProgressUpdate	分包加载进度回调	11.18.200	11.20.200

• 不支持API：

  无

• 容器差异性：

  无

调试

• 已支持API：

  API	实例 API	说明	iOS	Android
  console.warn		调试面板打印 warn 日志	11.2.200	11.2.200
  console.log		调试面板打印 log 日志	11.2.200	11.2.200
  console.info		调试面板打印 info 日志	11.2.200	11.2.200
  console.error		调试面板打印 error 日志	11.2.200	11.2.200
  console.debug		调试面板打印 debug 日志	11.2.200	11.2.200
  console.group		调试面板打印分组	11.2.200	11.2.200
  console.groupEnd		调试面板结束打印分组	11.2.200	11.2.200

• 不支持API：

  • mt.setEnableDebug
  • mt.getLogManager
  • LogManager
    • debug
    • info
    • log
    • Warn

• 容器差异性：

  无

定时器

• 已支持API：

  API	实例 API	说明	iOS	Android
  setTimeout		延迟执行	11.2.200	11.2.200
  clearTimeout		取消延迟执行	11.2.200	11.2.200
  setInterval		循环执行	11.2.200	11.2.200
  clearInterval		取消循环执行	11.2.200	11.2.200

• 不支持API：

  • mt.setEnableDebug
  • mt.getLogManager
  • LogManager
    • debug
    • info
    • log
    • Warn

• 容器差异性：

  无