全部产品
云市场
云游戏

系统信息

更新时间:2020-07-07 19:42:21

my.getSystemInfo

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


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

入参

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

success 返回值

名称 类型 描述 最低版本
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 标题栏高度
说明:该返回值仅 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

代码示例

  1. // API-DEMO page/API/get-system-info/get-system-info.json
  2. {
  3. "defaultTitle": "获取手机系统信息"
  4. }
  1. <!-- API-DEMO page/API/get-system-info/get-system-info.axml-->
  2. <view class="page">
  3. <view class="page-section">
  4. <view class="page-section-demo">
  5. <text>手机型号</text>
  6. <input type="text" disabled="{{true}}" value="{{systemInfo.model}}"></input>
  7. </view>
  8. <view class="page-section-demo">
  9. <text>语言</text>
  10. <input type="text" disabled="{{true}}" value="{{systemInfo.language}}"></input>
  11. </view>
  12. <view class="page-section-demo">
  13. <text>版本</text>
  14. <input type="text" disabled="{{true}}" value="{{systemInfo.version}}"></input>
  15. </view>
  16. <view class="page-section-demo">
  17. <text>window宽度</text>
  18. <input type="text" disabled="{{true}}" value="{{systemInfo.windowWidth}}"></input>
  19. </view>
  20. <view class="page-section-demo">
  21. <text>window高度</text>
  22. <input type="text" disabled="{{true}}" value="{{systemInfo.windowHeight}}"></input>
  23. </view>
  24. <view class="page-section-demo">
  25. <text>DPI</text>
  26. <input type="text" disabled="{{true}}" value="{{systemInfo.pixelRatio}}"></input>
  27. </view>
  28. <view class="page-section-btns">
  29. <view onTap="getSystemInfo">获取手机系统信息</view>
  30. <view onTap="getSystemInfoSync">同步获取手机系统信息</view>
  31. </view>
  32. </view>
  33. </view>
  1. // API-DEMO page/API/get-system-info/get-system-info.js
  2. Page({
  3. data: {
  4. systemInfo: {}
  5. },
  6. getSystemInfo() {
  7. my.getSystemInfo({
  8. success: (res) => {
  9. this.setData({
  10. systemInfo: res
  11. })
  12. }
  13. })
  14. },
  15. getSystemInfoSync() {
  16. this.setData({
  17. systemInfo: my.getSystemInfoSync(),
  18. });
  19. },
  20. })

my.getSystemInfoSync

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


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

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

代码示例

  1. // API-DEMO page/API/get-system-info/get-system-info.json
  2. {
  3. "defaultTitle": "获取手机系统信息"
  4. }
  1. <!-- API-DEMO page/API/get-system-info/get-system-info.axml-->
  2. <view class="page">
  3. <view class="page-section">
  4. <view class="page-section-demo">
  5. <text>手机型号</text>
  6. <input type="text" disabled="{{true}}" value="{{systemInfo.model}}"></input>
  7. </view>
  8. <view class="page-section-demo">
  9. <text>语言</text>
  10. <input type="text" disabled="{{true}}" value="{{systemInfo.language}}"></input>
  11. </view>
  12. <view class="page-section-demo">
  13. <text>版本</text>
  14. <input type="text" disabled="{{true}}" value="{{systemInfo.version}}"></input>
  15. </view>
  16. <view class="page-section-demo">
  17. <text>window宽度</text>
  18. <input type="text" disabled="{{true}}" value="{{systemInfo.windowWidth}}"></input>
  19. </view>
  20. <view class="page-section-demo">
  21. <text>window高度</text>
  22. <input type="text" disabled="{{true}}" value="{{systemInfo.windowHeight}}"></input>
  23. </view>
  24. <view class="page-section-demo">
  25. <text>DPI</text>
  26. <input type="text" disabled="{{true}}" value="{{systemInfo.pixelRatio}}"></input>
  27. </view>
  28. <view class="page-section-btns">
  29. <view onTap="getSystemInfo">获取手机系统信息</view>
  30. <view onTap="getSystemInfoSync">同步获取手机系统信息</view>
  31. </view>
  32. </view>
  33. </view>
  1. // API-DEMO page/API/get-system-info/get-system-info.js
  2. Page({
  3. data: {
  4. systemInfo: {}
  5. },
  6. getSystemInfo() {
  7. my.getSystemInfo({
  8. success: (res) => {
  9. this.setData({
  10. systemInfo: res
  11. })
  12. }
  13. })
  14. },
  15. getSystemInfoSync() {
  16. this.setData({
  17. systemInfo: my.getSystemInfoSync(),
  18. });
  19. },
  20. })