支付宝小程序API 设备

由 ✎﹏๓₯㎕ζั͡❦﹏﹏♛ 创建, 最后一次修改 2017-08-24

支付宝小程序API设备

[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, 
        });
      },
    });
  }
W3Cschool学编程上微课-边学边练
二维码
建议反馈
二维码