Skip to content
Mr.HopeMr.Hope
主页
  • 小程序
    • 小程序教程

      • 小程序指南
        • 代码构成
          • 宿主环境
            • 配置

              • 配置
                • 全局配置文档
                  • 页面配置
                    • 小程序内索引
                    • 框架

                      • 框架
                        • 场景值
                          • 小程序的运行环境
                            • 小程序运行机制
                              • 小程序更新机制
                              • 逻辑层

                                • 逻辑层
                                  • 生命周期 <Badge text="不需要立即掌握" />
                                    • 页面路由
                                      • 注册
                                        • App
                                          • Page
                                            • 小程序运行机制
                                              • 模块化
                                                • API

                                                  • API <Badge text="重要" type="error" />
                                                    • 路由 API
                                                      • 数据缓存 API
                                                        • 页面交互 API
                                                          • 网络 API
                                                            • 系统相关 API
                                                              • wx.getSystemInfo(Object object)
                                                                • 参数
                                                                  • object.success 回调函数
                                                                  • Object wx.getSystemInfoSync()
                                                                    • UpdateManager wx.getUpdateManager()
                                                                      • UpdateManager
                                                                        • UpdateManager.applyUpdate()
                                                                          • UpdateManager.onCheckForUpdate(function callback)
                                                                            • UpdateManager.onUpdateReady(function callback)
                                                                              • UpdateManager.onUpdateFailed(function callback)
                                                                        • 视图层

                                                                          • 视图层 View
                                                                            • WXSS
                                                                              • 事件
                                                                                • 基础组件
                                                                                  • 动画
                                                                                    • WXS
                                                                                      • WXS 事件
                                                                                        • 简易双向绑定
                                                                                          • 获取界面上的节点信息
                                                                                            • 初始渲染缓存
                                                                                            • 能力

                                                                                              • 小程序能力
                                                                                                • 网络
                                                                                                  • 存储
                                                                                                    • 文件系统
                                                                                                      • 调试
                                                                                                    • 开发者工具

                                                                                                      • 工具使用
                                                                                                        • 界面
                                                                                                          • 调试
                                                                                                            • npm 支持
                                                                                                              • 体验评分
                                                                                                              • 小程序框架

                                                                                                                • 小程序框架说明
                                                                                                                  • 小程序简易开发指南
                                                                                                                    • 小程序页面参数表
                                                                                                                      • Page 插件
                                                                                                                        • YAML 文件案例
                                                                                                                        • 小程序分享

                                                                                                                          系统相关 API

                                                                                                                          Mr.Hope2020年11月8日
                                                                                                                          • 小程序
                                                                                                                          大约 3 分钟

                                                                                                                          此页内容
                                                                                                                          • wx.getSystemInfo(Object object)
                                                                                                                            • 参数
                                                                                                                            • object.success 回调函数
                                                                                                                          • Object wx.getSystemInfoSync()
                                                                                                                          • UpdateManager wx.getUpdateManager()
                                                                                                                          • UpdateManager
                                                                                                                            • UpdateManager.applyUpdate()
                                                                                                                            • UpdateManager.onCheckForUpdate(function callback)
                                                                                                                            • UpdateManager.onUpdateReady(function callback)
                                                                                                                            • UpdateManager.onUpdateFailed(function callback)

                                                                                                                          # wx.getSystemInfo(Object object)

                                                                                                                          获取系统信息

                                                                                                                          # 参数

                                                                                                                          Object object

                                                                                                                          属性类型必填说明
                                                                                                                          successfunction否接口调用成功的回调函数
                                                                                                                          failfunction否接口调用失败的回调函数
                                                                                                                          completefunction否接口调用结束的回调函数(调用成功、失败都会执行)

                                                                                                                          # object.success 回调函数

                                                                                                                          参数

                                                                                                                          Object res

                                                                                                                          属性类型说明最低版本
                                                                                                                          brandstring设备品牌1.5.0
                                                                                                                          modelstring设备型号
                                                                                                                          pixelRationumber设备像素比
                                                                                                                          screenWidthnumber屏幕宽度,单位 px1.1.0
                                                                                                                          screenHeightnumber屏幕高度,单位 px1.1.0
                                                                                                                          windowWidthnumber可使用窗口宽度,单位 px
                                                                                                                          windowHeightnumber可使用窗口高度,单位 px
                                                                                                                          statusBarHeightnumber状态栏的高度,单位 px1.9.0
                                                                                                                          languagestring微信设置的语言
                                                                                                                          versionstring微信版本号
                                                                                                                          systemstring操作系统及版本
                                                                                                                          platformstring客户端平台
                                                                                                                          fontSizeSettingnumber用户字体大小(单位 px)。以微信客户端「我-设置-通用-字体大小」中的设置为准1.5.0
                                                                                                                          SDKVersionstring客户端基础库版本1.1.0
                                                                                                                          benchmarkLevelnumber设备性能等级(仅 Android 小游戏)。
                                                                                                                          取值为: -2 或 0(该设备无法运行小游戏),-1(性能未知),>=1(设备性能值,该值越高,设备性能越好,目前最高不到 50)
                                                                                                                          1.8.0
                                                                                                                          albumAuthorizedboolean允许微信使用相册的开关(仅 iOS 有效)2.6.0
                                                                                                                          cameraAuthorizedboolean允许微信使用摄像头的开关2.6.0
                                                                                                                          locationAuthorizedboolean允许微信使用定位的开关2.6.0
                                                                                                                          microphoneAuthorizedboolean允许微信使用麦克风的开关2.6.0
                                                                                                                          notificationAuthorizedboolean允许微信通知的开关2.6.0
                                                                                                                          notificationAlertAuthorizedboolean允许微信通知带有提醒的开关(仅 iOS 有效)2.6.0
                                                                                                                          notificationBadgeAuthorizedboolean允许微信通知带有标记的开关(仅 iOS 有效)2.6.0
                                                                                                                          notificationSoundAuthorizedboolean允许微信通知带有声音的开关(仅 iOS 有效)2.6.0
                                                                                                                          bluetoothEnabledboolean蓝牙的系统开关2.6.0
                                                                                                                          locationEnabledboolean地理位置的系统开关2.6.0
                                                                                                                          wifiEnabledbooleanWi-Fi 的系统开关2.6.0
                                                                                                                          safeAreaObject在竖屏正方向下的安全区域2.7.0

                                                                                                                          # res.safeArea 的结构

                                                                                                                          属性类型说明
                                                                                                                          leftnumber安全区域左上角横坐标
                                                                                                                          rightnumber安全区域右下角横坐标
                                                                                                                          topnumber安全区域左上角纵坐标
                                                                                                                          bottomnumber安全区域右下角纵坐标
                                                                                                                          widthnumber安全区域的宽度,单位逻辑像素
                                                                                                                          heightnumber安全区域的高度,单位逻辑像素

                                                                                                                          示例代码

                                                                                                                          wx.getSystemInfo({
                                                                                                                            success: (res) => {
                                                                                                                              console.log(res.model);
                                                                                                                              console.log(res.pixelRatio);
                                                                                                                              console.log(res.windowWidth);
                                                                                                                              console.log(res.windowHeight);
                                                                                                                              console.log(res.language);
                                                                                                                              console.log(res.version);
                                                                                                                              console.log(res.platform);
                                                                                                                            },
                                                                                                                          });
                                                                                                                          

                                                                                                                          # Object wx.getSystemInfoSync()

                                                                                                                          wx.getSystemInfo 的同步版本

                                                                                                                          直接返回异步版本的 res

                                                                                                                          示例代码

                                                                                                                          try {
                                                                                                                            const res = wx.getSystemInfoSync();
                                                                                                                          
                                                                                                                            console.log(res.model);
                                                                                                                            console.log(res.pixelRatio);
                                                                                                                            console.log(res.windowWidth);
                                                                                                                            console.log(res.windowHeight);
                                                                                                                            console.log(res.language);
                                                                                                                            console.log(res.version);
                                                                                                                            console.log(res.platform);
                                                                                                                          } catch (err) {
                                                                                                                            // Do something when catch error
                                                                                                                          }
                                                                                                                          

                                                                                                                          # UpdateManager wx.getUpdateManager()

                                                                                                                          获取全局唯一的版本更新管理器,用于管理小程序更新。关于小程序的更新机制,可以查看运行机制文档。

                                                                                                                          返回值: UpdateManager

                                                                                                                          # UpdateManager

                                                                                                                          更新管理器对象,用来管理更新,可通过 wx.getUpdateManager 接口获取实例。UpdateManager 有多个方法

                                                                                                                          # UpdateManager.applyUpdate()

                                                                                                                          强制小程序重启并使用新版本。在小程序新版本下载完成后(即收到 onUpdateReady 回调)调用。

                                                                                                                          # UpdateManager.onCheckForUpdate(function callback)

                                                                                                                          监听向微信后台请求检查更新结果事件。微信在小程序冷启动时自动检查更新,不需由开发者主动触发。

                                                                                                                          Function callback

                                                                                                                          向微信后台请求检查更新结果事件的回调函数

                                                                                                                          参数

                                                                                                                          Object res

                                                                                                                          属性类型说明
                                                                                                                          hasUpdateboolean是否有新版本

                                                                                                                          # UpdateManager.onUpdateReady(function callback)

                                                                                                                          监听小程序有版本更新事件。客户端主动触发下载(无需开发者触发),下载成功后回调

                                                                                                                          # UpdateManager.onUpdateFailed(function callback)

                                                                                                                          监听小程序更新失败事件。小程序有新版本,客户端主动触发下载(无需开发者触发),下载失败(可能是网络原因等)后回调

                                                                                                                          示例代码

                                                                                                                          const updateManager = wx.getUpdateManager();
                                                                                                                          
                                                                                                                          updateManager.onCheckForUpdate((res) => {
                                                                                                                            // 请求完新版本信息的回调
                                                                                                                            console.log(res.hasUpdate);
                                                                                                                          });
                                                                                                                          
                                                                                                                          updateManager.onUpdateReady(() => {
                                                                                                                            wx.showModal({
                                                                                                                              title: "更新提示",
                                                                                                                              content: "新版本已经准备好,是否重启应用? ",
                                                                                                                              success: (res) => {
                                                                                                                                if (res.confirm)
                                                                                                                                  // 新的版本已经下载好,调用 applyUpdate 应用新版本并重启
                                                                                                                                  updateManager.applyUpdate();
                                                                                                                              },
                                                                                                                            });
                                                                                                                          });
                                                                                                                          
                                                                                                                          updateManager.onUpdateFailed(() => {
                                                                                                                            // 新版本下载失败
                                                                                                                          });
                                                                                                                          
                                                                                                                          编辑此页open in new window
                                                                                                                          上次编辑于: 2021/1/19 12:39:17
                                                                                                                          贡献者: Mr.Hope
                                                                                                                          上一页
                                                                                                                          网络 API

                                                                                                                          预览:

                                                                                                                          0  字
                                                                                                                          评论
                                                                                                                          Powered by Waline v2.5.1
                                                                                                                          Copyright © 2019-present Mr.Hope