---
name: "getSystemInfoSync"
mode: "kit"
versionRequirements:
  - { name: "BaseKit", version: "2.0.1" }
  - { name: "@ray-js/ray", version: "0.3.23" }
platform:
  - "iOS"
  - "Android"
title: "getSystemInfoSync - 获取系统信息的同步版本"
---

## getSystemInfoSync

> [VERSION] BaseKit >= 2.0.1 | @ray-js/ray >= 0.3.23

> [PLATFORM] iOS, Android

### 描述

获取系统信息

### 参数

无


### 引用对象

##### `interface` SafeArea

| 属性 | 类型 | 最低版本 | 描述 |
| --- | --- | --- | --- |
| `left` | `number` | `3.2.6` | 左边距 安全区域左边界位置，单位为逻辑像素，例如返回 0 |
| `right` | `number` | `3.2.6` | 右边距 安全区域右边界位置，单位为逻辑像素，例如返回 411 |
| `top` | `number` | `3.2.6` | 上边距 安全区域上边界位置，单位为逻辑像素，例如返回 34 |
| `bottom` | `number` | `3.2.6` | 下边距 安全区域下边界位置，单位为逻辑像素，例如返回 898 |
| `width` | `number` | `3.2.6` | 安全区域宽度，单位为逻辑像素，例如返回 411 |
| `height` | `number` | `3.2.6` | 安全区域高度，单位为逻辑像素，例如返回 864 |


### 合法值

##### `theme` 合法值

| 值 | 说明 |
| --- | --- |
| `"dark"` | 暗黑模式 |
| `"light"` | 亮色模式 |

##### `deviceOrientation` 合法值

| 值 | 说明 |
| --- | --- |
| `"portrait"` | 竖屏 |
| `"landscape"` | 横屏 |


### 示例代码

#### Demo

```tsx
import { getSystemInfo } from '@ray-js/ray'

getSystemInfo({
  success: data => {
    console.log(data);
  },
  fail: error => {
    console.error(error);
  },
});
```