---
title: "GetPlayerTargetActor | open.mp"
description: "获取指定玩家正在瞄准的演员ID"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerTargetActor
language: zh-CN
---

# GetPlayerTargetActor

注意

这个函数是在SA-MP 0.3.7中添加的，在以前的版本中不起作用！

## 描述

获取指定玩家当前瞄准的演员（Actor）ID

| 参数 | 说明 |
| --- | --- |
| playerid | 需要获取目标的玩家 ID |

## 返回值

被瞄准的演员 ID，若无目标则返回 `INVALID_ACTOR_ID`

## 示例代码

```c
public OnPlayerUpdate(playerid)
{
    new
        targetActorId = GetPlayerTargetActor(playerid),
        string[32];

    format(string, sizeof(string), "你正在瞄准演员ID %d", targetActorId);
    SendClientMessage(playerid, -1, string);
    return 1;
}
```

## 注意事项

注意

-   不适用于游戏手柄/控制器，且存在有效距离限制。
-   狙击步枪（Sniper Rifle）无法锁定目标，因此不会返回任何演员。

## 相关函数

-   [GetPlayerCameraTargetActor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraTargetActor): 获取玩家视角目标演员（若存在）
-   [GetPlayerCameraFrontVector](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraFrontVector): 获取玩家视角前向向量

## 相关回调

-   [OnPlayerGiveDamageActor](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerGiveDamageActor): 当玩家对演员造成伤害时触发