---
title: "OnTrailerUpdate | open.mp"
description: "当玩家发送拖车状态更新时触发此回调函数。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnTrailerUpdate
language: zh-CN
---

# OnTrailerUpdate

## 描述

当玩家客户端发送拖车状态同步数据时触发此回调函数。

| 参数 | 说明 |
| --- | --- |
| playerid | 发送拖车状态更新的玩家ID |
| vehicleid | 被更新的拖车ID |

## 返回值

0 - 阻止向其他玩家同步该拖车更新（仍会更新发送者客户端）

1 - 正常处理拖车更新并同步给所有玩家

此回调始终在滤镜脚本中优先触发。

## 示例

```c
public OnTrailerUpdate(playerid, vehicleid)
{
    DetachTrailerFromVehicle(GetPlayerVehicleID(playerid)); // 强制分离拖车
    return 0; // 阻止更新同步
}
```

## 注意事项

注意

此回调触发频率极高（每秒多次/每个拖车），请避免在此执行复杂计算或文件读写操作

## 相关回调

以下回调可能与此回调存在关联：

-   [OnUnoccupiedVehicleUpdate](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnUnoccupiedVehicleUpdate): 当无驾驶员车辆位置同步时触发

## 相关函数

以下函数可能与此回调存在关联：

-   [GetVehicleTrailer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetVehicleTrailer): 获取车辆牵引的拖车ID
-   [IsTrailerAttachedToVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsTrailerAttachedToVehicle): 检测拖车是否连接
-   [AttachTrailerToVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachTrailerToVehicle): 连接拖车到车辆
-   [DetachTrailerFromVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DetachTrailerFromVehicle): 分离拖车连接