com.guru.unity.sdk/Runtime/Code/SDK/GuruSDK.Analytics.cs

namespace Guru
{
    using System;
    using System.Collections.Generic;
    using UnityEngine;
    
    /// <summary>
    /// 打点管理
    /// </summary>
    public partial class GuruSDK
    {
        /// <summary>
        /// 主线关卡类型
        /// 只有传入此类型时才会进行 Blevel 的累加
        /// </summary>
        public const string LevelCategoryMain = "main";
        
        //----------------- 关卡开始类型 ---------------------
        public const string EventLevelStartModePlay = "play";
        public const string EventLevelStartModeReplay = "replay";
        public const string EventLevelStartModeContinue= "continue";
        
        //----------------- 关卡结束类型 ---------------------
        public const string EventLevelEndSuccess = "success";
        public const string EventLevelEndFail = "fail";
        public const string EventLevelEndExit = "exit";
        public const string EventLevelEndTimeout = "timeout";

        #region 通用接口
        /// <summary>
        /// 自定义事件打点
        /// </summary>
        /// <param name="eventName"></param>
        /// <param name="data"></param>
        public static void LogEvent(string eventName, Dictionary<string, dynamic> data = null)
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: LogEvent {eventName} :: Please call <GuruSDK.Start()> first, before you call <LogEvent>.");
                return;
            }
            Analytics.Track(eventName, data);
        }

        public static void SetScreen(string screen, string extra = "")
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: SetScreen {screen} :: Please call <GuruSDK.Start()> first, before you call <SetScreen>.");
                return;
            }
            Analytics.SetCurrentScreen(screen, extra);
        }

        #endregion
        
        #region 游戏打点

        /// <summary>
        /// 游戏启动打点
        /// </summary>
        /// <param name="levelId"></param>
        /// <param name="levelName"></param>
        /// <param name="levelCategory"></param>
        /// <param name="levelID"></param>
        /// <param name="startType"></param>
        /// <param name="isReplay"></param>
        public static void LogLevelStart(int levelId, string startType = EventLevelStartModePlay, 
            string levelCategory = LevelCategoryMain, string levelName = "", string levelID = "",
            bool isReplay = false)
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: LogLevelStart {levelId} :: Please call <GuruSDK.Start()> first, before you call <LogLevelStart>.");
                return;
            }

            Analytics.LogLevelStart(levelId, levelName, levelCategory, levelID, startType, isReplay);
        }
        
        /// <summary>
        /// 游戏点击 Continue 重开始游戏
        /// </summary>
        /// <param name="levelId"></param>
        /// <param name="levelCategory"></param>
        /// <param name="levelName"></param>
        /// <param name="levelID"></param>
        public static void LogLevelContinue(int levelId, string levelCategory = LevelCategoryMain,
            string levelName = "", string levelID = "")
        {
            LogLevelStart(levelId, EventLevelStartModeContinue, levelCategory, levelName, levelID,  true);
        }
        
        /// <summary>
        /// 游戏点击 Continue 重开始游戏
        /// </summary>
        /// <param name="levelId"></param>
        /// <param name="levelCategory"></param>
        /// <param name="levelName"></param>
        /// <param name="levelID"></param>
        public static void LogLevelReplay(int levelId, string levelCategory = LevelCategoryMain,
            string levelName = "", string levelID = "")
        {
            LogLevelStart(levelId, EventLevelStartModeReplay,levelCategory, levelName, levelID,  true);
        }
        
        /// <summary>
        /// 游戏胜利打点
        /// </summary>
        public static void LogLevelEnd(int levelId,  string result = EventLevelEndSuccess,
            string levelCategory = LevelCategoryMain, string levelName = "", string levelID = "",
            int? duration = null, int? step = null, int? score = null )
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: LogLevelEnd {levelId} :: Please call <GuruSDK.Start()> first, before you call <LogLevelEnd>.");
                return;
            }
            
            if (InitConfig.AutoRecordFinishedLevels)
            {
                if(result == EventLevelEndSuccess){
                    if(levelCategory == LevelCategoryMain)
                    {
                        if (levelId > Model.SuccessLevelId) Model.SuccessLevelId = levelId; // 自动记录关卡完成次数
                    }
                    Model.TotalPlayedCount++; // 自动记录关卡总次数
                }
                

                Analytics.BLevel = Model.SuccessLevelId; // 记录 BLevel
                Analytics.BPlay = Model.TotalPlayedCount; // 记录 BPlay
            }
            
            Analytics.LogLevelEnd(levelId, result, 
                levelName, levelCategory, levelCategory,
                duration, step, score);
        }
        
        
        /// <summary>
        /// 游戏失败打点
        /// 需要为游戏记录详细的失败原因
        /// </summary>
        public static void LogLevelFail(int levelId,
            string levelCategory = LevelCategoryMain, string levelName = "", string levelID = "",
            int? duration = null, int? step = null, int? score = null )
        {
            LogLevelEnd(levelId, EventLevelEndFail, levelCategory, levelName, levelID, duration, step, score);
        }

        /// <summary>
        /// 因退出关卡导致游戏失败
        /// </summary>
        public static void LogLevelFailExit(int levelId,
            string levelCategory = LevelCategoryMain, string levelName = "", string levelID = "",
            int? duration = null, int? step = null, int? score = null)
        {
            LogLevelEnd(levelId, EventLevelEndExit, levelCategory, levelName, levelID, duration, step, score);
        }

        /// <summary>
        /// 因关卡超时导致游戏失败
        /// </summary>
        public static void LogLevelFailTimeout(int levelId,
            string levelCategory = LevelCategoryMain, string levelName = "", string levelID = "",
            int? duration = null, int? step = null, int? score = null)
        {
            LogLevelEnd(levelId, EventLevelEndTimeout, levelCategory, levelName, levelID, duration, step, score);
        }


        /// <summary>
        /// 玩家(角色)升级事件
        /// </summary>
        /// <param name="playerLevel"></param>
        /// <param name="playerName"></param>
        public static void LogLevelUp(int playerLevel, string playerName)
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: LogLevelUp {playerLevel} :: Please call <GuruSDK.Start()> first, before you call <LogLevelUp>.");
                return;
            }
            Analytics.LevelUp(playerLevel, playerName);
        }

        /// <summary>
        /// 玩家解锁成就
        /// </summary>
        /// <param name="achievementName"></param>
        public static void LogAchievement(string achievementName)
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: LogAchievement {achievementName} :: Please call <GuruSDK.Start()> first, before you call <LogAchievement>.");
                return;
            }
            Analytics.UnlockAchievement(achievementName);
        }
        
        #endregion

        #region 用户属性

        /// <summary>
        /// 提前调用用户属性
        /// </summary>
        private static void InitUserProperties()
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: InitUserProperties :: Please call <GuruSDK.Start()> first, before you call <InitUserProperties>.");
                return;
            }
            
            SetUserIsIAP(Model.IsIAPUser); // 预先设置用户的 IAP User 属性
            SetUserBLevel(Model.SuccessLevelId); // 预先设置用户的 BLevel 属性
            SetUserBPlay(Model.TotalPlayedCount);  // 预先设置用户的 BPlay 属性
        }



        /// <summary>
        /// 设置用户属性
        /// </summary>
        /// <param name="key"></param>
        /// <param name="value"></param>
        public static void SetUserProperty(string key, string value)
        {
            if (!IsInitialSuccess)
            {
                Debug.LogError($"{Tag} :: SetUserProperty {key}:{value} ::Please call <GuruSDK.Start()> first, before you call <SetUserProperty>.");
                return;
            }
            Analytics.SetUserProperty(key, value);
        }

        public static void SetUID(string uid)
        {
            SetUserProperty(Analytics.PropertyUserID, uid);
        }

        public static void SetUserBLevel(int blevel)
        {
            SetUserProperty(Analytics.PropertyLevel, $"{blevel}");
        }
        
        public static void SetUserBPlay(int bplay)
        {
            SetUserProperty(Analytics.PropertyPlay, $"{bplay}");
        }

        public static void SetUserTotalCoins(int totalCoins)
        {
            SetUserProperty(Analytics.PropertyCoin, $"{totalCoins}");        
        }
        
        public static void SetUserCoins(int coins)
        {
            SetUserProperty(Analytics.PropertyNonIAPCoin, $"{coins}");        
        }
        
        public static void SetUserPaidCoins(int paidCoins)
        {
            SetUserProperty(Analytics.PropertyIAPCoin, $"{paidCoins}");        
        }
        
        public static void SetUserExp(int exp)
        {
            SetUserProperty(Analytics.PropertyExp, $"{exp}");        
        }
        
        public static void SetUserHp(int hp)
        {
            SetUserProperty(Analytics.PropertyHp, $"{hp}");        
        }

        public static void SetUserGrade(int grade)
        {
            SetUserProperty(Analytics.PropertyGrade, $"{grade}");        
        }

        public static void SetUserIsIAP(bool isIapUser)
        {
            SetUserProperty(Analytics.PropertyIsIAPUser, isIapUser? "true" : "false");
        }

        #endregion

        #region SDK 打点
        
        /// <summary>
        /// Log SDK boost time
        /// </summary>
        /// <param name="time"></param>
        private static void LogSDKInitTime(double time)
        {
            Analytics.Track(Consts.EventSDKInfo, new Dictionary<string, dynamic>()
            {
                { Consts.PropertyFirstOpenTime, time.ToString("F6") },
                { Consts.PropertyDeviceID, DeviceId },
            }, new Analytics.EventSetting()
            {
                EnableFirebaseAnalytics = true,
            });
        }

        private static void LogFirebaseDeps(bool success)
        {
            Analytics.Track(Consts.EventSDKInfo, new Dictionary<string, dynamic>()
            {
                { Consts.ParameterItemName, $"fbs_done_{(success ? "true" : "false")}" },
            }, new Analytics.EventSetting()
            {
                EnableFirebaseAnalytics = true,
            });
        }

        #endregion

        #region Crashlytics 接口

        public static void CrashLog(string message)
        {
            if (!IsFirebaseReady) return;
            CrashlyticsAgent.Log(message);
        }
        
        public static void CrashException(string message)
        {
            if (!IsFirebaseReady) return;
            CrashlyticsAgent.LogException(message);
        }

        public static void CrashException(Exception ex)
        {
            if (!IsFirebaseReady) return;
            CrashlyticsAgent.LogException(ex);
        }

        public static void CrashCustomKeys(string key, string value)
        {
            if (!IsFirebaseReady) return;
            CrashlyticsAgent.SetCustomKey(key, value);
        }
        #endregion
    }
}