uni.getDeviceInfo(options?) @getdeviceinfo

# uni.getDeviceInfo(options?)

获取设备信息

# getDeviceInfo 兼容性

Web	Android	iOS
4.0	3.9	4.11

# 参数

名称

类型

必填

默认值

兼容性

描述

options

GetDeviceInfoOptions

否

包含所有字段的过滤对象

[options=包含所有字段的过滤对象]过滤的字段对象, 不传参数默认为获取全部字段。

名称

类型

必备

默认值

兼容性

描述

filter

Array<string>

是

过滤字段的字符串数组，假如要获取指定字段，传入此数组。

# 返回值

类型

GetDeviceInfoResult

名称类型必备默认值兼容性描述

deviceBrand

string

否

设备品牌

deviceId

string

否

设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变

deviceModel

string

否

设备型号

deviceType

string

否

设备类型phone、pad、pc

合法值	兼容性	描述
phone	-	-
pad	-	-
tv	-	-
watch	-	-
pc	-	-
null	-	-
car	-	-
vr	-	-
appliance	-	-

deviceOrientation

string

否

设备方向竖屏 portrait、横屏 landscape

devicePixelRatio

number

否

设备像素比

system

string

否

操作系统及版本

platform

string

否

客户端平台

合法值	兼容性	描述
ios	-	-
android	-	-
harmonyos	-	-
mac	-	-
windows	-	-
linux	-	-

isRoot

boolean

否

是否root。iOS 为是否越狱

isSimulator

boolean

否

是否是模拟器

isUSBDebugging

boolean

否

adb是否开启

osName

string

否

系统名称

合法值	兼容性	描述
ios	-	-
android	-	-
harmonyos	-	-
macos	-	-
windows	-	-
linux	-	-

osVersion

string

否

操作系统版本。如 ios 版本，andriod 版本

osLanguage

string

否

操作系统语言

osTheme

string

否

操作系统主题

合法值	兼容性	描述
light	-	-
dark	-	-

osAndroidAPILevel

number

否

Android 系统API库的版本。

romName

string

否

rom 名称。Android 部分机型获取不到值。iOS 恒为 ios

romVersion

string

否

rom 版本号。Android 部分机型获取不到值。iOS 为操作系统版本号（同 osVersion）。

~~model~~

string

否

设备型号 已废弃，仅为了向下兼容保留

~~brand~~

string

否

设备品牌 已废弃，仅为了向下兼容保留

注意事项

获取OAID、AndroidID等其他设备信息，见插件市场
romName值域候选详见
app平台devicePixelRatio属性，HBuilderX4.22及以下版本类型为string，HBuilderX4.23版本调整为number
调用此api会获取传感器列表，建议在同意隐私协议后再调用，或者按需加载需要的信息，例：

uni.getDeviceInfo({filter:["brand"]})

# 示例

hello uni-app x

Template

Script

<template>
  <!-- #ifdef APP -->
  <scroll-view class="page-scroll-view">
  <!-- #endif -->
    <view>
      <page-head :title="title"></page-head>
      <view class="uni-common-mt">
        <view class="uni-list">
          <view class="uni-list">
            <view class="uni-list-cell" v-for="(item, _) in items" style="align-items: center">
              <view class="uni-pd">
                <view class="uni-label" style="width: 180px">{{
                  item.label
                }}</view>
              </view>
              <view class="uni-list-cell-db">
                <text style="width: 100%">{{
                  item.value == "" ? "未获取" : item.value
                }}</text>
              </view>
            </view>
          </view>
        </view>
        <view class="uni-padding-wrap">
          <view class="uni-btn-v">
            <button type="primary" @tap="getDeviceInfo">获取设备信息</button>
          </view>
        </view>
      </view>
    </view>
  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>


<style>
  .uni-pd {
    padding-left: 15px;
  }
</style>