---
name: "getPetBehavior"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.6.27" }
title: "getPetBehavior - 获取宠物行为记录分页列表"
---

## getPetBehavior

> [VERSION] @ray-js/ray >= 1.6.27

### 描述

获取宠物行为记录分页列表

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `data` | `GetPetBehavior` | 是 | 请求参数：可选 devId、时间范围、分页 pageNo/pageSize |

### 返回值

类型: `Promise<PetBehavior>`

Promise，resolve 值为行为分页数据（PetBehavior）

##### PetBehavior

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `totalCount` | `number` | 总记录条数 |
| `pageNo` | `number` | 分页页号 |
| `pageSize` | `number` | 分页大小 |
| `hasNext` | `boolean` | 是否还有下一页 |
| `data` | `Object[]` | 进食信息 |

##### PetBehavior.data[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `recordNo` | `string` | 是 | - | 记录no |
| `devId` | `string` | 否 | - | 设备id |
| `deviceName` | `string` | 否 | - | 设备名称（快照） |
| `actionType` | `number` | 是 | - | 行为类型，1-检测到宠物，2-进食 |
| `recordTime` | `number` | 是 | - | 记录时间，单位：毫秒 |
| `isEncrypted` | `0 \| 1` | 是 | - | 文件是否加密，0-否，1-是 |
| `bucketName` | `string` | 是 | - | 云存储文件桶 |
| `fileType` | `string` | 是 | - | 文件类型，image/media |
| `fileDisplay` | `string` | 是 | - | 文件可访问url，未解密的 |
| `fileObjectKey` | `string` | 是 | - | 云存文件对象，fileType是image才会有 |
| `videoCoverObjectKey` | `string` | 是 | - | 视频封面可访问地址，有效期：30-60min |
| `videoDisplay` | `string` | 是 | - | 视频可访问地址，有效期：30-60min |
| `videoPrefix` | `string` | 是 | - | 视频文件前缀，如果用户开通了云存才会有（通过这个获取到视频文件） |
| `videoType` | `string` | 是 | - | 视频文件类型，云存/视频消息 |
| `pets` | `Object[]` | 否 | - | 关联的宠物信息 |
| `extInfo` | `string` | 是 | - | 扩展信息，按宠物类型走，比如宠物进食的开始时间，结束时间 |


##### PetBehavior.data[].pets[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `petId` | `number` | 是 | - | 宠物id |
| `petName` | `string` | 是 | - | 宠物名称 |


### 引用对象

##### `type` GetPetBehavior

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备id（按设备的uuid查询） |
| `startTime` | `number` | 查询开始时间，单位：毫秒 |
| `endTime` | `number` | 查询结束时间，单位：毫秒 |
| `pageNo` | `number` | 页码，从1开始 |
| `pageSize` | `number` | 每页大小 |


### 示例代码

#### 请求示例

```typescript
import { getPetBehavior } from '@ray-js/ray';

getPetBehavior({
  devId: 'vdevo******',
  startTime: 1753315200000,
  endTime: 1753401600000,
  pageNo: 1,
  pageSize: 20,
})
  .then((res) => {
    console.log(res);
  })
  .catch(console.error);
```

#### 返回示例

```json
{
  "totalCount": 0,
  "pageNo": 1,
  "pageSize": 20,
  "hasNext": false,
  "data": []
}
```