---
title: "AttachObjectToObject | open.mp"
description: "将物体附加到其他物体上。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachObjectToObject
language: zh-CN
---

# AttachObjectToObject

## 描述

你可以使用此函数将物体附加到其他物体上。被附加的物体会跟随主物体移动。

| 参数 | 说明 |
| --- | --- |
| objectid | 要附加的物体 ID |
| parentid | 目标物体 ID |
| Float:offsetX | 主物体与附加物体在 X 轴方向的距离 |
| Float:offsetY | 主物体与附加物体在 Y 轴方向的距离 |
| Float:offsetZ | 主物体与附加物体在 Z 轴方向的距离 |
| Float:rotationX | 附加物体相对于主物体 X 轴的旋转角度 |
| Float:rotationY | 附加物体相对于主物体 Y 轴的旋转角度 |
| Float:rotationZ | 附加物体相对于主物体 Z 轴的旋转角度 |
| bool:syncRotation | 是否同步旋转（设为`false`时附加物体的旋转不会随主物体改变） |

## 返回值

**true** - 函数执行成功

**false** - 函数执行失败（第一个物体不存在，不检测第二个物体是否存在）

## 示例

```c
new gObjectId = CreateObject(...);
new gAttachToId = CreateObject(...);

AttachObjectToObject(gObjectId, gAttachToId, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, true);
```

## 注意事项

备注

-   在附加操作前必须确保两个物体都已创建
-   SA-MP 原生版本没有玩家物体版的此函数 但 open.mp 提供了[AttachPlayerObjectToObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachPlayerObjectToObject)

## 相关函数

-   [AttachObjectToPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachObjectToPlayer): 将物体附加到玩家
-   [AttachObjectToVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachObjectToVehicle): 将物体附加到车辆
-   [AttachPlayerObjectToPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/AttachPlayerObjectToPlayer): 将玩家物体附加到玩家
-   [CreateObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateObject): 创建物体
-   [DestroyObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyObject): 销毁物体
-   [IsValidObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidObject): 验证物体有效性
-   [MoveObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/MoveObject): 移动物体
-   [StopObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/StopObject): 停止物体移动
-   [SetObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectPos): 设置物体坐标
-   [SetObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetObjectRot): 设置物体旋转
-   [GetObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetObjectPos): 获取物体坐标
-   [GetObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetObjectRot): 获取物体旋转
-   [CreatePlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreatePlayerObject): 为单个玩家创建物体
-   [DestroyPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DestroyPlayerObject): 销毁玩家物体
-   [IsValidPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidPlayerObject): 验证玩家物体有效性
-   [MovePlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/MovePlayerObject): 移动玩家物体
-   [StopPlayerObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/StopPlayerObject): 停止玩家物体移动
-   [SetPlayerObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectPos): 设置玩家物体坐标
-   [SetPlayerObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPlayerObjectRot): 设置玩家物体旋转
-   [GetPlayerObjectPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerObjectPos): 获取玩家物体坐标
-   [GetPlayerObjectRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerObjectRot): 获取玩家物体旋转