> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stmlink.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> 对外开放的服务端接口有两组前缀，都用同一套鉴权：`/server/v1/...`（SRTC 与 SMeeting 的主接口）和 `/stm/srvapi/v1/...`（SMeeting 的用户体系，服务端极简对接会用到）。鉴权是 app_id + nonce + timestamp + signature 四个请求头，用 app_key 做 HMAC-SHA256 签名，只能从业务方自己的后端调用。除这两组前缀外的接口均为内部接口，不要建议客户调用。
> app_key 是服务端密钥，绝不能出现在客户端代码、前端配置或移动 App 里。客户端加入频道用的 token 必须由业务方后端签发后下发（SRTC 走 `/server/v1/channel/grant`，SMeeting 走 `/stm/srvapi/v1/member/grant`）。
> SRTC 与 SMeeting 是上下两层不同的产品，术语不通用：SRTC 是音视频底座，说「频道 channel」「加入 / 退出」；SMeeting 建在 SRTC 之上，说「房间 room」「会议 meeting」「进入 / 退出」。回答时按用户所在的层用对应术语，不要把「房间」「会议」安到 SRTC 的接口上。
> 同一能力在各端 SDK 里的包名、类名、方法名并不相同。写示例代码时请使用文档中该端自己的 API，不要把一个端的写法套到另一个端上。苹果平台每个产品都有两套 SDK（Swift 原生与 Objective-C），两套 API 不能混用。

# MeetingLocalVideoFrameEvent

> 接收本地视频 YUV 帧以及采集尺寸或摄像头方向变化

`MeetingLocalVideoFrameEvent` 接收显式订阅的本地视频帧，通过 `MeetingEngine.localVideoFrameEvent` 注册。可继承 `MeetingLocalVideoFrameSimpleEvent` 按需覆写。

## 使用说明

* 该事件跟随 Engine 的本地摄像头采集链路，不要求已经加入会议；赋 `null` 即停止向应用转发帧。
* 回调保持 SRTC 视频采集线程，不得执行磁盘、网络或其他耗时操作。`yuv` 是为外部调用方复制的数据，可在控制内存占用的前提下保存。

## 接口方法

### onLocalVideoFrame(yuv, width, height, stamp, format, facing)

```kotlin theme={null}
fun onLocalVideoFrame(
    yuv: ByteArray?,
    width: Int,
    height: Int,
    stamp: Long,
    format: Int,
    facing: Int
)
```

方法说明：返回一帧本地 YUV 视频数据。

参数说明：

| 参数       | 说明             |
| -------- | -------------- |
| `yuv`    | 可空 YUV 帧数据。    |
| `width`  | 画面宽度，单位像素。     |
| `height` | 画面高度，单位像素。     |
| `stamp`  | 帧时间戳。          |
| `format` | SRTC 定义的像素格式值。 |
| `facing` | 摄像头方向值。        |

返回值说明：无（`Unit`）。

### onLocalVideoFrameSizeChanged(width, height, facing)

```kotlin theme={null}
fun onLocalVideoFrameSizeChanged(width: Int, height: Int, facing: Int)
```

方法说明：本地视频采集尺寸或摄像头方向发生变化。

参数说明：

| 参数       | 说明        |
| -------- | --------- |
| `width`  | 新的画面宽度。   |
| `height` | 新的画面高度。   |
| `facing` | 新的摄像头方向值。 |

返回值说明：无（`Unit`）。