---
title: "GetPlayerTargetActor | open.mp"
description: "Obtém a identificação de um ator visado por determinado jogador."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerTargetActor
language: pt-BR
---

# GetPlayerTargetActor

aviso

Esta função foi adicionada no SA-MP 0.3.7 e não funcionará em versões anteriores!

## Descrição

Obtém a identificação de um ator visado por determinado jogador.

| Nome | Descrição |
| --- | --- |
| playerid | O ID do jogador cujo alvo será atingido. |

## Retornos

O ID do ator alvo ou `INVALID_ACTOR_ID` se não houver nenhum.

## Exemplos

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

    format(string, sizeof(string), "You are aiming at actor id %d", targetActorId);
    SendClientMessage(playerid, -1, string);
    return 1;
}
```

## Notas

aviso

-   Não funciona para joypads/controladores e após uma certa distância.
-   Não funciona para o rifle de precisão, pois não trava em nada e, como tal, não pode e não irá devolver um jogador.

## Funções Relacionadas

-   [GetPlayerCameraTargetActor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerCameraTargetActor): Obtenha o ID do ator (se houver) que um jogador está olhando.
-   [GetPlayerCameraFrontVector](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerCameraFrontVector): Obtenha o vetor frontal da câmera do jogador

## Callbacks Relacionadas

-   [OnPlayerGiveDamageActor](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerGiveDamageActor): Este callback é chamado quando um jogador causa dano a um ator.