---
title: "GetPlayerCameraTargetActor | open.mp"
description: "允许你获取玩家当前正在注视的演员（若有）的ID。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraTargetActor
language: zh-CN
---

# GetPlayerCameraTargetActor

注意

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

## 描述

获取玩家当前正在注视的演员（若有）的 ID。

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

## 返回值

玩家正在注视的演员 ID（若无可视演员则返回 INVALID\_ACTOR\_ID）

## 示例代码

```c
new bool:ActorHandsup[MAX_ACTORS];

public OnPlayerConnect(playerid)
{
    EnablePlayerCameraTarget(playerid, true);
    return 1;
}

public OnPlayerUpdate(playerid)
{
    // 检测玩家当前注视的演员（若有）
    new playerTargetActor = GetPlayerCameraTargetActor(playerid);

    if (playerTargetActor != INVALID_ACTOR_ID)
    {
        // 获取玩家当前武器以检测是否持械
        new playerWeapon = GetPlayerWeapon(playerid);

        // 获取玩家按键状态以检测是否处于瞄准状态
        new KEY:keys, updown, leftright;
        GetPlayerKeys(playerid, keys, updown, leftright);

        // 若演员未举手且玩家持械瞄准
        if (!ActorHandsup[playerTargetActor] && playerWeapon >= 22 && playerWeapon <= 42 && keys & KEY_AIM)
        {
            // 应用举手动画
            ApplyActorAnimation(playerTargetActor, "SHOP", "SHP_HandsUp_Scr", 4.1, 0, 0, 0, 1, 0);

            // 标记演员已举手状态
            ActorHandsup[playerTargetActor] = true;
        }
    }
    return 1;
}
```

## 注意事项

技巧

此函数仅返回玩家视角方向上的演员 ID，如需检测玩家是否正在瞄准该演员，请使用[GetPlayerTargetActor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerTargetActor)

注意

此函数默认禁用以节省带宽，需使用[EnablePlayerCameraTarget](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/EnablePlayerCameraTarget)为每个玩家单独启用

## 相关函数

-   [GetPlayerTargetActor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerTargetActor): 获取指定玩家正在瞄准的演员 ID
-   [GetPlayerCameraTargetPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraTargetPlayer): 获取玩家当前注视的玩家 ID
-   [GetPlayerCameraTargetVehicle](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraTargetVehicle): 获取玩家当前注视的车辆 ID
-   [GetPlayerCameraTargetObject](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraTargetObject): 获取玩家当前注视的物体 ID
-   [GetPlayerCameraFrontVector](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerCameraFrontVector): 获取玩家视角前向向量