萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android UDP 協議開發完整指南

UDP 協議基礎概念

UDP (User Datagram Protocol,使用者資料報協議) 是傳輸層無連線、不可靠的協議。與 TCP 的面向連線、可靠傳輸不同,UDP 不建立連線、不保證送達、不保證順序、不進行流量控制,但延遲極低、開銷極小,適合即時性要求高、容忍少量丟包的場景。

TCP vs UDP 核心差異對照

特性TCPUDP
連線建立三向交握 (SYN, SYN-ACK, ACK)無連線,直接發送
可靠性保證送達、重傳、排序不保證,可能丟包、亂序、重複
流量控制滑動視窗、拮塞控制無
標頭開銷20-60 bytes8 bytes (固定)
傳輸單位位元組流資料報
典型應用HTTP/HTTPS、郵件、檔案傳輸、SSHDNS、VoIP、即時遊戲、串流、IoT

Android UDP 程式設計完整範例

UDP 發送端 (Client)

public class UdpSender {
    private static final String TAG = "UdpSender";
    private final DatagramSocket socket;
    private final InetAddress serverAddress;
    private final int serverPort;
    private final ExecutorService executor = Executors.newSingleThreadExecutor();

    public UdpSender(String serverIp, int serverPort) throws SocketException, UnknownHostException {
        this.socket = new DatagramSocket();
        this.serverAddress = InetAddress.getByName(serverIp);
        this.serverPort = serverPort;
        // 可選:設定發送緩衝區大小
        socket.setSendBufferSize(64 * 1024);
    }

    public void send(String message) {
        executor.execute(() -> {
            try {
                byte[] data = message.getBytes(StandardCharsets.UTF_8);
                DatagramPacket packet = new DatagramPacket(data, data.length, serverAddress, serverPort);
                socket.send(packet);
                Log.d(TAG, "Sent: " + message + " to " + serverAddress + ":" + serverPort);
            } catch (IOException e) {
                Log.e(TAG, "Send failed", e);
            }
        });
    }

    public void send(byte[] data) {
        executor.execute(() -> {
            try {
                DatagramPacket packet = new DatagramPacket(data, data.length, serverAddress, serverPort);
                socket.send(packet);
            } catch (IOException e) {
                Log.e(TAG, "Send bytes failed", e);
            }
        });
    }

    public void close() {
        executor.shutdown();
        socket.close();
    }
}

// 使用範例
UdpSender sender = new UdpSender("192.168.1.100", 8888);
sender.send("Hello UDP Server");
// 發送二進位資料
sender.send(serializeGameState());
sender.close();

UDP 接收端 (Server)

public class UdpReceiver {
    private static final String TAG = "UdpReceiver";
    private final DatagramSocket socket;
    private final int port;
    private final Handler mainHandler = new Handler(Looper.getMainLooper());
    private final List listeners = new CopyOnWriteArrayList<>();
    private volatile boolean running = false;
    private Thread receiveThread;

    public interface UdpMessageListener {
        void onMessageReceived(String message, InetAddress fromAddress, int fromPort);
        void onBinaryReceived(byte[] data, InetAddress fromAddress, int fromPort);
    }

    public UdpReceiver(int port) throws SocketException {
        this.port = port;
        this.socket = new DatagramSocket(port);
        socket.setSoTimeout(1000); // 設定超時以便定期檢查 running 旗標
        socket.setReceiveBufferSize(256 * 1024); // 增加接收緩衝區
    }

    public void start() {
        running = true;
        receiveThread = new Thread(this::receiveLoop, "UdpReceiver-Thread");
        receiveThread.start();
    }

    public void stop() {
        running = false;
        socket.close(); // 關閉 socket 會中斷阻塞的 receive()
        if (receiveThread != null) {
            receiveThread.interrupt();
        }
    }

    private void receiveLoop() {
        byte[] buffer = new byte[65507]; // UDP 最大資料報大小 (65535 - 8 UDP header - 20 IP header)
        DatagramPacket packet = new DatagramPacket(buffer, buffer.length);
        
        while (running && !socket.isClosed()) {
            try {
                socket.receive(packet); // 阻塞等待
                int length = packet.getLength();
                InetAddress clientAddress = packet.getAddress();
                int clientPort = packet.getPort();
                
                // 複製實際接收到的資料
                byte[] receivedData = Arrays.copyOf(buffer, length);
                String message = new String(receivedData, StandardCharsets.UTF_8);
                
                // 切換到主執行緒回調
                mainHandler.post(() -> {
                    for (UdpMessageListener listener : listeners) {
                        listener.onMessageReceived(message, clientAddress, clientPort);
                        listener.onBinaryReceived(receivedData, clientAddress, clientPort);
                    }
                });
            } catch (SocketTimeoutException ignored) {
                // 正常超時,檢查 running 旗標
            } catch (IOException e) {
                if (running) Log.e(TAG, "Receive error", e);
            }
        }
    }

    public void addListener(UdpMessageListener listener) {
        listeners.add(listener);
    }

    public void removeListener(UdpMessageListener listener) {
        listeners.remove(listener);
    }
}

// Activity 中使用
public class MainActivity extends AppCompatActivity implements UdpReceiver.UdpMessageListener {
    private UdpReceiver receiver;
    private UdpSender sender;
    private TextView logTextView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        logTextView = findViewById(R.id.log_text);
        
        try {
            receiver = new UdpReceiver(8888);
            receiver.addListener(this);
            receiver.start();
            
            sender = new UdpSender("192.168.1.255", 8888); // 廣播地址
            // 啟用廣播權限
            sender.getSocket().setBroadcast(true);
        } catch (IOException e) {
            Log.e("MainActivity", "UDP init failed", e);
        }
    }

    @Override
    public void onMessageReceived(String message, InetAddress from, int port) {
        runOnUiThread(() -> logTextView.append("\n[UDP] " + from.getHostAddress() + ":" + port + " - " + message));
    }

    @Override
    public void onBinaryReceived(byte[] data, InetAddress from, int port) {
        // 處理二進位協議
    }

    public void sendBroadcast(View view) {
        sender.send("Broadcast from Android: " + System.currentTimeMillis());
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        receiver?.stop();
        sender?.close();
    }
}

Android 權限與網路配置

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 廣播發送需要 (Android 10+ 限制較多) -->
<uses-permission android:name="android.permission.BROADCAST_STICKY" />

<application
    android:usesCleartextTraffic="true"  <!-- 允許明文流量 (HTTP/UDP) -->
    ...>

進階主題:可靠 UDP (RUDP) 簡易實作

UDP 本身不可靠,但在遊戲/即時通訊中常需「可靠有序」傳輸。核心機制:

  • 序號 (Sequence Number):每個封包遞增 ID
  • 確認機制 (ACK):接收端回傳 ACK
  • 重傳機制:超時未收到 ACK 重發
  • 視窗控制:滑動視窗限制在途封包數
// 簡易 RUDP 封包結構
public class RudpPacket {
    public static final byte TYPE_DATA = 1;
    public static final byte TYPE_ACK = 2;
    public static final byte TYPE_HEARTBEAT = 3;

    public final int sequenceId;
    public final byte type;
    public final byte[] payload;
    public final long timestamp;

    public RudpPacket(int sequenceId, byte type, byte[] payload) {
        this.sequenceId = sequenceId;
        this.type = type;
        this.payload = payload;
        this.timestamp = System.currentTimeMillis();
    }

    // 序列化為 byte[]
    public byte[] toBytes() { /* 實作序列化 */ }
    
    // 從 byte[] 反序列化
    public static RudpPacket fromBytes(byte[] data) { /* 實作解析 */ }
}

常見坑點與優化建議

  1. 緩衝區太小導致丟包:setReceiveBufferSize(256KB+)、setSendBufferSize(64KB+)
  2. 主執行緒阻塞:收發務必在背景執行緒,使用 ExecutorService 或 Coroutine
  3. 廣播地址限制:Android 10+ 限制非系統應用發送廣播,建議使用組播或已知 IP
  4. NAT 穿透:P2P 通訊需 STUN/TURN/ICE 框架 (如 libjingle, pjnath)
  5. IPv6 相容:使用 InetAddress.getByName() 自動解析,DatagramSocket 支援雙棧
  6. 電池優化:長連接需 WakeLock 或 WorkManager 定期心跳

適用場景選型建議

  • ✅ 即時遊戲:位置同步、狀態廣播 (可容忍丟包,需低延遲)
  • ✅ 語音/視訊通話:RTP over UDP、WebRTC
  • ✅ IoT 裝置發現:SSDP、mDNS、自訂廣播
  • ✅ 日誌/遙測上報:非關鍵資料、火力全開發送
  • ❌ 檔案傳輸、API 請求、支付、登入:需可靠性,請用 TCP/HTTP/QUIC

總結

UDP 在 Android 上透過 DatagramSocket 實作簡單,但「不可靠」特性要求應用層自行處理重傳、排序、流控。對於即時互動場景,建議直接使用成熟框架(WebRTC、Netty UDP、QUIC/Cronet、ENet、LiteNetLib),而非手工實作 RUDP。理解 UDP 特性、正確配置緩衝區、處理執行緒與權限,是打造高效能網路應用的關鍵。

copyright © 萬盛學電腦網 all rights reserved