移动设备能力

设备信息-获取网络状态

getNetworkType


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎


参数
-无-

成功回调返回

字段 类型 说明
networkType string 返回网络类型,fail


示例

mtl.getNetworkType({
  success: function(res) {
    var networkType = res.networkType;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

设备信息-获取系统信息

getSystemInfo


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数
-无-

成功回调返回

字段 类型 说明
brand string 手机厂商
model string 手机型号
platform string 系统名称:Android/iOS
system string 系统版本
screenWidth number 屏幕宽度
screenHeight number 屏幕高度
pixelRatio number 设备像素比
YZVersion string 友空间版本号/独立app版本号
YZLanguage string 友空间当前设置的语言/独立app当前系统语言
deviceId string 设备唯一标识


示例

mtl.getSystemInfo({
  success: function(res) {
    var YZVersion = res.YZVersion;
    ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

设备信息-获取设备唯一标识

getMac

获取设备唯一标识

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎


参数
-无-

示例

mtl.getMac({
  success: function(res) {
    var macAddress = res.macAddress;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

地图-获取位置信息

getLocation

获取当前坐标,需要引入upesn-plugin-map插件并在project.json文件中替换用户自己的高德地图key

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
type string 默认为wgs84的gps坐标,如果要返回直接给openLocation用的火星坐标,可传入'gcj02'


示例

mtl.getLocation({
  type: "wgs84",
  success: function(res) {
    var latitude = res.latitude; // 纬度,浮点数,范围为90 ~ -90
    var longitude = res.longitude; // 经度,浮点数,范围为180 ~ -180。
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

地图-打开地图

openLocation

打开地图查看指定坐标位置,需要引入upesn-plugin-map插件并在project.json文件中替换用户自己的高德地图key

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
latitude number 纬度,浮点数,范围为90 ~ -90
longitude number 经度,浮点数,范围为180 ~ -180。
searchRaidus number 查询半径(单位:米),小于0时不限制(微信不支持)
name string 位置名,如 "用友软件园",缺省时显示 "[位置]"(仅微信支持)
address string 地址详情说明(仅微信支持)
scale number 地图缩放级别,整形值,范围从1~28。默认为28(仅微信支持)


示例

mtl.openLocation({
  latitude: 0,
  longitude: 0,
    name: "用友软件园",
    address: "北清路68号",
  scale: 28,
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

地图打点(导航)

markAndNavigationDestination

在地图中展示目标点以及跳转第三方地图进行导航

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
address string 目标地区地址
subAddress string 目标地区详细地址
latitude string 目标地区纬度
longitude string 目标地区经度
userInfo object 用户信息
infomation string 客户信息
navigation bool 是否需要导航


示例

mtl.markAndNavigationDestination({
  ...
  success: function(res) {
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

开启持续定位

continuousLocationStart


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数
-无-
示例

mtl.continuousLocationStart({
  success: function(res) {
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

获取持续定位信息

continuousLocationGet


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数
-无-

示例**

mtl.continuousLocationGet({
  success: function(res) {
    const {latitude, longitude, ...} = res
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

关闭持续定位

continuousLocationStop


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数
-无-

示例

mtl.continuousLocationStop({
  success: function(res) {
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

权限查询

getAuthorizationStatus


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
type number 授权类型。0相册权限开关;1相机权限开关;2麦克风权限开关;3位置权限开关;4通讯录权限开关


成功回调返回

字段 类型 说明
authStatus number 授权状态:0,未授权 1,已授权


示例**

mtl.getAuthorizationStatus({
  type : 0,
  success: funtion(res) {
        let authStatus = res.authStatus
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

监听网络状态变化

onNetworkStatusChange


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
callback function 网络变化是的回调函数


成功回调返回

字段 类型 说明
isConnected boolean 是否连接网络
networkType String 网络类型(WIFI, 4G,3G,2G,unknown,none)


示例**

mtl.onNetworkStatusChange({
  callback : function(res) {
  },
  success: function(res) {
        let authStatus = res.authStatus
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

监听摇一摇

watchShake


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
callback function 回调函数


成功回调返回**

字段 类型 说明
isConnected boolean 是否连接网络
networkType String 网络类型(WIFI, 4G,3G,2G,unknown,none)

示例

mtl.watchShake({
  callback:function(res){
  },
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

截屏

screenShot


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
type number 0 只截取当前webview的图像
1 截取整个友空间APP的图像(包含导航条)
resultType number 0 返回截图的base字符串
1 返回截图的存储路径


成功回调返回**

字段 类型 说明
picStr String 图片base64编码字符串
picPath String 图片的存储路径


示例**

mtl.screenShot({
  type: 0,
  resultType: 1
  success: function(res) {
    const {picStr,picPath} = res
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

监听用户截屏

onUserCaptureScreen

监听用户主动截屏事件,用户使用系统截屏按键截屏时触发

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
callback function 用户截屏时的回调函数


示例**

mtl.onUserCaptureScreen({
  callback:function(res){
  },
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

拨打电话

dail

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
number string 电话号码


示例**

mtl.dail({
  number:'xxx',
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

拦截返回事件

backIntercept

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
callback function 返回事件回调函数


示例**

mtl.backIntercept({
    callback:function(res){
  },    
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

震动

vibrateOnce

使手机发生一次短暂震动。

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数
-无-

示例**

mtl.vibrateOnce({
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

强制横竖屏

changeScreenOrientation



**支持平台**
微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数**

字段 类型 必填 说明
orientation boolean 横屏 false, 竖屏 true


示例**

mtl.changeScreenOrientation({
  orientation: true,
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

恢复默认横竖屏

restoreScreenOrientation



**支持平台**
微信 友空间 安卓 iOS
✔︎ ✔︎


参数
-无-

参数

字段 类型 必填 说明
orientation boolean 横屏 false, 竖屏 true

示例

mtl.restoreScreenOrientation({
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});