---
name: "getGyroCleanRecords"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.7.14" }
  - { name: "基础库", version: "2.29.0" }
title: "清扫记录列表"
---

## getGyroCleanRecords

> [VERSION] @ray-js/ray >= 1.7.14 | 基础库 >= 2.29.0

### 描述

获取陀螺仪扫地机的清扫记录列表

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `GetGyroCleanRecordsParams` | 是 | 查询参数，包含设备 ID、DP 点集合和分页信息 |

### 返回值

类型: `Promise<GetGyroCleanRecordsResponse>`

Promise，resolve 值为陀螺仪清扫记录列表和总数

##### GetGyroCleanRecordsResponse

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `datas` | `GyroCleanRecord[]` | 清扫记录列表 |
| `totalCount` | `number` | 记录总数 |

### 引用对象

##### `interface` GetGyroCleanRecordsParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `dpIds` | `number[]` | DP 点 ID 集合 |
| `offset` | `number` | 分页偏移量 |
| `limit` | `number` | 每页数量 |
| `userId` | `string` | 用户 ID，默认传 '0' |

##### `interface` GyroCleanRecord

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `dpId` | `number` | DP 点 ID |
| `gid` | `number` | 地图 ID |
| `gmtCreate` | `number` | 记录创建时间戳 |
| `recordId` | `string` | 记录 ID |
| `uuid` | `string` | 设备 UUID |
| `value` | `string` | 记录值 |


### 示例代码

```tsx
import React from 'react';
import { Button, getGyroCleanRecords } from '@ray-js/ray';

export default function Demo() {
  const handleFetch = async () => {
    const result = await getGyroCleanRecords({
      devId: 'your-device-id',
      dpIds: [101, 102],
      offset: 0,
      limit: 10,
    });
    console.log(result.datas, result.totalCount);
  };
  return <Button onClick={handleFetch}>获取陀螺仪记录</Button>;
}
```