支付宝小程序API 设备

由 marlboro90 创建,最后一次修改 2017-08-24

支付宝小程序API设备

my.getSystemInfo

获取系统信息。

入参

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

success 返回值

名称 类型 描述
model String 手机型号
pixelRatio Number 设备像素比
windowWidth Number 窗口宽度
windowHeight Number 窗口高度
language String 支付宝设置的语言
version String 支付宝版本号

代码示例

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.scan

调用扫一扫功能。

入参

名称 类型 必填 描述
type String 扫描目标类型,支持 qr / bar,相应扫码选框会不同,默认 qr
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称 类型 描述
code String 扫码所得数据

错误码

error 描述
10 用户取消
11 操作失败

代码示例

 Page({
  scan() {
    my.scan({
      type: 'qr',
      success: (res) => {
        my.alert({ title: res.code });
      },
    });
  }
})

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, 
        });
      },
    });
  }
升级为会员,尊享更多会员特权
二维码
建议反馈
二维码