API 介绍
MoreCross 提供了一系列 API(mc. 命名空间),覆盖基础能力、界面交互、网络、存储、媒体、设备等开发场景,
帮助开发者调用平台能力,写出体验与原生应用一致的 MoreCross 应用。
调用方式
绝大多数 API 采用 mc.接口名 的形式调用,例如:
mc.showToast({
title: '操作成功',
})
mc.getSystemInfo({
success: function (res) {
console.log(res.brand, res.model)
},
})
部分 API 会返回一个对象实例(如 InnerAudioContext、VideoContext、SelectorQuery),
需要先用 mc.createXxx / mc.getXxx 创建或获取实例,再调用实例上的方法。
回调约定
需要异步返回结果的 API,统一支持三个回调参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 |
| fail | function | 否 | 接口调用失败的回调函数 |
| complete | function | 否 | 接口调用结束的回调函数(成功、失败都会执行) |
分类索引
- 基础:mc.env、mc.canIUse、系统信息、 生命周期、调试、定时器、 Base64
- 界面:路由、交互、导航栏、 标签栏、页面、字体、 动画、窗口、键盘、 节点信息、其他
- 网络:mc.request、mc.downloadFile、 mc.uploadFile
- 数据存储:mc.setStorageSync、mc.getStorageSync、 mc.getStorageInfoSync
- 媒体:图片、视频、音频、 录音、相机、 地图、富文本
- 位置:mc.getLocation、mc.chooseLocation、 mc.openLocation
- 文件:mc.saveFile、mc.getFileInfo、mc.openDocument
- 画布:Canvas、CanvasContext、mc.createCanvasContext
- 设备:剪贴板、扫码、 振动、电话
- 开放接口:mc.openURL