Unity局域网设备发现(LanDiscovery)实现与Android优化

1. 项目背景与核心需求

在多人联机游戏开发中，局域网设备发现（LanDiscovery）是一个基础但关键的功能模块。它允许同一网络下的设备自动发现彼此，无需玩家手动输入IP地址。对于使用Unity引擎开发、且需要兼容Android平台和Netcode for GameObjects（NGO）框架的项目来说，实现一个稳定可靠的LanDiscovery系统需要考虑以下几个核心问题：

• 跨平台兼容性：Android系统对网络权限和后台运行的限制比PC更严格
• NGO集成：需要与Unity官方推荐的Netcode for GameObjects网络框架无缝衔接
• 性能开销：广播探测包不能影响游戏主线程的运行效率
• 安全性：防止伪造主机和中间人攻击等基础防护

我在最近一个休闲竞技手游项目中，就遇到了需要同时支持PC和Android设备自动组队的场景。经过三个版本的迭代，最终实现了一套平均发现延迟<200ms、CPU占用<3%的解决方案。下面将分享具体实现路径和关键代码。

2. 基础架构设计与协议选型

2.1 UDP广播与组播方案对比

局域网发现通常有两种实现方式：

在移动端实测中发现：

• 华为/小米设备在WiFi休眠状态下会丢弃普通广播包
• 公共场合路由器常禁用组播（如学校、商场WiFi）
• Android 10+需要额外申请CHANGE_WIFI_MULTICAST_STATE权限

最终采用双模式自动切换策略：

csharp复制// 检测网络环境
if (NetworkUtils.SupportsMulticast()) {
    useMulticast = true;
    multicastGroup = IPAddress.Parse("239.255.255.250"); // 标准局域网点播地址
} else {
    useBroadcast = true;
    broadcastAddress = IPAddress.Broadcast;
}

2.2 消息协议设计

一个完整的发现协议需要包含以下字段：

json复制{
    "protocol": "LANv1",
    "gameId": "com.yourstudio.awesomegame",
    "version": "1.2.0",
    "hostName": "Player2_Android",
    "port": 7777,
    "isHost": true,
    "playerCount": 3,
    "customData": {}
}

关键设计要点：

1. gameId：防止不同游戏互相干扰
2. version：处理版本兼容问题
3. isHost：区分普通客户端和主机
4. TTL：设置合理的存活时间（建议2-3秒）

注意：Android 9+限制后台应用发送广播，需要添加FOREGROUND_SERVICE权限并在代码中创建前台服务通知。

3. Unity端完整实现

3.1 网络组件初始化

首先创建核心管理器脚本LanDiscovery.cs：

csharp复制using UnityEngine;
using Unity.Netcode;
using System.Net;
using System.Net.Sockets;
using System.Threading;

public class LanDiscovery : NetworkBehaviour 
{
    [SerializeField] private ushort discoveryPort = 47777;
    [SerializeField] private float broadcastInterval = 1f;
    
    private UdpClient udpClient;
    private Thread listenThread;
    private bool isRunning;
    private float lastBroadcastTime;
    
    private void Start() {
        if (IsServer) StartServerDiscovery();
        else StartClientDiscovery();
    }

    private void OnDestroy() {
        StopDiscovery();
    }
}

3.2 主机端广播实现

主机需要定期广播自己的存在：

csharp复制private void StartServerDiscovery() {
    try {
        udpClient = new UdpClient();
        udpClient.EnableBroadcast = true;
        
        isRunning = true;
        listenThread = new Thread(ServerListen);
        listenThread.Start();
        
        InvokeRepeating(nameof(BroadcastPresence), 0, broadcastInterval);
    } catch (SocketException e) {
        Debug.LogError($"Discovery init failed: {e.Message}");
    }
}

private void BroadcastPresence() {
    var data = new DiscoveryData {
        gameId = Application.identifier,
        version = Application.version,
        hostName = System.Environment.MachineName,
        port = NetworkManager.Singleton.NetworkConfig.NetworkTransport.GetConnectionPort(),
        isHost = true
    };
    
    byte[] bytes = Encoding.UTF8.GetBytes(JsonUtility.ToJson(data));
    
    if (useMulticast) {
        udpClient.Send(bytes, bytes.Length, new IPEndPoint(multicastGroup, discoveryPort));
    } else {
        udpClient.Send(bytes, bytes.Length, new IPEndPoint(IPAddress.Broadcast, discoveryPort));
    }
}

3.3 客户端监听实现

客户端需要持续监听并处理收到的广播：

csharp复制private void StartClientDiscovery() {
    try {
        udpClient = new UdpClient(discoveryPort);
        if (useMulticast) {
            udpClient.JoinMulticastGroup(multicastGroup);
        }
        
        isRunning = true;
        listenThread = new Thread(ClientListen);
        listenThread.Start();
    } catch (SocketException e) {
        Debug.LogError($"Discovery listen failed: {e.Message}");
    }
}

private void ClientListen() {
    IPEndPoint remoteEP = new IPEndPoint(IPAddress.Any, 0);
    
    while (isRunning) {
        try {
            byte[] data = udpClient.Receive(ref remoteEP);
            string json = Encoding.UTF8.GetString(data);
            var discoveryData = JsonUtility.FromJson<DiscoveryData>(json);
            
            if (discoveryData.gameId == Application.identifier) {
                UnityMainThreadDispatcher.Instance.Enqueue(() => {
                    OnServerDiscovered?.Invoke(discoveryData);
                });
            }
        } catch (Exception ex) {
            if (isRunning) Debug.LogWarning(ex.Message);
        }
    }
}

4. Android平台特殊处理

4.1 权限配置

在AndroidManifest.xml中添加以下权限：

xml复制<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

4.2 后台限制规避

Android 8+的后台限制会导致UDP包被丢弃，需要启动前台服务：

csharp复制#if UNITY_ANDROID
private void StartForegroundService() {
    using (var unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) {
        using (var activity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity")) {
            using (var serviceClass = new AndroidJavaClass("com.yourcompany.discovery.DiscoveryService")) {
                serviceClass.CallStatic("startService", activity);
            }
        }
    }
}
#endif

对应的Java服务代码：

java复制public class DiscoveryService extends Service {
    private static final int NOTIFICATION_ID = 1001;
    
    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Notification notification = new Notification.Builder(this)
            .setContentTitle("Game Discovery")
            .setContentText("Searching for local games...")
            .setSmallIcon(R.drawable.notification_icon)
            .build();
            
        startForeground(NOTIFICATION_ID, notification);
        return START_STICKY;
    }
}

5. 与Netcode for GameObjects集成

5.1 网络初始化协调

在发现主机后自动连接NGO：

csharp复制private void HandleServerDiscovered(DiscoveryData data) {
    if (NetworkManager.Singleton.IsClient) return;
    
    Debug.Log($"Connecting to {data.hostName}...");
    
    NetworkManager.Singleton.NetworkConfig.ConnectionData = 
        Encoding.UTF8.GetBytes(data.gameId);
    
    NetworkManager.Singleton.StartClient();
}

5.2 连接验证

在NetworkManager的验证回调中添加游戏ID检查：

csharp复制void Awake() {
    NetworkManager.Singleton.ConnectionApprovalCallback += (request, response) => {
        string gameId = Encoding.UTF8.GetString(request.Payload);
        if (gameId != Application.identifier) {
            response.Approved = false;
            response.Reason = "Invalid game ID";
        }
    };
}

6. 性能优化与调试技巧

6.1 带宽控制策略

通过动态调整广播频率降低负载：

csharp复制private float GetAdaptiveBroadcastInterval() {
    int playerCount = NetworkManager.Singleton.ConnectedClients.Count;
    return Mathf.Clamp(broadcastInterval * (1 + playerCount * 0.2f), 0.5f, 3f);
}

6.2 调试工具实现

开发期可视化调试面板：

csharp复制#if UNITY_EDITOR
private void OnGUI() {
    GUILayout.BeginArea(new Rect(10, 10, 300, 200));
    GUILayout.Label($"Discovery Status: {(isRunning ? "Active" : "Inactive")}");
    
    if (IsServer) {
        GUILayout.Label($"Last Broadcast: {Time.time - lastBroadcastTime:F1}s ago");
    } else {
        GUILayout.Label($"Discovered Hosts: {discoveredHosts.Count}");
        foreach (var host in discoveredHosts.Values) {
            if (GUILayout.Button($"{host.hostName} ({host.playerCount} players)")) {
                ConnectToHost(host);
            }
        }
    }
    GUILayout.EndArea();
}
#endif

6.3 常见问题排查

1. Android设备无法发现主机：

   • 检查是否添加了CHANGE_WIFI_MULTICAST_STATE权限
   • 确认设备没有进入WiFi节能模式
   • 测试时关闭防火墙或杀毒软件

2. 广播包被丢弃：

   • 减小广播包大小（建议<512字节）
   • 在AndroidManifest中添加android:usesCleartextTraffic="true"

3. NGO连接失败：

   • 确保两端使用相同的Unity Transport版本
   • 检查NetworkConfig中的协议版本是否匹配

这套实现方案在我们项目的实际测试中，在50台设备组成的局域网环境下，平均发现延迟为187ms，CPU占用峰值2.8%，内存开销稳定在3MB以内。最关键的是正确处理了Android平台的各种限制条件，保证了在各种网络环境下的可靠运行。