支付宝小程序API 设备(20170824)

支付宝小程序API设备 11月27日已更新查看最新版>>>https://www.w3cschool.cn/aliminiapp/aliminiapp-6fdp2gxm.html

[TOC]

my.SDKVersion

获取基础库版本号，仅供参考，代码逻辑请不要依赖这个值

console.log(my.SDKVersion);

my.getSystemInfo

获取系统信息。

入参

名称	类型	必填	描述
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

success 返回值

名称	类型	描述	最低版本
model	String	手机型号	-
pixelRatio	Number	设备像素比	-
windowWidth	Number	窗口宽度	-
windowHeight	Number	窗口高度	-
language	String	支付宝设置的语言	-
version	String	支付宝版本号	-
storage	String	设备磁盘容量	1.1.1
currentBattery	String	当前电量百分比	1.1.1
system	String	系统版本	1.1.1
platform	String	系统名：Android，iOS	1.1.1
screeWidth	Number	屏幕宽度	1.1.1
screenHeight	Number	屏幕高度	1.1.1

代码示例

Page({
  data: {
    systemInfo: {}
  },
  getSystemInfoPage() {
    my.getSystemInfo({
      success: (res) => {
        this.setData({
          systemInfo: res
        })
      }
    })
  },
})

my.getSystemInfoSync

返回值同 getSystemInfo success 回调参数

代码示例

Page({
  data: {
    systemInfo: {}
  },
  getSystemInfoSyncPage() {
    this.setData({
          systemInfo: my.getSystemInfoSync()
        })
  }
})

my.canIUse(String)

判断 API 调用的参数和返回值以及组件以及属性是否支持。

参数使用 ${API}.${type}.${param}.${option} 或者 ${component}.${attribute}.${option} 方式来调用

• API 表示 api 名字
• type 取值 object/return/callback 表示 api 的判断类型
• param 表示参数的某一个属性名
• option 表示参数属性的具体属性值
• component 表示组件名称
• attribute 表示组件属性名
• option 表示组件属性值

例如

my.canIUse('getLocation.object.type')

my.getNetworkType

获取当前网络状态。

入参

名称	类型	必填	描述
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

success 返回值

名称	类型	描述
networkAvailable	Boolean	网络是否可用
networkType	String	网络类型值 UNKNOWN / NOTREACHABLE / WIFI / 3G / 2G / 4G / WWAN

代码示例

Page({
  data: {
    hasNetworkType: false
  },
  getNetworkType() {
    my.getNetworkType({
      success: (res) => {
        this.setData({
          hasNetworkType: true,
          networkType: res.networkType
        })
      }
    })
  },
  clear() {
    this.setData({
      hasNetworkType: false,
      networkType: ''
    })
  },
});

my.getClipboard

获取剪贴板数据。

入参

名称	类型	必填	描述
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

success 返回值

名称	类型	描述
text	String	剪贴板数据

代码示例

Page({
  data: {
    text: '3.1415926',
    copy: '',
  },

  
  handlePaste() {
    my.getClipboard({
      success: ({ text }) => {
        this.setData({ copy: text });
      },
    });
  },
});

my.setClipboard

设置剪贴板数据。

入参

名称	类型	必填	描述
text	String	是	剪贴板数据
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

代码示例

Page({
  data: {
    text: '3.1415926',
    copy: '',
  },


  handleCopy() {
    my.setClipboard({
      text: this.data.text,
    });
  },
});

my.watchShake

摇一摇功能。每次调用API，在摇一摇手机后触发回调，如需再次监听需要再次调用这个API。

代码示例

Page({
  watchShake() {
    my.watchShake({
      success: function() {
        console.log('动起来了')
        my.alert({ title:'动起来了 o.o'});
      }
    });
  },
});

my.vibrate

调用震动功能。

代码示例

Page({
  vibrate() {
    my.vibrate({
      success: () => {
        my.alert({ title: '震动起来了'});
      }
    });
  },
})

my.makePhoneCall

拨打电话。

入参

名称	类型	必填	描述
number	String	是	电话号码
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

代码示例

Page({
  makePhoneCall() {
    my.makePhoneCall({ number: '95888' });
  },
});

my.getServerTime

获取当前服务器时间的毫秒数。

入参

名称	类型	必填	描述
success	Function	否	调用成功的回调函数
fail	Function	否	调用失败的回调函数
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

success 返回值

名称	类型	描述
time	Number	服务器时间的毫秒数

代码示例

getServerTime(){
    my.getServerTime({
      success: (res) => {
        my.alert({
          title: res.time, 
        });
      },
    });
  }