Unity3D 如何对接 Python 服务器？-杰瑞科技汇

下面我将为你提供一个从零到一的完整指南,涵盖核心原理、技术选型、代码示例、部署和调试。

（图片来源网络，侵删）

核心原理：为什么能通信？

Unity（使用C#）和Python服务器是两个完全独立的应用程序，它们运行在不同的进程（甚至不同的机器上）中，无法直接共享内存或调用对方的函数。

要让它们“对话”，必须通过网络通信，最常用、最标准的方式是 Socket (套接字) 编程，它基于 TCP/IP 协议。

通信过程就像打电话：

服务器：开启一个“电话”（Socket），并公布一个“号码”（IP地址和端口号），然后一直“等待铃声”（Listen）。
客户端：Unity游戏知道服务器的“号码”（IP和端口），主动“拨打电话”（Connect）。
连接建立：一旦连接成功，双方就可以通过“电话线”（网络流）来回发送“消息”（数据）。

为了能让双方都理解“消息”的内容，我们需要一个数据格式约定，最常用的是 JSON，因为它轻量、易于人类阅读，并且有非常成熟的库在C#和Python中都能轻松解析。

（图片来源网络，侵删）

技术选型

Python 服务器框架

直接用Python原生socket库当然可以，但处理并发、协议解析等会比较繁琐，推荐使用更高级的Web框架，它们封装了底层的Socket细节，让你更专注于业务逻辑。

Flask：轻量级、易于上手，适合中小型项目，非常适合作为API服务器。
FastAPI：现代、高性能、异步支持好，自带API文档，非常适合需要高并发和复杂逻辑的项目。
Socket.IO：如果你的游戏需要实时、双向的通信（如聊天、实时位置同步），而不是简单的请求-响应模式，那么使用Socket.IO是最佳选择，它基于WebSocket，能提供低延迟的连接。

本教程将以最通用的 Flask + JSON 方案为例，因为它覆盖了绝大多数游戏服务器的需求（如玩家登录、获取数据、提交分数等）。

Unity 客户端

Unity使用C#进行网络通信，主要使用两个命名空间：

UnityEngine.Networking：这是较新的API，推荐用于新项目，包含UnityWebRequest用于HTTP请求，以及NetworkBehaviour等用于更复杂的网络同步（如UNET）。
System.Net.Sockets：这是.NET标准库，功能更底层、更强大，可以创建TCP/UDP客户端，对于与自定义Python服务器的通信，System.Net.Sockets有时会更灵活。

本教程将使用 UnityEngine.Networking.UnityWebRequest，因为它与Flask的RESTful API风格完美契合。

实战演练：一个简单的“登录”和“获取玩家数据”示例

我们将创建一个Python服务器,提供两个API接口：

POST /login：接收用户名和密码，返回一个模拟的“Token”。
GET /player_data?token=xxx：接收Token，返回该玩家的数据（如等级、金币）。

步骤1：搭建Python服务器

安装Flask
```
pip install Flask
```

创建 server.py 文件

from flask import Flask, request, jsonify
app = Flask(__name__)
# 模拟一个数据库
# key: token, value: player_data
token_db = {
    "abc123": {"username": "Player1", "level": 5, "coins": 100},
    "def456": {"username": "Player2", "level": 10, "coins": 500}
}
# 1. 登录接口
@app.route('/login', methods=['POST'])
def login():
    # 从请求的JSON body中获取数据
    data = request.get_json()
    username = data.get('username')
    password = data.get('password')
    # 简单的验证逻辑（实际项目中应该查询数据库）
    if username and password:
        # 模拟生成一个token
        token = "token_for_" + username
        print(f"User '{username}' logged in successfully.")
        return jsonify({"status": "success", "token": token}), 200
    else:
        return jsonify({"status": "error", "message": "Invalid username or password"}), 401
# 2. 获取玩家数据接口
@app.route('/player_data', methods=['GET'])
def get_player_data():
    # 从URL的查询参数中获取token
    token = request.args.get('token')
    if token in token_db:
        player_data = token_db[token]
        print(f"Sending data for token '{token}': {player_data}")
        return jsonify(player_data), 200
    else:
        return jsonify({"status": "error", "message": "Invalid or expired token"}), 401
if __name__ == '__main__':
    # 使用 0.0.0.0 可以让其他计算机访问
    # debug=True 在开发时方便，但生产环境必须设为False
    app.run(host='0.0.0.0', port=5000, debug=True)

运行服务器 在终端中执行：
```
python server.py
```
你会看到服务器启动,并监听在 http://0.0.0.0:5000，现在你可以用浏览器或Postman等工具测试这两个API。

步骤2：创建Unity客户端

创建Unity项目，并创建一个场景和一个C#脚本，NetworkManager.cs。

编写C#客户端代码 NetworkManager.cs:

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;
public class NetworkManager : MonoBehaviour
{
    // 服务器的IP地址，如果服务器在本地运行，用 localhost 或 127.0.0.1
    // 如果服务器在另一台电脑，请替换为那台电脑的局域网IP
    private string serverUrl = "http://127.0.0.1:5000";
    void Start()
    {
        // 启动一个协程来执行网络请求
        StartCoroutine(LoginAndGetData());
    }
    IEnumerator LoginAndGetData()
    {
        string username = "Player1";
        string password = "password123";
        // --- 1. 登录请求 ---
        // 创建一个表单数据
        WWWForm loginForm = new WWWForm();
        loginForm.AddField("username", username);
        loginForm.AddField("password", password);
        using (UnityWebRequest loginRequest = UnityWebRequest.Post(serverUrl + "/login", loginForm))
        {
            yield return loginRequest.SendWebRequest();
            if (loginRequest.result == UnityWebRequest.Result.Success)
            {
                // 解析返回的JSON
                LoginResponse loginResponse = JsonUtility.FromJson<LoginResponse>(loginRequest.downloadHandler.text);
                Debug.Log("Login Success! Token: " + loginResponse.token);
                // --- 2. 使用Token获取玩家数据 ---
                StartCoroutine(GetPlayerData(loginResponse.token));
            }
            else
            {
                Debug.LogError("Login Error: " + loginRequest.error);
            }
        }
    }
    IEnumerator GetPlayerData(string token)
    {
        // 使用UnityWebRequest.GET并附加查询参数
        string getPlayerDataUrl = serverUrl + "/player_data?token=" + UnityWebRequest.EscapeURL(token);
        using (UnityWebRequest dataRequest = UnityWebRequest.Get(getPlayerDataUrl))
        {
            yield return dataRequest.SendWebRequest();
            if (dataRequest.result == UnityWebRequest.Result.Success)
            {
                // 解析返回的JSON
                PlayerData playerData = JsonUtility.FromJson<PlayerData>(dataRequest.downloadHandler.text);
                Debug.Log("Player Data Received: " + playerData.username + ", Level: " + playerData.level + ", Coins: " + playerData.coins);
            }
            else
            {
                Debug.LogError("Get Data Error: " + dataRequest.error);
            }
        }
    }
}
// C#类必须与JSON结构完全匹配才能被JsonUtility解析
[System.Serializable]
public class LoginResponse
{
    public string status;
    public string token;
}
[System.Serializable]
public class PlayerData
{
    public string username;
    public int level;
    public int coins;
}

将脚本挂载到场景中，然后运行Unity游戏，你可以在Unity的Console窗口中看到登录和获取数据的成功日志。

部署与进阶

部署Python服务器到公网

想让Unity游戏（发布后）能连接到你的服务器，服务器必须部署在公网上。

云服务器：购买一台阿里云、腾讯云、AWS等云服务器，在上面运行你的Python服务器，这是最稳定的方式。
反向代理：在生产环境中，不要直接用Flask自带的开发服务器，推荐使用 Nginx 作为反向代理。
- 作用1：处理静态文件请求，将动态的API请求转发给Flask。
- 作用2：提供SSL/TLS加密（HTTPS），保障通信安全。
- 作用3：负载均衡，如果未来需要多台服务器，Nginx可以帮你分配流量。
进程管理：不要在服务器终端里直接 python server.py，因为终端关闭，程序就退出了，使用 Gunicorn 或 uWSGI 这样的WSGI服务器来管理你的Flask应用，它们能让你的应用在后台稳定运行，并支持多进程处理并发请求。

进阶技术

异步处理：如果服务器需要执行耗时操作（如AI计算、复杂数据库查询），不要阻塞主线程，在Python中，可以使用 asyncio + FastAPI 来实现异步处理，避免客户端长时间等待。
数据库集成：使用 SQLAlchemy (ORM) 或 PyMongo (MongoDB) 来连接真实的数据库，存储用户数据、游戏存档等。
WebSocket与Socket.IO：对于实时性要求高的游戏（如MOBA、吃鸡），学习并使用 Socket.IO 库，Unity端也需要安装对应的客户端库，实现服务器主动推送消息给所有或部分客户端。
身份验证与安全：永远不要在客户端代码中硬编码服务器密钥，使用Token（如JWT）进行身份验证，并对所有敏感API进行鉴权，对输入数据进行严格校验，防止SQL注入等攻击。

调试技巧

Python端：使用 print() 或 logging 模块在服务器控制台打印日志，这是最直接的调试方式。
Unity端：使用 Debug.Log() 在Unity Console中查看客户端发送和接收的数据。
抓包工具：使用 Fiddler 或 Wireshark 可以捕获网络中所有的数据包，这对于分析复杂的网络问题、确认数据格式是否正确非常有帮助，你可以清楚地看到Unity发送了什么，Python返回了什么。

特性	Python (Flask/FastAPI)	Unity (C#)
角色	服务器	客户端
通信协议	HTTP/RESTful API (常用)	HTTP/UnityWebRequest
数据格式	JSON	JSON (通过JsonUtility)
优势	快速开发、AI/数据分析生态强大、灵活	强大的游戏引擎、跨平台、物理渲染
适用场景	用户认证、数据存储、排行榜、AI逻辑、游戏逻辑后端	渲染、输入处理、物理模拟、UI展示、网络请求

将Unity3D与Python服务器结合,是一个强大且灵活的架构，Python负责处理“大脑”和“数据存储”，Unity负责呈现“身体”和“交互”，希望这份指南能帮助你顺利开启项目！

Unity3D 如何对接 Python 服务器？

核心原理：为什么能通信？