---
title: "连接状态 | open.mp"
description: "NetStats_ConnectionStatus函数使用的连接状态"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/resources/connectionstatus
language: zh-CN
---

# 连接状态

## 描述

本页面包含[NetStats\_ConnectionStatus](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NetStats_ConnectionStatus)使用的连接状态常量。这些常量由 RakNet（SA-MP 使用的网络库）内部使用。

## 常用状态

| ID | 状态（英文常量） | 说明 |
| --- | --- | --- |
| 0 | 无操作状态（CONNECTION\_STATUS\_NO\_ACTION **/** CONNSTAT\_NO\_ACTION） | 当需要向客户端发送数据包时，该操作将由独立线程处理。在此线程发送数据包的过程中，服务器可能同时接收到断开连接的数据包（这种情况可能导致数据竞争，从而引发未定义行为）。为解决此问题，连接状态将切换为 CONNECTION\_STATUS\_NO\_ACTION，此时对玩家 ID 的任何修改都将被暂停，直到更新线程向主线程发出"执行许可"信号。作为服务器开发者，此连接状态与你并无直接关联，因此你可能永远不需要主动处理该状态。 |
| 1 | 立即断开（CONNECTION\_STATUS\_DISCONNECT\_ASAP **/** CONNSTAT\_DISCONNECT\_ASAP） | 客户端将被尽快强制断开连接。在断开流程中 NetStats\_ConnectionStatus 可能返回此值，具体表现为：玩家尚未完成"实质"断开操作，但[OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect)回调可能已为此玩家触发。 |
| 2 | 静默断开（CONNECTION\_STATUS\_DISCONNECT\_ASAP\_SILENTLY **/** CONNSTAT\_DISCONNECT\_ASAP\_SILNT） | 客户端将被立即断开且不发送 ID\_DISCONNECTION\_NOTIFICATION 数据包。SA-MP 在多种场景下触发此状态（尽管 SA-MP 核心逻辑层可能不直接使用，但 RakNet 底层网络库必定会处理），典型案例如：客户端输入错误的服务器密码时。 |
| 3 | 未确认断开（CONNECTION\_STATUS\_DISCONNECT\_ON\_NO\_ACK **/** CONNSTAT\_DISCONNECT\_ON\_NO\_ACK） | 未明确用途。 |
| 4 | 连接请求（CONNECTION\_STATUS\_REQUESTED\_CONNECTION **/** CONNSTAT\_REQUESTED\_CONNECTION） | 客户端已向服务器发起连接请求。 |
| 5 | 处理连接请求（CONNECTION\_STATUS\_HANDLING\_CONNECTION\_REQUEST **/** CONNSTAT\_HANDLING\_CONN\_REQ） | 服务器当前正在处理客户端的连接请求。 |
| 6 | 未验证发送方（CONNECTION\_STATUS\_UNVERIFIED\_SENDER **/** CONNSTAT\_UNVERIFIED\_SENDER） | 初始状态下，所有传入连接请求均标记为 UNVERIFIED\_SENDER。在此状态持续期间，服务器仅会处理 ID\_CONNECTION\_REQUEST 类型的数据包。如果客户端发送其他类型的数据包，服务器将自动终止连接并将该客户端 IP 加入临时黑名单。目前尚不确定[NetStats\_ConnectionStatus](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NetStats_ConnectionStatus)是否可能返回此状态值。 |
| 7 | 加密设置（CONNECTION\_STATUS\_SET\_ENCRYPTION\_ON\_MULTIPLE\_16\_BYTE\_PACKET **/** CONNSTAT\_SET\_ENCRYPTION） | 未明确用途。 |
| 8 | 已连接（CONNECTION\_STATUS\_CONNECTED **/** CONNSTAT\_CONNECTED） | 客户端已成功建立与服务器的连接。 |