---
title: "IsPlayerConnected | open.mp"
description: "检查玩家是否已连接"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerConnected
language: zh-CN
---

# IsPlayerConnected

## 描述

检测指定玩家 ID 是否对应已连接玩家。

| 参数 | 说明 |
| --- | --- |
| playerid | 需要检查的玩家 ID |

## 返回值

**true** - 玩家已连接  
**false** - 玩家未连接

## 示例

```c
KillPlayer(playerid)
{
    if (!IsPlayerConnected(playerid))
    {
        printf("玩家ID %i 未连接！", playerid);
    }
    else
    {
        SetPlayerHealth(playerid, 0.0);
    }
}
```

## 注意事项

技巧

许多其他函数已内置连接状态检查，实际开发中可酌情省略此函数调用

## 相关函数

-   [IsPlayerAdmin](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerAdmin): 检查玩家是否具有 RCON 管理员权限

## 相关回调

-   [OnPlayerConnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerConnect): 玩家连接服务器时触发
-   [OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect): 玩家断开连接时触发