com.xd.sdk.tap 0.0.6-xd.1

package/Core/Standalone/Runtime/Internal/Http/TapHttpException.cs

@@ -0,0 +1,79 @@
+using System;
+using System.Net;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    public abstract class AbsTapHttpException : Exception
+    {
+        public AbsTapHttpException(string message) : base(message)
+        {
+        }
+
+        protected AbsTapHttpException(string message, Exception e) : base(message, e)
+        {
+        }
+    }
+
+    public class TapHttpUnknownException : AbsTapHttpException
+    {
+        public TapHttpUnknownException(Exception e) : base("Unknown error", e)
+        {
+        }
+    }
+
+    public class TapHttpNetworkErrorException : AbsTapHttpException
+    {
+        public TapHttpNetworkErrorException(string msg) : base("network error")
+        {
+            
+        }
+    }
+
+    public class TapHttpInvalidResponseException : AbsTapHttpException
+    {
+        public HttpStatusCode StatusCode { get; }
+
+        public TapHttpInvalidResponseException(HttpStatusCode statusCode, string message)
+            : base(message)
+        {
+            StatusCode = statusCode;
+        }
+    }
+
+    /// <summary>
+    /// 表示 TapSDK 中与 Http 相关的服务端返回的错误信息。
+    /// </summary>
+    public class TapHttpServerException : AbsTapHttpException
+    {
+        /// <summary>
+        ///  获取服务器返回的 HTTP 状态码。
+        /// </summary>
+        public HttpStatusCode StatusCode { get; }
+
+        /// <summary>
+        /// 获取服务器返回的 Response。
+        /// </summary>
+        public TapHttpResponse TapHttpResponse { get; }
+
+        /// <summary>
+        /// 获取服务器返回的 Response Error Data。
+        /// </summary>
+        public TapHttpErrorData ErrorData { get; }
+
+        /// <summary>
+        /// 初始化 <see cref="TapHttpServerException"/> 类的新实例。
+        /// </summary>
+        /// <param name="statusCode">服务器返回的 HTTP 状态码。</param>
+        /// <param name="code">与异常相关的自定义错误代码。</param>
+        /// <param name="msg">错误消息。</param>
+        /// <param name="error">服务器返回的错误标识符。</param>
+        /// <param name="errorDescription">错误的详细描述。</param>
+        public TapHttpServerException(HttpStatusCode statusCode, TapHttpResponse tapHttpResponse, TapHttpErrorData tapHttpErrorData)
+            : base(tapHttpErrorData.Msg)
+        {
+            StatusCode = statusCode;
+            TapHttpResponse = tapHttpResponse ?? throw new ArgumentNullException(nameof(tapHttpResponse));
+            ErrorData = tapHttpErrorData ?? throw new ArgumentNullException(nameof(tapHttpErrorData));
+        }
+    }
+}

package/Core/Standalone/Runtime/Internal/Http/TapHttpException.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d3f8dc471e1b04052ba0833a4dec7cee
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Core/Standalone/Runtime/Internal/Http/TapHttpParser.cs

@@ -0,0 +1,136 @@
+using System;
+using System.Net;
+using System.Net.Http;
+using System.Threading.Tasks;
+using Newtonsoft.Json;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    /// <summary>
+    /// 表示一个 HTTP 解析器的接口。
+    /// Represents an HTTP parser interface.
+    /// </summary>
+    public interface ITapHttpParser
+    {
+        /// <summary>
+        /// 解析 HTTP 响应。
+        /// Parses the HTTP response.
+        /// </summary>
+        /// <typeparam name="T">解析后返回的对象类型。The type of the object to return after parsing.</typeparam>
+        /// <param name="response">HTTP 响应消息。The HTTP response message.</param>
+        /// <returns>解析结果。The parsing result.</returns>
+        Task<TapHttpResult<T>> Parse<T>(HttpResponseMessage response);
+    }
+
+    /// <summary>
+    /// 提供 HTTP 解析功能的类。
+    /// Class that provides HTTP parsing functionality.
+    /// </summary>
+    public class TapHttpParser
+    {
+        /// <summary>
+        /// 创建默认的 HTTP 解析器。
+        /// Creates a default HTTP parser.
+        /// </summary>
+        /// <returns>返回一个实现了 ITapHttpParser 接口的解析器。Returns a parser that implements the ITapHttpParser interface.</returns>
+        public static ITapHttpParser CreateDefaultParser()
+        {
+            return new Default();
+        }
+
+        public static ITapHttpParser CreateEventParser()
+        {
+            return new Event();
+        }
+
+        private class Event : ITapHttpParser
+        {
+            public Task<TapHttpResult<T>> Parse<T>(HttpResponseMessage response)
+            {
+                _ = response ?? throw new ArgumentNullException(nameof(response));
+                HttpStatusCode statusCode = response.StatusCode;
+                if (statusCode >= HttpStatusCode.OK && statusCode < HttpStatusCode.MultipleChoices)
+                {
+                    return Task.FromResult(TapHttpResult<T>.Success(default));
+                }
+                else
+                {
+                    return Task.FromResult(TapHttpResult<T>.UnknownFailure(default));
+                }
+            }
+
+        }
+
+        private class Default : ITapHttpParser
+        {
+            /// <summary>
+            /// 解析 HTTP 响应。
+            /// Parses the HTTP response.
+            /// </summary>
+            /// <typeparam name="T">解析后返回的对象类型。The type of the object to return after parsing.</typeparam>
+            /// <param name="response">HTTP 响应消息。The HTTP response message.</param>
+            /// <returns>解析结果。The parsing result.</returns>
+            public async Task<TapHttpResult<T>> Parse<T>(HttpResponseMessage response)
+            {
+                _ = response ?? throw new ArgumentNullException(nameof(response));
+                HttpStatusCode statusCode = response.StatusCode;
+                // 读取响应内容
+                // Read the response content
+                string content = await response.Content.ReadAsStringAsync();
+
+                // 处理响应
+                // Handle the response
+                TapHttpResponse httpResponse;
+                try
+                {
+                    httpResponse = JsonConvert.DeserializeObject<TapHttpResponse>(content);
+                    // 设置当前服务端返回的事件戳
+                    if (httpResponse.Now > 0){
+                        TapHttpTime.ResetLastServerTime(httpResponse.Now);
+                    }
+                }
+                catch (Exception)
+                {
+                    return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "Failed to parse TapHttpResponse"));
+                }
+                if (httpResponse == null)
+                {
+                    return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "TapHttpResponse is null"));
+                }
+
+                if (httpResponse.Success)
+                {
+                    // 修正时间
+                    // Fix the time
+                    TapHttpTime.FixTime(httpResponse.Now);
+                    if (httpResponse.Data == null)
+                    {
+                        return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "TapHttpResponse.Data is null"));
+                    }
+                    try
+                    {
+                        T data = httpResponse.Data.ToObject<T>();
+                        if (data == null)
+                        {
+                            return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "TapHttpResponse.Data is null"));
+                        }
+                        return TapHttpResult<T>.Success(data);
+                    }
+                    catch (Exception)
+                    {
+                        return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "Failed to parse TapHttpResponse.Data"));
+                    }
+                }
+                else
+                {
+                    TapHttpErrorData httpErrorData = httpResponse.Data?.ToObject<TapHttpErrorData>();
+                    if (httpErrorData == null)
+                    {
+                        return TapHttpResult<T>.InvalidResponseFailure(new TapHttpInvalidResponseException(statusCode, "TapHttpErrorData is null"));
+                    }
+                    return TapHttpResult<T>.ServerFailure(new TapHttpServerException((HttpStatusCode)statusCode, httpResponse, httpErrorData));
+                }
+            }
+        }
+    }
+}

package/Core/Standalone/Runtime/Internal/Http/TapHttpParser.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: ab2c195f6902f4a6da00ffc255b8378d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Core/Standalone/Runtime/Internal/Http/TapHttpResponse.cs

@@ -0,0 +1,37 @@
+using System;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+
+    [Serializable]
+    public class TapHttpResponse
+    {
+        [JsonProperty("data")]
+        public JObject Data { get; private set; }
+
+        [JsonProperty("success")]
+        public bool Success { get; private set; }
+
+        [JsonProperty("now")]
+        public int Now { get; private set; }
+    }
+
+    [Serializable]
+    public class TapHttpErrorData
+    {
+        [JsonProperty("code")]
+        public int Code { get; private set; }
+
+        [JsonProperty("msg")]
+        public string Msg { get; private set; }
+
+        [JsonProperty("error")]
+        public string Error { get; private set; }
+
+        [JsonProperty("error_description")]
+        public string ErrorDescription { get; private set; }
+    }
+
+}

package/Core/Standalone/Runtime/Internal/Http/TapHttpResponse.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1c88fae64652a4577a0f71aafa0f468a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Core/Standalone/Runtime/Internal/Http/TapHttpResult.cs

@@ -0,0 +1,99 @@
+using System;
+using System.Net;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    /// <summary>
+    /// 表示 HTTP 错误类型的枚举。
+    /// </summary>
+
+    /// <summary>
+    /// 表示 TapSDK 中 HTTP 请求的结果。
+    /// </summary>
+    public class TapHttpResult<T>
+    {
+        /// <summary>
+        /// 指示请求是否成功。
+        /// </summary>
+        public bool IsSuccess { get; private set; }
+
+        /// <summary>
+        /// HTTP 请求的响应内容。
+        /// </summary>
+        public T Data { get; private set; }
+
+        /// <summary>
+        /// 错误类型，区分网络错误、客户端错误、服务器错误等。
+        /// </summary>
+        public AbsTapHttpException HttpException { get; private set; }
+
+        /// <summary>
+        /// 私有构造函数，防止直接实例化。
+        /// </summary>
+        private TapHttpResult()
+        {
+        }
+
+        /// <summary>
+        /// 创建一个成功的 HTTP 请求结果。
+        /// </summary>
+        /// <param name="response">HTTP 响应的内容。</param>
+        /// <returns>TapHttpResult 对象，表示成功的请求。</returns>
+        public static TapHttpResult<T> Success(T data)
+        {
+            return new TapHttpResult<T>
+            {
+                IsSuccess = true,
+                Data = data,
+            };
+        }
+
+        /// <summary>
+        /// 创建一个失败的 HTTP 请求结果，通常是网络错误或客户端错误。
+        /// </summary>
+        /// <param name="errorType">错误类型，例如网络错误或客户端错误。</param>
+        /// <param name="exception">异常对象，用于传递错误详情（可选）。</param>
+        /// <returns>TapHttpResult 对象，表示失败的请求。</returns>
+        public static TapHttpResult<T> InvalidResponseFailure(TapHttpInvalidResponseException exception)
+        {
+            return new TapHttpResult<T>
+            {
+                IsSuccess = false,
+                HttpException = exception
+            };
+        }
+
+        /// <summary>
+        /// 创建一个服务端返回的错误结果。
+        /// </summary>
+        /// <param name="httpException">包含详细服务端错误信息的异常对象。</param>
+        /// <returns>TapHttpResult 对象，表示服务端错误的请求。</returns>
+        public static TapHttpResult<T> ServerFailure(TapHttpServerException httpException)
+        {
+            return new TapHttpResult<T>
+            {
+                IsSuccess = false,
+                HttpException = httpException,
+            };
+        }
+
+        public static TapHttpResult<T> UnknownFailure(TapHttpUnknownException httpException)
+        {
+            return new TapHttpResult<T>
+            {
+                IsSuccess = false,
+                HttpException = httpException,
+            };
+        }
+
+        public static TapHttpResult<T> NetworkError(TapHttpNetworkErrorException httpException)
+        {
+            return new TapHttpResult<T>
+            {
+                IsSuccess = false,
+                HttpException = httpException,
+            };
+        }
+
+    }
+}

package/Core/Standalone/Runtime/Internal/Http/TapHttpResult.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4c7f303ab4c084015a8c2b75cb268c04
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Core/Standalone/Runtime/Internal/Http/TapHttpRetryStrategy.cs

@@ -0,0 +1,237 @@
+using System;
+using System.Net;
+using System.Threading;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    /// <summary>
+    /// 重试策略接口。
+    /// </summary>
+    public interface ITapHttpRetryStrategy
+    {
+        /// <summary>
+        /// 获取下次重试的时间（毫秒）。
+        /// </summary>
+        /// <param name="errorType">错误类型。</param>
+        /// <param name="e">异常信息。</param>
+        /// <returns>下次重试的时间（毫秒），如果不重试返回 -1。</returns>
+        long NextRetryMillis(AbsTapHttpException e);
+    }
+
+    /// <summary>
+    /// 后退策略接口。
+    /// </summary>
+    public interface ITapHttpBackoffStrategy
+    {
+        /// <summary>
+        /// 获取下一个后退的时间（毫秒）。
+        /// </summary>
+        /// <returns>下一个后退的时间（毫秒）。</returns>
+        long NextBackoffMillis();
+
+        /// <summary>
+        /// 判断是否可以重试无效时间。
+        /// </summary>
+        /// <returns>如果可以重试返回 true，否则返回 false。</returns>
+        bool CanInvalidTimeRetry();
+
+        /// <summary>
+        /// 重置策略状态。
+        /// </summary>
+        void Reset();
+    }
+
+    /// <summary>
+    /// HTTP 重试策略实现。
+    /// </summary>
+    public class TapHttpRetryStrategy
+    {
+        /// <summary>
+        /// 创建默认重试策略。
+        /// </summary>
+        /// <param name="backoffStrategy">后退策略。</param>
+        /// <returns>默认重试策略。</returns>
+        public static ITapHttpRetryStrategy CreateDefault(ITapHttpBackoffStrategy backoffStrategy)
+        {
+            return new Default(backoffStrategy);
+        }
+
+        /// <summary>
+        /// 创建不重试策略。
+        /// </summary>
+        /// <returns>不重试策略。</returns>
+        public static ITapHttpRetryStrategy CreateNone()
+        {
+            return new None();
+        }
+
+        private class None : ITapHttpRetryStrategy
+        {
+            public long NextRetryMillis(AbsTapHttpException e)
+            {
+                // 不重试返回 -1
+                return -1L;
+            }
+        }
+
+        private class Default : ITapHttpRetryStrategy
+        {
+            private readonly ITapHttpBackoffStrategy backoffStrategy;
+
+            public Default(ITapHttpBackoffStrategy backoffStrategy)
+            {
+                this.backoffStrategy = backoffStrategy;
+            }
+
+            public long NextRetryMillis(AbsTapHttpException e)
+            {
+                long nextRetryMillis = -1L;
+                if (e is TapHttpServerException se)
+                {
+                    // 处理服务器错误状态码
+                    if (se.StatusCode >= HttpStatusCode.InternalServerError && se.StatusCode <= (HttpStatusCode)599)
+                    {
+                        nextRetryMillis = backoffStrategy.NextBackoffMillis();
+                    }
+                    else if (TapHttpErrorConstants.ERROR_INVALID_TIME.Equals(se.ErrorData.Error))
+                    {
+                        // 修复时间并判断是否可以重试
+                        TapHttpTime.FixTime(se.TapHttpResponse.Now);
+                        if (backoffStrategy.CanInvalidTimeRetry())
+                        {
+                            nextRetryMillis = 0L; // 立马重试
+                        }
+                    }
+                    else if (TapHttpErrorConstants.ERROR_SERVER_ERROR.Equals(se.ErrorData.Error))
+                    {
+                        nextRetryMillis = backoffStrategy.NextBackoffMillis();
+                    }
+                }
+                else if (e is TapHttpInvalidResponseException ie)
+                {
+                    if (ie.StatusCode >= HttpStatusCode.InternalServerError && ie.StatusCode <= (HttpStatusCode)599)
+                    {
+                        nextRetryMillis = backoffStrategy.NextBackoffMillis();
+                    }
+                }
+                return nextRetryMillis;
+            }
+        }
+    }
+
+    /// <summary>
+    /// HTTP 后退策略实现。
+    /// </summary>
+    public class TapHttpBackoffStrategy
+    {
+        /// <summary>
+        /// 创建固定后退策略。
+        /// </summary>
+        /// <param name="maxCount">最大重试次数。</param>
+        /// <returns>固定后退策略。</returns>
+        public static ITapHttpBackoffStrategy CreateFixed(int maxCount)
+        {
+            return new Fixed(maxCount);
+        }
+
+        /// <summary>
+        /// 创建指数后退策略。
+        /// </summary>
+        /// <returns>指数后退策略。</returns>
+        public static ITapHttpBackoffStrategy CreateExponential()
+        {
+            return new Exponential();
+        }
+
+        /// <summary>
+        /// 创建不后退策略。
+        /// </summary>
+        /// <returns>不后退策略。</returns>
+        public static ITapHttpBackoffStrategy CreateNone()
+        {
+            return new None();
+        }
+
+        private abstract class Base : ITapHttpBackoffStrategy
+        {
+            protected int CanTimeDeltaRetry = 1;
+
+            public abstract long NextBackoffMillis();
+
+            public abstract void Reset();
+
+            /// <summary>
+            /// 判断是否可以重试无效时间。
+            /// </summary>
+            /// <returns>如果可以重试返回 true，否则返回 false。</returns>
+            public bool CanInvalidTimeRetry()
+            {
+                return Interlocked.CompareExchange(ref CanTimeDeltaRetry, 0, 1) == 1;
+            }
+        }
+
+        private class Fixed : Base
+        {
+            private readonly int _maxCount;
+            private int CurrentCount = 0;
+
+            public Fixed(int maxCount)
+            {
+                _maxCount = maxCount;
+            }
+
+            public override long NextBackoffMillis()
+            {
+                if (++CurrentCount < _maxCount)
+                {
+                    return 100L; // 固定的重试时间 100ms
+                }
+                return -1L; // 达到最大重试次数，返回 -1
+            }
+
+            public override void Reset()
+            {
+                CurrentCount = 0;
+                Interlocked.Exchange(ref CanTimeDeltaRetry, 1);
+            }
+        }
+
+        private class Exponential : Base
+        {
+            private static readonly long INIT_INTERVAL_MILLIS = 2 * 1000L; // 初始时间 2 秒
+            private static readonly long MAX_INTERVAL_MILLIS = 600 * 1000L; // 最大时间 600 秒
+            private static readonly int MULTIPLIER = 2; // 指数倍数
+
+            private long CurrentIntervalMillis = INIT_INTERVAL_MILLIS;
+
+            public override long NextBackoffMillis()
+            {
+                if (CurrentIntervalMillis * MULTIPLIER > MAX_INTERVAL_MILLIS)
+                {
+                    return MAX_INTERVAL_MILLIS; // 返回最大时间
+                }
+                CurrentIntervalMillis *= MULTIPLIER; // 增加当前时间
+                return CurrentIntervalMillis;
+            }
+
+            public override void Reset()
+            {
+                CurrentIntervalMillis = INIT_INTERVAL_MILLIS / MULTIPLIER; // 重置当前时间
+                Interlocked.Exchange(ref CanTimeDeltaRetry, 1);
+            }
+        }
+
+        private class None : Base
+        {
+            public override long NextBackoffMillis()
+            {
+                return -1L; // 不后退，返回 -1
+            }
+
+            public override void Reset()
+            {
+                Interlocked.Exchange(ref CanTimeDeltaRetry, 1);
+            }
+        }
+    }
+}

package/Core/Standalone/Runtime/Internal/Http/TapHttpRetryStrategy.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 88883d9f22f9042c19eb909edcc7f851
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: