支付宝小程序API 系统信息

my.getSystemInfo

简介

my.getSystemInfo 是获取手机系统信息的 API。

扫码体验

系统信息.png

示例代码

// API-DEMO page/API/get-system-info/get-system-info.json
{
    "defaultTitle": "获取手机系统信息"
}

<!-- API-DEMO page/API/get-system-info/get-system-info.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>手机型号</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.model}}"></input>
    </view>
    <view class="page-section-demo">
      <text>语言</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.language}}"></input>
    </view>
    <view class="page-section-demo">
      <text>版本</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.version}}"></input>
    </view>
    <view class="page-section-demo">
      <text>window宽度</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.windowWidth}}"></input>
    </view>
    <view class="page-section-demo">
      <text>window高度</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.windowHeight}}"></input>
    </view>
    <view class="page-section-demo">
      <text>DPI</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.pixelRatio}}"></input>
    </view>
    <view class="page-section-btns">
      <view onTap="getSystemInfo">获取手机系统信息</view>
      <view onTap="getSystemInfoSync">同步获取手机系统信息</view>
    </view>
  </view>
</view>

// API-DEMO page/API/get-system-info/get-system-info.js
Page({
  data: {
    systemInfo: {}
  },
  getSystemInfo() {
    my.getSystemInfo({
      success: (res) => {
        this.setData({
          systemInfo: res
        })
      }
    })
  },
  getSystemInfoSync() {
    this.setData({
      systemInfo: my.getSystemInfoSync(),
    });
  },
})

入参

Object 类型，属性如下：

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

success 回调函数

入参为 Object 类型，属性如下：

属性	类型	描述
model	String	手机型号。
pixelRatio	Number	设备像素比。
windowWidth	Number	窗口宽度。
windowHeight	Number	窗口高度。
language	String	支付宝设置的语言。分别有以下值：zh-Hans（简体中文）、en（English）、zh-Hant（繁体中文（台湾））、zh-HK（繁体中文（香港））。
version	String	支付宝版本号。
storage	String	设备磁盘容量。基础库 1.1.1 或更高版本开始支持。
currentBattery	String	当前电量百分比。基础库 1.1.1 或更高版本开始支持。
system	String	系统版本。基础库 1.1.1 或更高版本开始支持。
platform	String	系统名：Android，iOS / iPhone OS 。基础库 1.1.1 或更高版本开始支持。
titleBarHeight	Number	标题栏高度。基础库 1.1.1 或更高版本开始支持。
statusBarHeight	Number	状态栏高度。基础库 1.1.1 或更高版本开始支持。
screenWidth	Number	屏幕宽度。基础库 1.1.1 或更高版本开始支持。
screenHeight	Number	屏幕高度。基础库 1.1.1 或更高版本开始支持。
brand	String	手机品牌。基础库 1.4.0 或更高版本开始支持。
fontSizeSetting	Number	用户设置字体大小。基础库 1.4.0 或更高版本开始支持。
app	String	当前运行的客户端，当前是支付宝则有效值是 "alipay"。

model 参数

对于 iPhone，model 参数将返回 iPhone 内部代码（Internal Name）。iPhone 手机型号与对应的 model 返回值如下表所示：

手机型号	model 返回值
iPhone	iPhone11
iPhone 3G	iPhone12
iPhone 3GS	iPhone21
iPhone 4	iPhone31 / iPhone32 / iPhone33
iPhone 4S	iPhone41
iPhone 5	iPhone51 / iPhone52
iPhone 5S	iPhone61 / iPhone62
iPhone 6	iPhone72
iPhone 6 Plus	iPhone71
iPhone 6S	iPhone8,1
iPhone 6S Plus	iPhone8,2
iPhone 7	iPhone9,1 / iPhone9,3
iPhone 7 Plus	iPhone9,2 / iPhone9,4
iPhone 8	iPhone10,1 / iPhone10,4
iPhone 8 Plus	iPhone10,2 / iPhone10,5
iPhone X	iPhone10,3 / iPhone10,6
iPhone XR	iPhone11,8
iPhone XS	iPhone11,2
iPhone 11	iPhone12,1
iPhone 11 Pro	iPhone12,3
iPhone XS Max	iPhone11,6 / iPhone11,4
iPhone 11 Pro Max	iPhone12,5

my.getSystemInfoSync

简介

my.getSystemInfoSync 是获取手机系统信息的同步接口。返回值同 my.getSystemInfo 接口 success 回调函数。

使用限制

该接口是同步接口，有超时的判断。当超时后，接口将返回 undefined。

扫码体验

系统信息.png

效果示例

客户端xx同步.gif

示例代码

// API-DEMO page/API/get-system-info/get-system-info.json
{
    "defaultTitle": "获取手机系统信息"
}

<!-- API-DEMO page/API/get-system-info/get-system-info.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>手机型号</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.model}}"></input>
    </view>
    <view class="page-section-demo">
      <text>语言</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.language}}"></input>
    </view>
    <view class="page-section-demo">
      <text>版本</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.version}}"></input>
    </view>
    <view class="page-section-demo">
      <text>window宽度</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.windowWidth}}"></input>
    </view>
    <view class="page-section-demo">
      <text>window高度</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.windowHeight}}"></input>
    </view>
    <view class="page-section-demo">
      <text>DPI</text>
      <input type="text" disabled="{{true}}" value="{{systemInfo.pixelRatio}}"></input>
    </view>
    <view class="page-section-btns">
      <view onTap="getSystemInfo">获取手机系统信息</view>
      <view onTap="getSystemInfoSync">同步获取手机系统信息</view>
    </view>
  </view>
</view>

// API-DEMO page/API/get-system-info/get-system-info.js
Page({
  data: {
    systemInfo: {}
  },
  getSystemInfo() {
    my.getSystemInfo({
      success: (res) => {
        this.setData({
          systemInfo: res
        })
      }
    })
  },
  getSystemInfoSync() {
    this.setData({
      systemInfo: my.getSystemInfoSync(),
    });
  },
})