XiuXianGame/Assets/TapSDK/Core/Standalone/Runtime/Public/TapEventStandalone.cs

using System;
using TapSDK.Core.Internal;
using TapSDK.Core.Standalone.Internal;
using System.Collections.Generic;
using System.Text.RegularExpressions;
using UnityEngine;
using TapSDK.Core.Internal.Utils;
using TapSDK.Core.Internal.Log;

namespace TapSDK.Core.Standalone
{
    /// <summary>
    /// Represents the standalone implementation of the Tap event.
    /// </summary>
    public class TapEventStandalone : ITapEventPlatform
    {
        internal static Tracker Tracker;
        private readonly User User = TapCoreStandalone.User;

        private TapTapEventOptions eventOptions;

        public void Init(TapTapEventOptions eventOptions)
        {
            this.eventOptions = eventOptions;
            if (eventOptions == null || !eventOptions.enableTapTapEvent)
            {
                return;
            }
            Tracker = new Tracker();
            Tracker.Init();
        }

        /// <summary>
        /// Sets the user ID for tracking events.
        /// </summary>
        /// <param name="userID">The user ID to set.</param>
        public void SetUserID(string userID)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            SetUserID(userID, null);
        }

        /// <summary>
        /// Sets the user ID and additional properties for tracking events.
        /// </summary>
        /// <param name="userID">The user ID to set.</param>
        /// <param name="properties">Additional properties to associate with the user.</param>
        public void SetUserID(string userID, string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            if (!IsValidUserID(userID))
            {
                TapLog.Error("Invalid user ID, length should be 1-160 and only contains a-zA-Z0-9_+/=.,:");
                return;
            }

            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            User.Login(userID, filterProperties(prop));
        }

        /// <summary>
        /// Clears the current user.
        /// </summary>
        public void ClearUser()
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            User.Logout();
        }

        /// <summary>
        /// Gets the device ID.
        /// </summary>
        /// <returns>The device ID.</returns>
        public string GetDeviceId()
        {
            if (!CheckInitAndEnableState())
            {
                return "";
            }
            return Identity.DeviceId;
        }

        /// <summary>
        /// Logs an event with the specified name and properties.
        /// </summary>
        /// <param name="name">The name of the event.</param>
        /// <param name="properties">Additional properties to associate with the event.</param>
        public void LogEvent(string name, string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            // name 长度256非空，不符合的丢事件，打log
            if (!checkLength(name))
            {
                TapLog.Error(name + " Event name length should be less than or equal to 256 characters.");
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackEvent(name, filterProperties(prop));
        }

        /// <summary>
        /// Tracks device initialization with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the device initialization.</param>
        public void DeviceInitialize(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackDeviceProperties(Constants.PROPERTY_INITIALIZE_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Tracks device update with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the device update.</param>
        public void DeviceUpdate(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackDeviceProperties(Constants.PROPERTY_UPDATE_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Tracks device addition with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the device addition.</param>
        public void DeviceAdd(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackDeviceProperties(Constants.PROPERTY_ADD_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Tracks user initialization with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the user initialization.</param>
        public void UserInitialize(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackUserProperties(Constants.PROPERTY_INITIALIZE_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Tracks user update with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the user update.</param>
        public void UserUpdate(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackUserProperties(Constants.PROPERTY_UPDATE_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Tracks user addition with the specified properties.
        /// </summary>
        /// <param name="properties">Additional properties to associate with the user addition.</param>
        public void UserAdd(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.TrackUserProperties(Constants.PROPERTY_ADD_TYPE, filterProperties(prop));
        }

        /// <summary>
        /// Adds a common property with the specified key and value.
        /// </summary>
        /// <param name="key">The key of the common property.</param>
        /// <param name="value">The value of the common property.</param>
        public void AddCommonProperty(string key, string value)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            if (!checkLength(key))
            {
                TapLog.Error(key + " Property key length should be less than or equal to 256 characters.");
                return;
            }
            if (!checkLength(value))
            {
                TapLog.Error(value + " Property value length should be less than or equal to 256 characters.");
                return;
            }
            Tracker.AddCommonProperty(key, value);
        }

        /// <summary>
        /// Adds common properties with the specified JSON string.
        /// </summary>
        /// <param name="properties">The JSON string containing the common properties.</param>
        public void AddCommon(string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Dictionary<string, object> prop = Json.Deserialize(properties) as Dictionary<string, object>;
            Tracker.AddCommon(filterProperties(prop));
        }

        /// <summary>
        /// Clears the common property with the specified key.
        /// </summary>
        /// <param name="key">The key of the common property to clear.</param>
        public void ClearCommonProperty(string key)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Tracker.ClearCommonProperty(key);
        }

        /// <summary>
        /// Clears the common properties with the specified keys.
        /// </summary>
        /// <param name="keys">The keys of the common properties to clear.</param>
        public void ClearCommonProperties(string[] keys)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Tracker.ClearCommonProperties(keys);
        }

        /// <summary>
        /// Clears all common properties.
        /// </summary>
        public void ClearAllCommonProperties()
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            Tracker.ClearAllCommonProperties();
        }

        /// <summary>
        /// Logs a charge event with the specified details and properties.
        /// </summary>
        /// <param name="orderID">The ID of the order.</param>
        /// <param name="productName">The name of the product.</param>
        /// <param name="amount">The amount of the charge.</param>
        /// <param name="currencyType">The currency type of the charge.</param>
        /// <param name="paymentMethod">The payment method used for the charge.</param>
        /// <param name="properties">Additional properties to associate with the charge event.</param>
        public void LogChargeEvent(string orderID, string productName, long amount, string currencyType, string paymentMethod, string properties)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            if (amount <= 0 || amount > 100000000000)
            {
                TapLog.Error(amount + " is invalid, amount should be in range (0, 100000000000]");
                return;
            }
            Tracker.LogPurchasedEvent(orderID, productName, amount, currencyType, paymentMethod, properties);
        }

        /// <summary>
        /// Registers a callback function for retrieving dynamic properties.
        /// </summary>
        /// <param name="callback">The callback function that returns a JSON string containing the dynamic properties.</param>
        public void RegisterDynamicProperties(Func<string> callback)
        {
            if (!CheckInitAndEnableState())
            {
                return;
            }
            DynamicProperties dynamicProperties = new DynamicProperties(callback);
            Tracker.RegisterDynamicPropsDelegate(dynamicProperties);
        }

        /// <summary>
        /// set custom oaid value
        /// </summary>
        /// <param name="value">oaid</param>
        public void SetOAID(string value)
        {
            TapLog.Log("SetOAID called in PC platform (empty implementation)");
        }

        /// <summary>
        /// Logs a device login event.
        /// </summary>
        public void LogDeviceLoginEvent()
        {
            TapLog.Log("LogDeviceLoginEvent called in PC platform (empty implementation)");
        }

        /// <summary>
        /// Represents the implementation of dynamic properties for the Tap event platform.
        /// </summary>
        public class DynamicProperties : Tracker.IDynamicProperties
        {
            readonly Func<string> callback;

            /// <summary>
            /// Initializes a new instance of the <see cref="DynamicProperties"/> class with the specified callback function.
            /// </summary>
            /// <param name="callback">The callback function that returns a JSON string containing the dynamic properties.</param>
            public DynamicProperties(Func<string> callback)
            {
                this.callback = callback;
            }

            /// <summary>
            /// Gets the dynamic properties.
            /// </summary>
            /// <returns>A dictionary containing the dynamic properties.</returns>
            public Dictionary<string, object> GetDynamicProperties()
            {
                var jsonString = callback();
                return Json.Deserialize(jsonString) as Dictionary<string, object>;
            }
        }

        private bool checkLength(string value)
        {
            var maxLength = 256;
            if (value.Length <= 0 || value.Length > maxLength)
            {
                return false;
            }
            return true;
        }

        private bool IsValidUserID(string userID)
        {
            string pattern = @"^[a-zA-Z0-9_+/=.,:]{1,160}$";
            Regex regex = new Regex(pattern);
            return regex.IsMatch(userID);
        }

        /// <summary>
        /// 检查是否 Core模块初始化及 TapEvent 启用
        /// </summary>
        /// <returns></returns>
        private bool CheckInitAndEnableState()
        {
            if (!TapCoreStandalone.CheckInitState())
            {
                return false;
            }
            else
            {
                if (eventOptions == null || !eventOptions.enableTapTapEvent)
                {
                    string tip = "当前应用已关闭 TapTapEvent 开关，请开启后再调用相关接口";
                    TapLog.Error(tip + " 开启方式：enableTapTapEvent = true");
                    return false;
                }
                else
                {
                    return true;
                }
            }
        }

        private Dictionary<string, object> filterProperties(Dictionary<string, object> properties)
        {
            Dictionary<string, object> filteredProperties = new Dictionary<string, object>();
            if (properties != null)
            {
                foreach (var property in properties)
                {
                    if (property.Key.Length <= 0 || property.Key.Length > 256)
                    {
                        TapLog.Log(property.Key + " Property key length should be more then 0 and less than or equal to 256 characters.");
                        continue;
                    }
                    if (property.Value.ToString().Length > 256)
                    {
                        TapLog.Log(property.Value + " Property value length should be less than or equal to 256 characters.");
                        continue;
                    }
                    filteredProperties.Add(property.Key, property.Value);
                }
            }
            return filteredProperties;
        }
    }
}