useSystemInfo

获取系统信息

何时使用

当需要获取系统信息做一些判断时

API

const systemInfo = useSystemInfo();

参数说明

无

返回值说明

systemInfo

参数	类型	说明
SDKVersion	string	客户端基础库版本
albumAuthorized	boolean	允许微信使用相册的开关（仅 iOS 有效）
benchmarkLevel	number	设备性能等级（仅 Android 小游戏）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好，目前最高不到 50）
bluetoothEnabled	boolean	蓝牙的系统开关
brand	string	设备品牌
cameraAuthorized	boolean	允许微信使用摄像头的开关
fontSizeSetting	number	用户字体大小（单位 px）。以微信客户端「我-设置-通用-字体大小」中的设置为准
language	string	微信设置的语言
locationAuthorized	boolean	允许微信使用定位的开关
locationEnabled	boolean	地理位置的系统开关
microphoneAuthorized	boolean	允许微信使用麦克风的开关
model	string	设备型号
notificationAlertAuthorized	boolean	允许微信通知带有提醒的开关（仅 iOS 有效）
notificationAuthorized	boolean	允许微信通知的开关
notificationBadgeAuthorized	boolean	允许微信通知带有标记的开关（仅 iOS 有效）
notificationSoundAuthorized	boolean	允许微信通知带有声音的开关（仅 iOS 有效）
pixelRatio	number	设备像素比
platform	string	客户端平台
safeArea	SafeAreaResult	在竖屏正方向下的安全区域
screenHeight	number	屏幕高度，单位 px
screenWidth	number	屏幕宽度，单位 px
statusBarHeight	number	状态栏的高度，单位 px
system	string	操作系统及版本
version	string	微信版本号
wifiEnabled	boolean	Wi-Fi 的系统开关
windowHeight	number	可使用窗口高度，单位 px
windowWidth	number	可使用窗口宽度，单位 px
errMsg	string	调用结果

代码演示

React

basic/useSystemInfo/index

import React from 'react';
import DemoContent from '@src/components/DemoContent';
import { Cell } from '@taroify/core';
import { useSystemInfo } from 'taro-hooks';

export default () => {
  const systemInfo = useSystemInfo();

  return (
    <DemoContent>
      <Cell.Group clickable>
        {Object.entries(systemInfo!).map(([key, value]) => (
          <Cell key={key} title={key} brief={JSON.stringify(value)}></Cell>
        ))}
      </Cell.Group>
    </DemoContent>
  );
};

Vue

basic/useSystemInfo/index

<template>
  <demo-content>
    <nut-cell
      v-for="(value, key) in systemInfo"
      :key="key"
      :title="key"
      :sub-title="$filters.stringify(value)"
    ></nut-cell>
  </demo-content>
</template>

<script setup lang="ts">
import { useSystemInfo } from 'taro-hooks';

const systemInfo = useSystemInfo();
</script>

Hook 支持度

微信小程序	H5	ReactNative
✔️	✔️	✔️