Appearance
1.1 开放接口
1.1.1 登录
API： mos.login(appKey)
支持以 Promise 风格调用。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | string | 是 | 微应用 appKey |
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| code | string | TODO |
1.1.2 分享文本
API： mos.shareToApp(content)
支持以 Promise 风格调用。通过 mos 分享文本。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 需要分享出去的文本内容 |
响应
无
示例代码
js
mos.shareToApp(content)1.1.3 获取用户信息
API： mos.getUserInfo(authorizedDesc)
支持以 Promise 风格调用。需弹窗显示，用户点击授权后返回相应信息。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| authorizedDesc | string | 是 | 获取授权信息的用处 |
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| authorized | number | 0-不授权 | 1-授权 | 2-没有对应信息 |
| firstName | string | 姓 |
| lastName | string | 名 |
| headPortrait | string | 头像地址 |
| descriptor | string | 个人简介 |
1.1.4 获取用户手机号/邮箱信息
API： mos.getUserContactInfo(authorizedDesc)
支持以 Promise 风格调用。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| authorizedDesc | string | 是 | 获取授权信息的用处 |
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| authorized | number | 0-不授权 | 1-授权 | 2-没有对应信息 |
| dialCode | string | 区号 |
| phone | string | 手机号码 |
| string | 邮箱地址 |
1.1.5 获取用户唯一签名
API： mos.getSign
支持以 Promise 风格调用。获取用户签名用来校验 mos 是否切换了用户。
参数
无
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| sign | string | 签名 |
1.1.6 获取当前语言
API： mos.getLanguage
支持以 Promise 风格调用。
参数
无
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| lang | string | 语言，如 en_US |
1.1.7 设置分享链接
API： mos.setShareLink(link)
支持以 Promise 风格调用。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| link | string | 是 | 待分享的链接 |
响应
无
1.1.8 调起支付
API： mos.pay(Object object)
支持以 Promise 风格调用。错误提示需客户端处理。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | string | 是 | 支付金额 |
| currency | string | 是 | 币种，USD-美元 | KHR-瑞尔 |
| appKey | string | 是 | 微应用 appKey |
| prepayId | string | 是 | 订单预支付ID |
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| result | string | 支付结果 SUCCESS-成功 | CANCEL-用户取消 | NOWALLET-钱包不可用（未绑定钱包/未设置支付密码） |
| data | string | 支付结果为 SUCCESS 时才有，值为服务端返回的信息 |
1.1.9 获取窗口信息
API： mos.getWindowInfo
支持以 Promise 风格调用。
参数
无
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| statusBarHeight | number | 状态栏高度 |
1.1.10 分享微应用页面
API： mos.shareMiniApp(Object object)
支持以 Promise 风格调用。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 否 | 启动参数 |
| shareDisabled | string | 否 | 是否禁用分享 1-禁用 | 0-启用 |
| desc | string | 否 | 页面描述，通常为当前页面标题 |
| imageUrl | string | 否 | 微应用消息上展示的图片地址 |
| screenShotDisabled | string | 否 | 是否禁止屏幕截图用于微应用消息的页面图片展示 1-禁止截图 | 0-自动截图 |
TIP
图片展示规则：
- imageUrl 有值时优先使用 imageUrl 的值
- imageUrl 为空时：
- screenShotDisabled=1 不截图，页面图片展示默认图
- screenShotDisabled=0 系统自动截图
响应
无
1.1.11 获取启动参数
API： mos.getLaunchOptions
支持以 Promise 风格调用。获取微应用启动时的 query 参数，例如 https://mp.mos.me/mp/<miniapp_id>?query=<query>。
参数
无
响应
| 属性 | 类型 | 说明 |
|---|---|---|
| query | string | 启动参数 |
1.2 设备
1.2.1 打电话
API： mos.chooseContact(phoneNumber)
支持以 Promise 风格调用。
参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phoneNumber | string | 是 | 手机号码 |
响应
无