com.xmobitea.changx.gn-unity 2.0.2 → 2.3.0

package/Runtime/GNNetwork.cs

@@ -1,54 +1,110 @@
 namespace XmobiTea.GN
 {
-    using XmobiTea.GN.Networking;
-    using XmobiTea.GN.Config;
-
     using System;
-
-    using UnityEngine;
+    using System.Threading.Tasks;
+    using XmobiTea.GN.Common;
+    using XmobiTea.GN.Config;
+    using XmobiTea.GN.Constant;
     using XmobiTea.GN.Entity;
-    using XmobiTea.GN.Logger;
     using XmobiTea.GN.Entity.Request;
     using XmobiTea.GN.Entity.Response;
-    using XmobiTea.GN.Constant;
-    using XmobiTea.GN.Common;
+    using XmobiTea.GN.Logger;
+    using XmobiTea.GN.Networking;
 
+    /// <summary>
+    /// Static class GNNetwork handles all the networking logic, including socket and HTTP communication.
+    /// </summary>
     public static partial class GNNetwork
     {
-        private const string GN_VERSION = "2.0";
-
+        /// <summary>
+        /// Current SDK version.
+        /// </summary>
+        private const string GN_VERSION = "2.3";
+
+        /// <summary>
+        /// Key for storing authentication token in PlayerPrefs.
+        /// </summary>
         internal const string AUTH_TOKEN_KEY = "[GN]_AUTH_TOKEN_KEY";
+
+        /// <summary>
+        /// Key for storing user ID in PlayerPrefs.
+        /// </summary>
         internal const string USER_ID_KEY = "[GN]_USER_ID_KEY";
 
+        /// <summary>
+        /// Key for storing game ID in PlayerPrefs.
+        /// </summary>
+        internal const string GAME_ID_KEY = "[GN]_GAME_ID_KEY";
+
+        /// <summary>
+        /// Holds GN server settings loaded from resources.
+        /// </summary>
         public static GNServerSettings gnServerSettings { get; private set; }
 
+        /// <summary>
+        /// Instance of the NetworkingPeer for handling socket connections.
+        /// </summary>
         internal static NetworkingPeer peer { get; private set; }
 
+        /// <summary>
+        /// Gets the current ping in milliseconds.
+        /// </summary>
+        /// <returns>The current ping value, or -1 if no peer exists.</returns>
         public static int getPing() => GNNetwork.peer != null ? GNNetwork.peer.getPing() : -1;
 
+        /// <summary>
+        /// Gets the current socket session ID.
+        /// </summary>
+        /// <returns>The socket session ID, or null if not connected.</returns>
         public static string getSocketSId() => GNNetwork.peer != null ? GNNetwork.peer.getClientId() : null;
 
+        /// <summary>
+        /// Checks if the socket connection is active.
+        /// </summary>
+        /// <returns>True if the socket is connected; otherwise, false.</returns>
         public static bool isSocketConnected() => !string.IsNullOrEmpty(GNNetwork.getSocketSId());
 
+        /// <summary>
+        /// Gets the server's current timestamp in milliseconds.
+        /// </summary>
+        /// <returns>The server's current timestamp, or the local UTC timestamp if no peer exists.</returns>
         public static long getServerTimestamp() => GNNetwork.peer != null ? GNNetwork.peer.getServerTimestamp() : DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
 
+        /// <summary>
+        /// Gets the current authentication status of the connection.
+        /// </summary>
+        /// <returns>The current <see cref="AuthenticateStatus"/> of the peer.</returns>
         public static AuthenticateStatus getAuthenticateStatus() => GNNetwork.peer.authenticateStatus;
 
-        public static RuntimePlatform getPlatform() => Application.platform;
-
+        /// <summary>
+        /// Gets the current override gameId
+        /// </summary>
+        /// <returns></returns>
+        public static string getGameId() => GNNetwork.peer.gameId;
+
+        /// <summary>
+        /// Gets the current platform of the application.
+        /// </summary>
+        /// <returns>The current runtime platform.</returns>
+        public static UnityEngine.RuntimePlatform getPlatform() => UnityEngine.Application.platform;
+
+        /// <summary>
+        /// Static constructor initializes the GNNetwork class.
+        /// </summary>
         static GNNetwork()
         {
             GNNetwork.initServerSettings();
             GNNetwork.initGNDebug();
 
-            if (!Application.isPlaying) return;
+            if (!UnityEngine.Application.isPlaying) return;
 
-            GNDebug.log("GNNetwork init on unity. Version: " + GNNetwork.getClientSdkVersion());
+            GNDebug.log("GNNetwork init on Unity. Version: " + GNNetwork.getClientSdkVersion());
 
             GNNetwork.initGNSocketObject();
 
-            GNNetwork.peer.authenticateStatus.setAuthToken(PlayerPrefs.GetString(GNNetwork.AUTH_TOKEN_KEY, string.Empty));
-            GNNetwork.peer.authenticateStatus.setUserId(PlayerPrefs.GetString(GNNetwork.USER_ID_KEY, string.Empty));
+            GNNetwork.peer.authenticateStatus.setAuthToken(UnityEngine.PlayerPrefs.GetString(GNNetwork.AUTH_TOKEN_KEY, string.Empty));
+            GNNetwork.peer.authenticateStatus.setUserId(UnityEngine.PlayerPrefs.GetString(GNNetwork.USER_ID_KEY, string.Empty));
+            GNNetwork.peer.gameId = UnityEngine.PlayerPrefs.GetString(GNNetwork.GAME_ID_KEY, string.Empty);
 
             GNNetwork.authenticate = new AuthenticateApi();
             GNNetwork.characterPlayer = new CharacterPlayerApi();
@@ -60,30 +116,44 @@
             GNNetwork.masterPlayer = new MasterPlayerApi();
             GNNetwork.storeInventory = new StoreInventoryApi();
             GNNetwork.multiplayer = new MultiplayerApi();
+            GNNetwork.cloudScript = new CloudScriptApi();
         }
 
+        /// <summary>
+        /// Gets the current SDK version.
+        /// </summary>
+        /// <returns>The current SDK version as a string.</returns>
         public static string getClientSdkVersion() => GNNetwork.GN_VERSION;
 
+        /// <summary>
+        /// Initializes server settings from resources.
+        /// </summary>
         private static void initServerSettings()
         {
-            GNNetwork.gnServerSettings = Resources.Load(GNServerSettings.ResourcesPath) as GNServerSettings;
+            GNNetwork.gnServerSettings = UnityEngine.Resources.Load(GNServerSettings.ResourcesPath) as GNServerSettings;
             if (GNNetwork.gnServerSettings == null)
             {
 #if UNITY_EDITOR
                 UnityEditor.EditorApplication.ExecuteMenuItem("XmobiTea GN/Open Settings");
-                GNNetwork.gnServerSettings = Resources.Load(GNServerSettings.ResourcesPath) as GNServerSettings;
+                GNNetwork.gnServerSettings = UnityEngine.Resources.Load(GNServerSettings.ResourcesPath) as GNServerSettings;
                 if (GNNetwork.gnServerSettings == null) throw new NullReferenceException("Null GN Server Settings, please find it now");
 #endif
             }
         }
 
+        /// <summary>
+        /// Initializes GN Debug settings based on the loaded server settings.
+        /// </summary>
         private static void initGNDebug()
         {
-            if (GNNetwork.gnServerSettings == null) throw new NullReferenceException("Null EUN Server Settings, please find it now");
+            if (GNNetwork.gnServerSettings == null) throw new NullReferenceException("Null GN Server Settings, please find it now");
 
             GNDebug.logType = GNNetwork.gnServerSettings.getLogType();
         }
 
+        /// <summary>
+        /// Initializes the socket connection object and its corresponding service update GameObject.
+        /// </summary>
         private static void initGNSocketObject()
         {
             var peer = new NetworkingPeer();
@@ -92,32 +162,189 @@
 
             GNNetwork.peer = peer;
 
-            var serviceUpdate = new GameObject("[GN] ServiceUpdate").AddComponent<Unity.ServiceUpdate>();
-            GameObject.DontDestroyOnLoad(serviceUpdate.gameObject);
+            var serviceUpdate = new UnityEngine.GameObject("[GN] ServiceUpdate").AddComponent<Unity.ServiceUpdate>();
+            UnityEngine.GameObject.DontDestroyOnLoad(serviceUpdate.gameObject);
 
             serviceUpdate.peer = peer;
         }
 
+        public static void setNewAuthenticateStatus(AuthenticateStatus authenticateStatus)
+        {
+            UnityEngine.PlayerPrefs.SetString(GNNetwork.AUTH_TOKEN_KEY, authenticateStatus.getAuthToken());
+            UnityEngine.PlayerPrefs.SetString(GNNetwork.USER_ID_KEY, authenticateStatus.getUserId());
+
+            GNNetwork.peer.authenticateStatus.setAuthToken(authenticateStatus.getAuthToken());
+            GNNetwork.peer.authenticateStatus.setUserId(authenticateStatus.getUserId());
+        }
+
+        public static void setGameId(string gameId)
+        {
+            UnityEngine.PlayerPrefs.SetString(GNNetwork.GAME_ID_KEY, gameId);
+
+            GNNetwork.peer.gameId = gameId;
+        }
+
+        /// <summary>
+        /// Sends a request via socket.
+        /// </summary>
+        /// <param name="requestType">The type of the request.</param>
+        /// <param name="requestRole">The role of the request.</param>
+        /// <param name="request">The request data to send.</param>
+        /// <param name="onResponse">Optional callback for handling the response.</param>
+        /// <param name="overrideAuthToken">Optional token override for the request.</param>
+        /// <param name="overrideSecretKey">Optional secret key override for the request.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
         public static void sendViaSocket(RequestType requestType, RequestRole requestRole, OperationRequest request, Action<OperationResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null)
         {
             GNNetwork.peer.sendViaSocket(requestType, requestRole, request, onResponse, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via socket asynchronously and returns the response.
+        /// </summary>
+        /// <param name="requestType">The type of the request.</param>
+        /// <param name="requestRole">The role of the request.</param>
+        /// <param name="request">The request data.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
+        /// <returns>A Task that resolves with the operation response.</returns>
+        public static Task<OperationResponse> sendViaSocketAsync(RequestType requestType, RequestRole requestRole, OperationRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null)
+        {
+            var taskCompletionSource = new TaskCompletionSource<OperationResponse>();
+
+            GNNetwork.sendViaSocket(requestType, requestRole, request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        /// <summary>
+        /// Sends a request via HTTP.
+        /// </summary>
+        /// <param name="requestType">The type of the request.</param>
+        /// <param name="requestRole">The role of the request.</param>
+        /// <param name="request">The request data.</param>
+        /// <param name="onResponse">Optional callback to handle the response.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
         public static void sendViaHttp(RequestType requestType, RequestRole requestRole, OperationRequest request, Action<OperationResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null)
         {
             GNNetwork.peer.sendViaHttp(requestType, requestRole, request, onResponse, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via HTTP asynchronously and returns the response.
+        /// </summary>
+        /// <param name="requestType">The type of the request.</param>
+        /// <param name="requestRole">The role of the request.</param>
+        /// <param name="request">The request data.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
+        /// <returns>A Task that resolves with the operation response.</returns>
+        public static Task<OperationResponse> sendViaHttpAsync(RequestType requestType, RequestRole requestRole, OperationRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null)
+        {
+            var taskCompletionSource = new TaskCompletionSource<OperationResponse>();
+
+            GNNetwork.sendViaHttp(requestType, requestRole, request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        /// <summary>
+        /// Sends a request via socket with strongly-typed request and response.
+        /// </summary>
+        /// <typeparam name="TRequest">The type of the request.</typeparam>
+        /// <typeparam name="TResponse">The type of the response.</typeparam>
+        /// <param name="request">The request object to send.</param>
+        /// <param name="onResponse">Optional callback to handle the response.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
         public static void sendViaSocket<TRequest, TResponse>(TRequest request, Action<TResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TRequest : CustomOperationRequest where TResponse : CustomOperationResponse, new()
         {
             GNNetwork.sendViaSocket(request.getRequestType(), request.getRequestRole(), request.build(), onResponse, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via socket asynchronously with strongly-typed request and response.
+        /// </summary>
+        /// <typeparam name="TRequest">The type of the request.</typeparam>
+        /// <typeparam name="TResponse">The type of the response.</typeparam>
+        /// <param name="request">The request object to send.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
+        /// <returns>A Task that resolves with the typed response.</returns>
+        public static Task<TResponse> sendViaSocketAsync<TRequest, TResponse>(TRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TRequest : CustomOperationRequest where TResponse : CustomOperationResponse, new()
+        {
+            var taskCompletionSource = new TaskCompletionSource<TResponse>();
+
+            GNNetwork.sendViaSocket<TRequest, TResponse>(request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        // Similar comments for other methods (HTTP variants and generics)
+
+        /// <summary>
+        /// Sends a request via HTTP with strongly-typed request and response.
+        /// </summary>
+        /// <typeparam name="TRequest">The type of the request.</typeparam>
+        /// <typeparam name="TResponse">The type of the response.</typeparam>
+        /// <param name="request">The request object to send.</param>
+        /// <param name="onResponse">Optional callback to handle the response.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
         public static void sendViaHttp<TRequest, TResponse>(TRequest request, Action<TResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TRequest : CustomOperationRequest where TResponse : CustomOperationResponse, new()
         {
             GNNetwork.sendViaHttp(request.getRequestType(), request.getRequestRole(), request.build(), onResponse, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via HTTP asynchronously with strongly-typed request and response.
+        /// </summary>
+        /// <typeparam name="TRequest">The type of the request.</typeparam>
+        /// <typeparam name="TResponse">The type of the response.</typeparam>
+        /// <param name="request">The request object to send.</param>
+        /// <param name="overrideAuthToken">Optional token to override the default authentication token.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default key.</param>
+        /// <param name="customTags">Optional custom tags for the request.</param>
+        /// <returns>A Task that resolves with the typed response.</returns>
+        public static Task<TResponse> sendViaHttpAsync<TRequest, TResponse>(TRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TRequest : CustomOperationRequest where TResponse : CustomOperationResponse, new()
+        {
+            var taskCompletionSource = new TaskCompletionSource<TResponse>();
+
+            GNNetwork.sendViaHttp<TRequest, TResponse>(request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        /// <summary>
+        /// Sends a request via socket with a strongly-typed response.
+        /// </summary>
+        /// <typeparam name="TResponse">The type of the response object.</typeparam>
+        /// <param name="requestType">The type of the request being sent.</param>
+        /// <param name="requestRole">The role of the request being sent.</param>
+        /// <param name="request">The request data to send.</param>
+        /// <param name="onResponse">Optional callback to handle the strongly-typed response.</param>
+        /// <param name="overrideAuthToken">Optional authentication token to override the default value.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default value.</param>
+        /// <param name="customTags">Optional custom tags to send with the request.</param>
         public static void sendViaSocket<TResponse>(RequestType requestType, RequestRole requestRole, OperationRequest request, Action<TResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TResponse : CustomOperationResponse, new()
         {
             GNNetwork.sendViaSocket(requestType, requestRole, request, response =>
@@ -131,6 +358,40 @@
             }, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via socket asynchronously with a strongly-typed response.
+        /// </summary>
+        /// <typeparam name="TResponse">The type of the response object.</typeparam>
+        /// <param name="requestType">The type of the request being sent.</param>
+        /// <param name="requestRole">The role of the request being sent.</param>
+        /// <param name="request">The request data to send.</param>
+        /// <param name="overrideAuthToken">Optional authentication token to override the default value.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default value.</param>
+        /// <param name="customTags">Optional custom tags to send with the request.</param>
+        /// <returns>A Task that resolves to the strongly-typed response.</returns>
+        public static Task<TResponse> sendViaSocketAsync<TResponse>(RequestType requestType, RequestRole requestRole, OperationRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TResponse : CustomOperationResponse, new()
+        {
+            var taskCompletionSource = new TaskCompletionSource<TResponse>();
+
+            GNNetwork.sendViaSocket<TResponse>(requestType, requestRole, request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        /// <summary>
+        /// Sends a request via HTTP with a strongly-typed response.
+        /// </summary>
+        /// <typeparam name="TResponse">The type of the response object.</typeparam>
+        /// <param name="requestType">The type of the request being sent.</param>
+        /// <param name="requestRole">The role of the request being sent.</param>
+        /// <param name="request">The request data to send.</param>
+        /// <param name="onResponse">Optional callback to handle the strongly-typed response.</param>
+        /// <param name="overrideAuthToken">Optional authentication token to override the default value.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default value.</param>
+        /// <param name="customTags">Optional custom tags to send with the request.</param>
         public static void sendViaHttp<TResponse>(RequestType requestType, RequestRole requestRole, OperationRequest request, Action<TResponse> onResponse = null, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TResponse : CustomOperationResponse, new()
         {
             GNNetwork.sendViaHttp(requestType, requestRole, request, response =>
@@ -144,36 +405,87 @@
             }, overrideAuthToken, overrideSecretKey, customTags);
         }
 
+        /// <summary>
+        /// Sends a request via HTTP asynchronously with a strongly-typed response.
+        /// </summary>
+        /// <typeparam name="TResponse">The type of the response object.</typeparam>
+        /// <param name="requestType">The type of the request being sent.</param>
+        /// <param name="requestRole">The role of the request being sent.</param>
+        /// <param name="request">The request data to send.</param>
+        /// <param name="overrideAuthToken">Optional authentication token to override the default value.</param>
+        /// <param name="overrideSecretKey">Optional secret key to override the default value.</param>
+        /// <param name="customTags">Optional custom tags to send with the request.</param>
+        /// <returns>A Task that resolves to the strongly-typed response.</returns>
+        public static Task<TResponse> sendViaHttpAsync<TResponse>(RequestType requestType, RequestRole requestRole, OperationRequest request, string overrideAuthToken = null, string overrideSecretKey = null, GNHashtable customTags = null) where TResponse : CustomOperationResponse, new()
+        {
+            var taskCompletionSource = new TaskCompletionSource<TResponse>();
+
+            GNNetwork.sendViaHttp<TResponse>(requestType, requestRole, request, response =>
+            {
+                taskCompletionSource.SetResult(response);
+            }, overrideAuthToken, overrideSecretKey, customTags);
+
+            return taskCompletionSource.Task;
+        }
+
+        /// <summary>
+        /// Connects to the socket server.
+        /// </summary>
+        /// <param name="_onSocketConnect">Optional callback invoked when the socket is connected.</param>
         public static void connectSocket(Action _onSocketConnect = null)
         {
             GNNetwork.peer.connectSocket(_onSocketConnect);
         }
 
+        /// <summary>
+        /// Disconnects from the socket server.
+        /// </summary>
+        /// <param name="_onSocketDisconnect">Optional callback invoked when the socket is disconnected.</param>
         public static void disconnectSocket(Action _onSocketDisconnect = null)
         {
             GNNetwork.peer.disconnectSocket(_onSocketDisconnect);
         }
 
+        /// <summary>
+        /// Subscribes to event handlers for socket events.
+        /// </summary>
+        /// <param name="_onEventHandler">The handler to invoke when an event occurs.</param>
         public static void setOnEventHandler(Action<OperationEvent> _onEventHandler)
         {
             GNNetwork.peer.setOnEventHandler(_onEventHandler);
         }
 
+        /// <summary>
+        /// Subscribes a handler to be invoked when the socket connects successfully.
+        /// </summary>
+        /// <param name="onConnectHandler">The action to execute when the socket connects.</param>
         public static void subscriberOnConnectHandler(Action onConnectHandler)
         {
             GNNetwork.peer.setOnConnectHandler(onConnectHandler);
         }
 
+        /// <summary>
+        /// Subscribes a handler to be invoked when the socket disconnects.
+        /// </summary>
+        /// <param name="onDisconnectHandler">The action to execute when the socket disconnects.</param>
         public static void subscriberOnDisconnectHandler(Action onDisconnectHandler)
         {
             GNNetwork.peer.setOnDisconnectHandler(onDisconnectHandler);
         }
 
+        /// <summary>
+        /// Unsubscribes a previously subscribed handler for socket connection events.
+        /// </summary>
+        /// <param name="onConnectHandler">The action to remove from connection event handlers.</param>
         public static void unscriberOnConnectHandler(Action onConnectHandler)
         {
             GNNetwork.peer.removeOnConnectHandler(onConnectHandler);
         }
 
+        /// <summary>
+        /// Unsubscribes a previously subscribed handler for socket disconnection events.
+        /// </summary>
+        /// <param name="onDisconnectHandler">The action to remove from disconnection event handlers.</param>
         public static void unsubscriberOnDisconnectHandler(Action onDisconnectHandler)
         {
             GNNetwork.peer.removeOnDisconnectHandler(onDisconnectHandler);

package/Runtime/GNNetworkApi.cs

@@ -1,26 +1,38 @@
 namespace XmobiTea.GN
 {
-    using XmobiTea.GN.Common;
-    using XmobiTea.GN.Entity.Response;
-
     using System;
-    using XmobiTea.GN.Networking;
-    using XmobiTea.GN.Constant;
-    using System.Collections.Generic;
-    using XmobiTea.GN.Entity;
+    using System.Threading.Tasks;
 
     public static partial class GNNetwork
     {
-        public static void SyncTs(Action<long> onResponse = null)
+        /// <summary>
+        /// Synchronizes the timestamp by calling a peer method and invokes the callback with the result.
+        /// </summary>
+        /// <param name="onResponse">An optional callback that receives the synchronized timestamp.</param>
+        public static void syncTs(Action<long> onResponse = null)
         {
+            // Delegate the synchronization to the peer's syncTs method.
             GNNetwork.peer.syncTs(onResponse);
         }
 
-        //public static void AccountLogin(string username, string password, Action<LoginOperationResponse> onResponse = null)
-        //{
-        //    peer.accountLogin(username, password, onResponse);
-        //}
+        /// <summary>
+        /// Asynchronously synchronizes the timestamp and returns the result as a Task.
+        /// </summary>
+        /// <returns>A Task that resolves to the synchronized timestamp.</returns>
+        public static Task<long> syncTsAsync()
+        {
+            // Create a TaskCompletionSource to manage the asynchronous operation.
+            var taskCompletionSource = new TaskCompletionSource<long>();
 
-    }
+            // Call the syncTs method and use the callback to set the Task result.
+            GNNetwork.syncTs(response =>
+            {
+                // Set the result of the Task once the callback is invoked.
+                taskCompletionSource.SetResult(response);
+            });
 
+            // Return the Task to the caller, allowing them to await the result.
+            return taskCompletionSource.Task;
+        }
+    }
 }