移动设备能力

设备信息-获取网络状态

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


是否仍需要帮助? 请保持联络!
最后更新于 2023/01/18