com.taptap.sdk.core 4.3.12 → 4.4.1

package/Standalone/Runtime/Internal/Http/TapHttpBuilder.cs

@@ -0,0 +1,92 @@
+using System;
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    public class TapHttpBuilder
+    {
+        private readonly string moduleName;
+        private readonly string moduleVersion;
+
+        private string domain = null;
+
+        private ITapHttpSign sign = null;
+        private ITapHttpParser parser = null;
+
+        private long connectTimeoutMillis = TapHttp.CONNECT_TIMEOUT_MILLIS;
+        private long readTimeoutMillis = TapHttp.READ_TIMEOUT_MILLIS;
+        private long writeTimeoutMillis = TapHttp.WRITE_TIMEOUT_MILLIS;
+
+        public TapHttpBuilder(string moduleName, string moduleVersion)
+        {
+            this.moduleName = moduleName ?? throw new ArgumentNullException(nameof(moduleName));
+            this.moduleVersion = moduleVersion ?? throw new ArgumentNullException(nameof(moduleVersion));
+        }
+
+        public TapHttp Build()
+        {
+            TapHttpConfig httpConfig = new TapHttpConfig
+            {
+                ModuleName = moduleName,
+                ModuleVersion = moduleVersion,
+                Domain = domain,
+                Sign = sign ?? TapHttpSign.CreateDefaultSign(),
+                Parser = parser ?? TapHttpParser.CreateDefaultParser(),
+                ConnectTimeoutMillis = connectTimeoutMillis,
+                ReadTimeoutMillis = readTimeoutMillis,
+                WriteTimeoutMillis = writeTimeoutMillis,
+            };
+            return new TapHttp(httpConfig);
+        }
+
+        public TapHttpBuilder ConnectTimeout(long connectTimeoutMillis)
+        {
+            this.connectTimeoutMillis = connectTimeoutMillis;
+            return this;
+        }
+
+        public TapHttpBuilder ReadTimeout(long readTimeoutMillis)
+        {
+            this.readTimeoutMillis = readTimeoutMillis;
+            return this;
+        }
+
+        public TapHttpBuilder WriteTimeout(long writeTimeoutMillis)
+        {
+            this.writeTimeoutMillis = writeTimeoutMillis;
+            return this;
+        }
+
+        public TapHttpBuilder Domain(string domain)
+        {
+            this.domain = domain;
+            return this;
+        }
+
+        public TapHttpBuilder Sign(ITapHttpSign sign)
+        {
+            this.sign = sign;
+            return this;
+        }
+
+        public TapHttpBuilder Parser(ITapHttpParser parser)
+        {
+            this.parser = parser;
+            return this;
+        }
+
+    }
+
+    internal class TapHttpConfig
+    {
+        public string ModuleName { get; set; }
+        public string ModuleVersion { get; set; }
+        public string Domain { get; set; }
+        public ITapHttpSign Sign { get; set; }
+        public ITapHttpParser Parser { get; set; }
+        public ITapHttpParser RetryStrategy { get; set; }
+        public long ConnectTimeoutMillis { get; set; }
+        public long ReadTimeoutMillis { get; set; }
+        public long WriteTimeoutMillis { get; set; }
+    }
+
+}

package/Standalone/Runtime/Internal/Http/{NetUtils.cs.meta → TapHttpBuilder.cs.meta}

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: ee6c272981ce5408094eb76e8baa3838
+guid: ecc8edfa34fdd462a83db234c7940cec
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

package/Standalone/Runtime/Internal/Http/TapHttpErrorConstants.cs

@@ -0,0 +1,114 @@
+
+namespace TapSDK.Core.Standalone.Internal.Http
+{
+    /// <summary>
+    /// HTTP 错误常量类。
+    /// </summary>
+    public static class TapHttpErrorConstants
+    {
+
+        // --------------------------------------------------------------------------------------------
+        // 下面的错误信息是服务器端 [data.error] 字段的枚举
+        // --------------------------------------------------------------------------------------------
+
+        /// <summary>
+        /// 400 请阅读：[通用 API 人机验证协议](https://xindong.atlassian.net/wiki/spaces/TAP/pages/66032081)。
+        /// </summary>
+        public const string ERROR_CAPTCHA_NEEDS = "captcha.needs";
+
+        /// <summary>
+        /// 400 人机验证未通过。
+        /// </summary>
+        public const string ERROR_CAPTCHA_FAILED = "captcha.failed";
+
+        /// <summary>
+        /// 403 用户冻结。
+        /// </summary>
+        public const string ERROR_USER_IS_DEACTIVATED = "user_is_deactivated";
+
+        /// <summary>
+        /// 400 请求缺少某个必需参数，包含一个不支持的参数或参数值，或者格式不正确。
+        /// </summary>
+        public const string ERROR_INVALID_REQUEST = "invalid_request";
+
+        /// <summary>
+        /// 404 请求失败，请求所希望得到的资源未被在服务器上发现。在参数相同的情况下，不应该重复请求。
+        /// </summary>
+        public const string ERROR_NOT_FOUND = "not_found";
+
+        /// <summary>
+        /// 403 用户没有对当前动作的权限，引导重新身份验证并不能提供任何帮助，而且这个请求也不应该被重复提交。
+        /// </summary>
+        public const string ERROR_FORBIDDEN = "forbidden";
+
+        /// <summary>
+        /// 500 服务器出现异常情况，可稍等后重新尝试请求，但需有尝试上限，建议最多 3 次，如一直失败，则中断并告知用户。
+        /// </summary>
+        public const string ERROR_SERVER_ERROR = "server_error";
+
+        /// <summary>
+        /// 400 客户端时间不正确，应请求服务器时间重新构造。
+        /// </summary>
+        public const string ERROR_INVALID_TIME = "invalid_time";
+
+        /// <summary>
+        /// 400 请求是重放的。
+        /// </summary>
+        public const string ERROR_REPLAY_ATTACKS = "replay_attacks";
+
+        /// <summary>
+        /// 401 client_id、client_secret 参数无效。
+        /// </summary>
+        public const string ERROR_INVALID_CLIENT = "invalid_client";
+
+        /// <summary>
+        /// 400 提供的 Access Grant 是无效的、过期的或已撤销的，例如: Device Code 无效（一个设备授权码只能使用一次）等。
+        /// </summary>
+        public const string ERROR_INVALID_GRANT = "invalid_grant";
+
+        /// <summary>
+        /// 400 服务器不支持 grant_type 参数的值。
+        /// </summary>
+        public const string ERROR_UNSUPPORTED_GRANT_TYPE = "unsupported_grant_type";
+
+        /// <summary>
+        /// 400 服务器不支持 response_type 参数的值。
+        /// </summary>
+        public const string ERROR_UNSUPPORTED_RESPONSE_TYPE = "unsupported_response_type";
+
+        /// <summary>
+        /// 400 服务器不支持 secret_type 参数的值。
+        /// </summary>
+        public const string ERROR_UNSUPPORTED_SECRET_TYPE = "unsupported_secret_type";
+
+        /// <summary>
+        /// 400 Device Flow 中，设备通过 Device Code 换取 Access Token 的接口过于频繁。
+        /// </summary>
+        public const string ERROR_SLOW_DOWN = "slow_down";
+
+        /// <summary>
+        /// 429 登录尝试次数过多，请稍后重试，用于 password 模式下出错次数过多。
+        /// </summary>
+        public const string ERROR_TOO_MANY_LOGIN_ATTEMPTS = "too_many_login_attempts";
+
+        /// <summary>
+        /// 401 授权服务器拒绝请求，这个状态出现在拿着 token 请求用户资源时，如出现，客户端应退出本地的用户登录信息，引导用户重新登录。
+        /// </summary>
+        public const string ERROR_ACCESS_DENIED = "access_denied";
+
+        /// <summary>
+        /// 401 认证内容无效 grant_type 为 password 的模式下，用户名或密码错误。
+        /// </summary>
+        public const string ERROR_INVALID_CREDENTIALS = "invalid_credentials";
+
+        /// <summary>
+        /// 400 Device Flow 中，用户还没有对 Device Code 完成授权操作，按 interval 要求频率继续轮询，直到 expires_in 过期。
+        /// </summary>
+        public const string ERROR_AUTHORIZATION_PENDING = "authorization_pending";
+
+        /// <summary>
+        /// 服务端业务异常，如：防沉迷 token 失效（code=20000）。
+        /// </summary>
+        public const string ERROR_BUSINESS_ERROR = "business_code_error";
+    }
+}

package/Standalone/Runtime/Internal/Http/TapHttpErrorConstants.cs.meta

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

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

@@ -0,0 +1,71 @@
+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 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/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/Standalone/Runtime/Internal/Http/TapHttpParser.cs

@@ -0,0 +1,132 @@
+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);
+                }
+                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)500, httpResponse, httpErrorData));
+                }
+            }
+        }
+    }
+}

package/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/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/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/Standalone/Runtime/Internal/Http/TapHttpResult.cs

@@ -0,0 +1,90 @@
+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,
+            };
+        }
+
+    }
+}

package/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: