---
title: "GetActorHealth | open.mp"
description: "获取演员的生命值。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetActorHealth
language: zh-CN
---

# GetActorHealth

注意

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

## 描述

获取演员的生命值。

| 参数 | 说明 |
| --- | --- |
| actorid | 要获取生命值的演员 ID |
| &Float:health | 浮点变量（引用传递），用于存储演员的生命值 |

## 返回值

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

**false** - 函数执行失败（演员未创建）

注意：演员的生命值存储在指定变量中，而非通过返回值获取。

## 示例代码

```c
new gMyActor;

public OnGameModeInit()
{
    gMyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // 在武器商店创建销售员演员

    SetActorHealth(gMyActor, 100.0);

    new Float:actorHealth;
    GetActorHealth(gMyActor, actorHealth);
    printf("演员ID %d 当前生命值：%.2f", gMyActor, actorHealth);
    return 1;
}
```

## 相关函数

-   [CreateActor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateActor): 创建演员（静态 NPC）
-   [SetActorHealth](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetActorHealth): 设置演员的生命值
-   [SetActorInvulnerable](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetActorInvulnerable): 设置演员无敌状态
-   [IsActorInvulnerable](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsActorInvulnerable): 检测演员是否处于无敌状态