Unity与Django REST API交互：可行性及实战指南

可行性说明

Absolutely feasible! 这是连接Unity UI和后端服务的非常成熟的架构，Django REST Framework（DRF）和Unity的内置网络工具适配性极佳——DRF提供标准的RESTful HTTP接口，Unity通过UnityWebRequest就能轻松发起HTTP请求，两者基于通用的HTTP/HTTPS协议和JSON数据格式，天然兼容。很多游戏、交互式应用都在用这种组合实现前端（Unity）和后端（Django）的数据交互。

核心实现步骤

1. 搭建Django REST API端点

先确保你的Django项目配置好DRF，然后创建基础的API接口，比如用户数据的CRUD示例：

# serializers.py
from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'username', 'email']

# views.py
from rest_framework import viewsets
from .models import User
from .serializers import UserSerializer

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer

# urls.py
from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import UserViewSet

router = DefaultRouter()
router.register(r'users', UserViewSet)

urlpatterns = [
    path('api/', include(router.urls)),
]

完成后你会得到/api/users/（获取列表、创建用户）和/api/users/<id>/（单用户操作）的标准REST接口，可以先用Postman或curl测试接口是否正常返回JSON数据。

2. Unity端发起HTTP请求

Unity用UnityWebRequest处理网络请求，必须用协程（Coroutine）异步执行，避免阻塞主线程：

示例1：GET请求获取用户列表

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class DjangoAPIClient : MonoBehaviour
{
    // 替换为你的Django服务器地址
    private const string BaseApiUrl = "http://your-django-server-ip/api/";

    // 可绑定到UI按钮点击事件
    public void FetchUsers()
    {
        StartCoroutine(GetUsersCoroutine());
    }

    private IEnumerator GetUsersCoroutine()
    {
        string requestUrl = $"{BaseApiUrl}users/";
        using (UnityWebRequest webRequest = UnityWebRequest.Get(requestUrl))
        {
            yield return webRequest.SendWebRequest();

            if (webRequest.result != UnityWebRequest.Result.Success)
            {
                Debug.LogError($"请求失败: {webRequest.error}");
                // 这里可以更新UI提示用户出错
            }
            else
            {
                Debug.Log("获取到用户数据: " + webRequest.downloadHandler.text);
                ParseUserList(webRequest.downloadHandler.text);
            }
        }
    }
}

示例2：POST请求创建新用户

private IEnumerator CreateUserCoroutine(string username, string email)
{
    string requestUrl = $"{BaseApiUrl}users/";
    WWWForm form = new WWWForm();
    form.AddField("username", username);
    form.AddField("email", email);

    using (UnityWebRequest webRequest = UnityWebRequest.Post(requestUrl, form))
    {
        yield return webRequest.SendWebRequest();

        if (webRequest.result != UnityWebRequest.Result.Success)
        {
            Debug.LogError($"创建用户失败: {webRequest.error}");
        }
        else
        {
            Debug.Log("用户创建成功!");
            // 可刷新用户列表或更新UI
        }
    }
}

3. 解析JSON数据

Unity自带的JsonUtility可处理简单JSON结构，针对DRF返回的列表（默认包含results字段），需定义对应C#类映射：

// 与Django返回数据对应的类
[System.Serializable]
public class User
{
    public int id;
    public string username;
    public string email;
}

[System.Serializable]
public class UserResponse
{
    public User[] results;
}

// 在GetUsersCoroutine中调用解析方法
private void ParseUserList(string jsonData)
{
    UserResponse userResponse = JsonUtility.FromJson<UserResponse>(jsonData);
    foreach (User user in userResponse.results)
    {
        Debug.Log($"ID: {user.id}, 用户名: {user.username}, 邮箱: {user.email}");
        // 这里可将数据填充到UI列表中
    }
}

如果JSON结构复杂（比如嵌套对象），推荐使用Newtonsoft.Json（Unity商店可免费获取，或通过NuGet导入），它比JsonUtility更灵活。

4. 解决跨域问题（开发阶段）

如果Unity在编辑器或WebGL平台运行，直接请求Django API会触发跨域错误。在Django端安装django-cors-headers解决：

pip install django-cors-headers

修改settings.py：

INSTALLED_APPS = [
    # ...其他应用
    'corsheaders',
]

MIDDLEWARE = [
    'corsheaders.middleware.CorsMiddleware',
    'django.middleware.common.CommonMiddleware',
    # ...其他中间件
]

# 开发环境允许所有来源，生产环境请指定具体域名
CORS_ALLOW_ALL_ORIGINS = True

关键注意事项

• 安全优先：生产环境必须用HTTPS传输数据；可使用DRF的TokenAuthentication做身份验证，Unity请求时在Header添加Authorization: Token your-user-token。
• 异步处理：所有网络请求务必用协程或异步方法，绝对不能在主线程同步执行，否则会导致UI卡顿甚至崩溃。
• 错误处理：要覆盖网络超时、请求失败、后端返回错误码（如400、404、500）的场景，给用户清晰的反馈。

内容的提问来源于stack exchange，提问作者Ines Tlili