feat(网络): 添加应用获得焦点时发送心跳包的功能

添加 SetFocusHeartbeat 方法控制网络频道在应用获得焦点时是否发送心跳包
在 NetworkComponent 中添加 m_FocusHeartbeat 配置项和 OnApplicationFocus 回调
更新 NetworkChannelBase 实现心跳包发送逻辑的条件判断

Author: AlianBlank

Editor/Inspector/NetworkComponentInspector.cs

@@ -43,10 +43,12 @@ internal sealed class NetworkComponentInspector : ComponentTypeComponentInspecto
         private SerializedProperty m_IgnoredSendNetworkIds;
         private SerializedProperty m_IgnoredReceiveNetworkIds;
         private SerializedProperty m_rpcTimeout;
+        private SerializedProperty m_FocusHeartbeat;
 
         private readonly GUIContent m_IgnoredSendNetworkIdsGUIContent = new GUIContent("Ignore Log Printing For Sent Message IDs");
         private readonly GUIContent m_IgnoredReceiveNetworkIdsGUIContent = new GUIContent("Ignore Log Printing Of Received Message IDs");
         private readonly GUIContent m_rpcTimeoutGUIContent = new GUIContent("RPC Timeout Time In Milliseconds");
+        private readonly GUIContent m_FocusHeartbeatGUIContent = new GUIContent("Focus Send Heartbeat");
 
         public override void OnInspectorGUI()
         {
@@ -56,6 +58,7 @@ public override void OnInspectorGUI()
             {
                 GUI.enabled = !EditorApplication.isPlaying;
                 EditorGUILayout.IntSlider(m_rpcTimeout, 3000, 50000, m_rpcTimeoutGUIContent);
+                EditorGUILayout.PropertyField(m_FocusHeartbeat, m_FocusHeartbeatGUIContent);
                 EditorGUILayout.PropertyField(m_IgnoredSendNetworkIds, m_IgnoredSendNetworkIdsGUIContent);
                 EditorGUILayout.PropertyField(m_IgnoredReceiveNetworkIds, m_IgnoredReceiveNetworkIdsGUIContent);
                 GUI.enabled = false;
@@ -121,6 +124,7 @@ protected override void Enable()
             m_IgnoredSendNetworkIds = serializedObject.FindProperty("m_IgnoredSendNetworkIds");
             m_IgnoredReceiveNetworkIds = serializedObject.FindProperty("m_IgnoredReceiveNetworkIds");
             m_rpcTimeout = serializedObject.FindProperty("m_rpcTimeout");
+            m_FocusHeartbeat = serializedObject.FindProperty("m_FocusHeartbeat");
         }
     }
 }

Runtime/Network/Interface/INetworkManager.cs

@@ -105,5 +105,11 @@ public interface INetworkManager
         /// <param name="channelName">网络频道名称。</param>
         /// <returns>是否销毁网络频道成功。</returns>
         bool DestroyNetworkChannel(string channelName);
+
+        /// <summary>
+        /// 设置是否在应用程序获得焦点时发送心跳包。
+        /// </summary>
+        /// <param name="hasFocus">是否在应用程序获得焦点时发送心跳包。</param>
+        void SetFocusHeartbeat(bool hasFocus);
     }
 }

Runtime/Network/Network/NetworkManager.NetworkChannelBase.cs

@@ -115,6 +115,11 @@ public abstract class NetworkChannelBase : INetworkChannel, IDisposable
             /// </summary>
             protected int PReceivedPacketCount;
 
+            /// <summary>
+            /// 是否在应用程序获得焦点时发送心跳包
+            /// </summary>
+            protected bool PFocusHeartbeat;
+
             /// <summary>
             /// 是否正在连接中
             /// </summary>
@@ -179,6 +184,7 @@ public NetworkChannelBase(string name, INetworkChannelHelper networkChannelHelpe
                 PSentPacketCount = 0;
                 PReceivedPacketCount = 0;
                 PActive = false;
+                PFocusHeartbeat = true;
                 PIsConnecting = false;
                 m_Disposed = false;
                 NetworkChannelConnected = null;
@@ -449,15 +455,18 @@ private void ProcessHeartBeat(float realElapseSeconds)
                             PHeartBeatState.MissHeartBeatCount++;
                         }
 
-                        if (sendHeartBeat && PNetworkChannelHelper.SendHeartBeat())
+                        if (sendHeartBeat && PFocusHeartbeat)
                         {
-                            if (missHeartBeatCount > 0 && NetworkChannelMissHeartBeat != null)
+                            if (PNetworkChannelHelper.SendHeartBeat())
                             {
-                                NetworkChannelMissHeartBeat(this, missHeartBeatCount);
-                            }
+                                if (missHeartBeatCount > 0 && NetworkChannelMissHeartBeat != null)
+                                {
+                                    NetworkChannelMissHeartBeat(this, missHeartBeatCount);
+                                }
 
-                            // PHeartBeatState.Reset(this.ResetHeartBeatElapseSecondsWhenReceivePacket);
-                            return;
+                                // PHeartBeatState.Reset(this.ResetHeartBeatElapseSecondsWhenReceivePacket);
+                                return;
+                            }
                         }
 
                         if (PHeartBeatState.MissHeartBeatCount > MissHeartBeatCountByClose)
@@ -967,6 +976,11 @@ public void SetIgnoreLogNetworkIds(List<int> sendIds, List<int> receiveIds)
                 IgnoreSendIds = sendIds;
                 IgnoreReceiveIds = receiveIds;
             }
+
+            public void SetFocusHeartbeat(bool hasFocus)
+            {
+                PFocusHeartbeat = hasFocus;
+            }
         }
     }
 }

Runtime/Network/Network/NetworkManager.cs

@@ -246,6 +246,14 @@ public bool DestroyNetworkChannel(string channelName)
             return false;
         }
 
+        public void SetFocusHeartbeat(bool hasFocus)
+        {
+            foreach (var networkChannel in m_NetworkChannels.Values)
+            {
+                networkChannel.SetFocusHeartbeat(hasFocus);
+            }
+        }
+
         private void OnNetworkChannelConnected(NetworkChannelBase networkChannel, object userData)
         {
             if (m_NetworkConnectedEventHandler != null)

Runtime/Network/NetworkComponent.cs

@@ -62,6 +62,11 @@ public sealed class NetworkComponent : GameFrameworkComponent
         /// </summary>
         [SerializeField] private int m_rpcTimeout = 5000;
 
+        /// <summary>
+        /// 是否在应用程序获得焦点时发送心跳包,默认为true
+        /// </summary>
+        [SerializeField] private bool m_FocusHeartbeat = true;
+
         /// <summary>
         /// 获取网络频道数量。
         /// </summary>
@@ -70,6 +75,22 @@ public int NetworkChannelCount
             get { return m_NetworkManager.NetworkChannelCount; }
         }
 
+        /// <summary>
+        /// 是否正在游戏中。
+        /// </summary>
+        private bool _isGaming = true;
+
+        /// <summary>
+        /// 应用程序获得或失去焦点时调用。
+        /// </summary>
+        /// <param name="hasFocus">应用程序是否获得焦点。</param>
+        private void OnApplicationFocus(bool hasFocus)
+        {
+            _isGaming = hasFocus;
+            m_NetworkManager.SetFocusHeartbeat(hasFocus);
+            Log.Info($"SetFocusHeartbeat: {hasFocus}");
+        }
+
         /// <summary>
         /// 游戏框架组件初始化。
         /// </summary>