[新增] EdgeLinkManager 加入設備 timeout 偵測機制與範例更新

- OnDeviceTimeout：超過 deviceTimeoutSeconds 沒收到訊息觸發（TCP/UDP 通用）
- OnDeviceReconnected：超時設備重新送資料時觸發
- Inspector 可設定 deviceIdKey 和 deviceTimeoutSeconds
- Example.cs 示範三種事件的完整用法

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Reymer

SDK/Unity/Package/Runtime/EdgeLinkManager.cs

@@ -23,19 +23,32 @@ public enum Protocol { TCP, TCPListener, UDP }
     [HideInInspector] public string kvSeparator    = ":";
     [HideInInspector] public string outputTemplate = "{raw}";
 
+    [Tooltip("訊息中代表設備 ID 的欄位名稱，留空則不追蹤 timeout")]
+    public string deviceIdKey         = "id";
+    [Tooltip("超過幾秒沒收到訊息視為設備離線（0 = 停用）")]
+    public float  deviceTimeoutSeconds = 20f;
+
     private EdgeLinkClient      tcp;
     private EdgeLinkTcpListener tcpListener;
     private EdgeLinkUdpClient   udp;
 
-    private readonly Dictionary<string, string> latest = new();
+    private readonly Dictionary<string, string> latest      = new();
+    private readonly Dictionary<string, float>  lastSeenTime = new();
+    private readonly HashSet<string>             timedOut     = new();
     private readonly System.Collections.Concurrent.ConcurrentQueue<(bool, string)> deviceStatusQueue = new();
 
     public string Raw { get; private set; }
 
-    /// <summary>Fired on Unity main thread when an upstream device connects/disconnects.
-    /// bool = isConnected, string = endpoint (e.g. "TCPServer@192.168.1.50:9001")</summary>
+    /// <summary>Fired on Unity main thread when an upstream device connects/disconnects (TCP only).
+    /// bool = isConnected, string = endpoint (e.g. "TCPServer@192.168.1.50")</summary>
     public event Action<bool, string> OnDeviceStatus;
 
+    /// <summary>Fired on Unity main thread when a device ID stops sending data beyond deviceTimeoutSeconds.</summary>
+    public event Action<string> OnDeviceTimeout;
+
+    /// <summary>Fired on Unity main thread when a previously timed-out device sends data again.</summary>
+    public event Action<string> OnDeviceReconnected;
+
     public string Get(string key) =>
         latest.TryGetValue(key, out string val) ? val : null;
 
@@ -130,13 +143,37 @@ private void Update()
 
         while (deviceStatusQueue.TryDequeue(out var ds))
             OnDeviceStatus?.Invoke(ds.Item1, ds.Item2);
+
+        CheckDeviceTimeouts();
+    }
+
+    private void CheckDeviceTimeouts()
+    {
+        if (deviceTimeoutSeconds <= 0 || string.IsNullOrEmpty(deviceIdKey)) return;
+
+        foreach (var kv in lastSeenTime)
+        {
+            bool isTimedOut = Time.time - kv.Value > deviceTimeoutSeconds;
+            if (isTimedOut && !timedOut.Contains(kv.Key))
+            {
+                timedOut.Add(kv.Key);
+                OnDeviceTimeout?.Invoke(kv.Key);
+            }
+        }
     }
 
     private void Handle(string msg)
     {
         Raw = msg;
         var parsed = Parse(msg);
         foreach (var kv in parsed) latest[kv.Key] = kv.Value;
+
+        if (!string.IsNullOrEmpty(deviceIdKey) && parsed.TryGetValue(deviceIdKey, out string deviceId))
+        {
+            lastSeenTime[deviceId] = Time.time;
+            if (timedOut.Remove(deviceId))
+                OnDeviceReconnected?.Invoke(deviceId);
+        }
     }
 
     private void OnDestroy()

SDK/Unity/Package/Samples~/Basic/Example.cs

@@ -1,5 +1,13 @@
 using UnityEngine;
 
+/// <summary>
+/// EdgeLink 基本範例 — 多設備資料讀取、斷線偵測
+///
+/// Inspector 設定：
+///   edgeLinkObject → 掛有 EdgeLinkManager 的 GameObject
+///   deviceIdKey    → 訊息中代表設備 ID 的欄位（預設 "id"）
+///   deviceTimeout  → 超過幾秒沒收到資料視為斷線（預設 20 秒）
+/// </summary>
 public class Example : MonoBehaviour
 {
     public GameObject edgeLinkObject;
@@ -10,17 +18,41 @@ public class Example : MonoBehaviour
     void Start()
     {
         edgeLink = edgeLinkObject.GetComponent<EdgeLinkManager>();
+
+        // TCP 正常斷線 / 拔電後 ~15 秒偵測到（EdgeLink PING/PONG 超時）
+        edgeLink.OnDeviceStatus += (connected, endpoint) =>
+        {
+            string ip = endpoint.Contains("@") ? endpoint.Split('@')[1] : endpoint;
+            if (connected)
+                Debug.Log($"[EdgeLink] 設備上線  IP: {ip}");
+            else
+                Debug.LogWarning($"[EdgeLink] 設備斷線  IP: {ip}");
+        };
+
+        // Timeout 偵測：超過 deviceTimeoutSeconds 沒收到訊息（TCP / UDP 通用）
+        edgeLink.OnDeviceTimeout += deviceId =>
+        {
+            Debug.LogWarning($"[EdgeLink] 設備 {deviceId} 超時，可能已離線");
+        };
+
+        // 超時設備重新送資料
+        edgeLink.OnDeviceReconnected += deviceId =>
+        {
+            Debug.Log($"[EdgeLink] 設備 {deviceId} 重新上線");
+        };
     }
 
     void Update()
     {
+        // 只在新訊息到達時處理
         if (edgeLink.Raw == lastRaw) return;
         lastRaw = edgeLink.Raw;
 
+        string id     = edgeLink.Get("id");
         string temp   = edgeLink.Get("temp");
         string humid  = edgeLink.Get("humid");
         string status = edgeLink.Get("status");
 
-        Debug.Log($"溫度:{temp} 濕度:{humid} 狀態:{status}");
+        Debug.Log($"[{id}] 溫度:{temp} 濕度:{humid} 狀態:{status}");
     }
 }