codecamp

支付宝小程序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(),
    });
  },
})
支付宝小程序API canIUse
支付宝小程序API 网络状态
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

支付宝小程序开发文档

支付宝小程序 快速示例

支付宝小程序 小程序快速示例

支付宝小程序 框架

支付宝小程序 组件

支付宝小程序组件 基础组件

支付宝小程序组件 无障碍访问

支付宝小程序 扩展组件

支付宝小程序扩展组件 UI组件

支付宝小程序 API

支付宝小程序 开发工具

支付宝小程序 云服务

支付宝小程序 Serverless

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }