---
title: "GetPlayerIp | open.mp"
description: "获取指定玩家的IP地址并存储到字符串中"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerIp
language: zh-CN
---

# GetPlayerIp

## 描述

获取指定玩家的 IP 地址并存储到字符串数组中

| 参数 | 说明 |
| --- | --- |
| playerid | 需要获取 IP 地址的玩家 ID |
| ip\[\] | 存储 IP 地址的字符串数组（通过引用传递） |
| len = sizeof(ip) | IP 地址的最大存储长度（推荐 16 字节） |

## 返回值

**\-1** 表示指定玩家不存在

玩家的 IP 地址将存储在指定的数组中

## 示例代码

```c
public OnPlayerConnect(playerid)
{
    new ipAddress[16];
    GetPlayerIp(playerid, ipAddress, sizeof(ipAddress));
    if (!strcmp(ipAddress, "127.0.0.1"))
    {
        SendClientMessage(playerid, 0xFFFFFFFF, "欢迎来到你的服务器，管理员 :)");
    }
    return 1;
}
```

## 注意事项

备注

-   PAWN 语言区分大小写，错误使用 GetPlayerIP（大写）将无法正常工作
-   **SA-MP 服务端**：在[OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect)回调中使用时将返回无效 IP（255.255.255.255），建议在[OnPlayerConnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerConnect)中保存 IP 地址
-   **open.mp 服务端**：支持在[OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect)回调中正常获取 IP

## 相关函数

-   [NetStats\_GetIpPort](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NetStats_GetIpPort): 获取玩家的 IP 和端口
-   [GetPlayerRawIp](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerRawIp): 获取玩家原始 IP 地址
-   [GetPlayerName](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerName): 获取玩家昵称
-   [GetPlayerPing](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerPing): 获取玩家网络延迟
-   [GetPlayerVersion](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPlayerVersion): 获取玩家客户端版本

## 相关回调

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