---
name: "onStreamPacketReceive"
mode: "kit"
versionRequirements:
  - { name: "P2PKit", version: "2.0.2" }
  - { name: "@ray-js/ray", version: "1.3.15" }
platform:
  - "iOS"
  - "Android"
async: true
title: "p2p.onStreamPacketReceive - 收到数据包事件"
---

## onStreamPacketReceive

> [VERSION] P2PKit >= 2.0.2 | @ray-js/ray >= 1.3.15

> [PLATFORM] iOS, Android

> ⚡ **支持 Promise 调用** — 不传 success / fail / complete 回调时，该方法返回 Promise。

### 描述

download packet received event

### 参数

`(listener: Function)`

| 参数 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `listener` | `(params: StreamDownloadPacketReceivedEvent) => void` | 是 | - |  |

### 引用对象

##### `interface` StreamDownloadPacketReceivedEvent

| 属性 | 类型 | 最低版本 | 描述 |
| --- | --- | --- | --- |
| `deviceId` | `string` | `2.0.2` | device id |
| `totalFiles` | `number` | `2.0.2` | total files count |
| `fileName` | `string` | `2.0.2` | file name |
| `fileIndex` | `number` | `2.0.2` | file index, dirty data |
| `fileLength` | `number` | `2.0.2` | file length |
| `packetData` | `string` | `2.0.2` | packet data |
| `packetLength` | `number` | `2.0.2` | packet data length |
| `fileSerialNumber` | `number` | `2.0.2` | file serial number |
| `packetIndex` | `number` | `2.0.2` | packet index |
| `packetType` | `number` | `2.0.2` | packet header/packet tail 0b00XY Y:packet header  X:packet tail |


### 示例代码

#### Demo

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

p2p.onStreamPacketReceive(e => {
  console.log(e);
});
```