小程序调用my.getSystemInfo获取设备系统信息-移动开发平台 mPaaS-阿里云

my.getSystemInfo

说明：mPaaS 10.1.32 及以上版本支持该接口。

此接口用于获取手机系统信息。

入参

名称	类型	必填	描述
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 / iPhone OS	1.1.1
titleBarHeight	Number	标题栏高度说明：该返回值仅 10.1.60 版本支持。	1.1.1
statusBarHeight	Number	状态栏高度说明：该返回值仅 10.1.60 版本支持。	1.1.1
screenWidth	Number	屏幕宽度	1.1.1
screenHeight	Number	屏幕高度	1.1.1
brand	String	手机品牌	1.4.0
fontSizeSetting	Number	用户设置字体大小说明：该返回值仅 10.1.60 版本支持。	1.4.0
app	String	当前运行的客户端。	-

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

代码示例

// 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(),
    });
  },
})

my.getSystemInfoSync

说明：mPaaS 10.1.32 及以上版本支持该接口。

获取手机系统信息的同步接口。返回值同 getSystemInfo 的 success 回调参数。

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

代码示例

// 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(),
    });
  },
})