移动设备能力

设备信息-获取网络状态

getNetworkType
支持平台

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

参数
-无-
返回参数说明

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

networkType合法值说明

参数	类型	说明
wifi	string	wifi 网络
2g	string	2g 网络
3g	string	3g 网络
4g	string	4g 网络
wwan	string	无法具体识别的移动网络
unknown	string	Android 下不常见的网络类型
none	string	无网络

示例

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; // 错误信息
  }
});

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

getUniqueId (6.0.0及以上)
getMac (即将废弃)
获取设备唯一标识
支持平台

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

参数
-无-
返回参数说明

字段	类型	说明
macAddress	string	设备唯一标识

示例

mtl.getUniqueId({
  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'

返回参数说明

字段	类型	说明
latitude	string	纬度，浮点数，范围为90 ~ -90
longitude	string	经度，浮点数，范围为180 ~ -180
address	string	地址

示例

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

地图-打开地图

openMap (6.0.0及以上)
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.openMap({
  latitude: 0,
  longitude: 0,
    name: "用友软件园",
    address: "北清路68号",
  scale: 28,
  success: function (res) {
     var addrstr = res.addrstr;
     var latitude = res.latitude;
     var longitude = res.longitude;
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

地图打点(导航)

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

**需要选择插件： **高德地图(带界面)
支持平台

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

参数

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

userInfo的合法值

名称	类型	必填	说明
header	string	否	目标头像(如果为空则根据名称自动生成)
userId	string	否	目标userId
userName	string	否	目标名称

示例

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

打开第三方地图导航

openMapToNavi
打开第三方地图app进行导航

**需要选择插件： **高德地图(带界面)
支持平台

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

参数

字段	类型	必填	说明
type	enum	是	导航类型， mtl.NAVITYPE.GAODE：高德地图; mtl.NAVITYPE.BAIDU：百度地图; mtl.NAVITYPE.TENCENT：腾讯地图
latitude	string	是	目的地纬度
longitude	string	是	目的地经度

示例

mtl.openMapToNavi({
  type:mtl.NAVITYPE.GAODE,
  latitude:39.872851,
  longitude:116.586559
});

开启持续定位

startContinuousLocation (6.0.0及以上)
continuousLocationStart (即将废弃)

**需要选择插件： **高德地图(带界面)
支持平台

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

参数
-无-

示例

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

获取持续定位信息

getContinuousLocation (6.0.0及以上)
continuousLocationGet (即将废弃)

**需要选择插件： **高德地图(带界面)
支持平台

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

参数
-无-
返回参数说明

参数	类型	说明
latitude	string	纬度
longitude	string	经度
address	string	地址描述
city	string	城市名称
cityCode	string	城市编码
accuracy	string	获取定位精度
speed	string	速度
province	string	省信息
time	string	定位时间

示例

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

关闭持续定位

stopContinuousLocation (6.0.0及以上)
continuousLocationStop (即将废弃)

**需要选择插件： **高德地图(带界面)
支持平台

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

参数
-无-
示例

mtl.stopContinuousLocation({
  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; // 错误信息
  }
});

监听摇一摇

onShake (6.0.0及以上)
watchShake (即将废弃)
支持平台

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

参数

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

示例

mtl.onShake({
  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; // 错误信息
  }
});

拦截返回事件

onInterceptBack (6.0.0及以上)
backIntercept (即将废弃)
支持平台

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

参数

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

示例

mtl.onInterceptBack({
    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
✘	✔︎	✔︎	✘

参数
-无-

示例

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

打开系统浏览器

openSchema

打开系统浏览器。

支持平台

安卓	iOS
✔︎	✔︎

参数

字段	说明
url	页面的url

示例

mtl.openSchema({
  url: '',
  success: function(res) {
    // 成功回调
        ...
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

是否仍需要帮助？请保持联络！

最后更新于 2024/04/24