release: 1.0.14

CHANGELOG.md

@@ -1,3 +1,29 @@
+# [1.0.14]
+
+### 修复
+
+* `AsyncAdPlayer` 增加展示确认阶段和统一失败收口，避免 `show` 发起后无回调时主链失联。
+* 抽象播放器补充展示超时配置与内部展示开始通知，保持外部调用接口不变。
+* 清理广告源级失败对主链的误接线，避免 `AdSource` 过程回调误判为最终失败。
+
+# [1.0.13]
+
+### 修复
+
+* 修复插屏成功关闭时误触发 `GLOBAL_ShowAwardVideoComplete` 全局奖励视频完成事件的问题。
+
+# [1.0.12]
+
+### 新增
+
+* `ADManager` 新增 `EnterAdScenario(AD_Type, string)`，支持应用层显式上报广告场景到达。
+* `ADPlayer` 增加预热、重试和播放前钩子能力，用于平台层策略化调度。
+
+### 修复
+
+* `AsyncAdPlayer` 增强首播失败补偿和多次加载尝试，降低冷启动首次播放失败概率。
+* 初始化后可按广告位配置自动预热，避免高价值广告位首次点击才开始建链。
+
 # [1.0.0]
 
 基础版本.

Runtime/ADAggregator/ADListener.cs

@@ -33,4 +33,4 @@ namespace Runtime.ADAggregator
             onVideoComplete = null;
         }
     }
-}
+}

Runtime/ADAggregator/ADManager.cs

@@ -7,8 +7,8 @@ namespace Runtime.ADAggregator
     public class ADManager : MonoBehaviour
     {
         private static ADManager _instance;
-        private static bool mIsCreate = false;
-        private static bool mIsGMModel = false;
+        private static bool      mIsCreate  = false;
+        private static bool      mIsGMModel = false;
 
         public static ADManager Instance
         {
@@ -22,7 +22,7 @@ namespace Runtime.ADAggregator
                         Destroy(objs[i]);
                     }
 
-                    _instance = new GameObject().AddComponent<ADManager>();
+                    _instance      = new GameObject().AddComponent<ADManager>();
                     _instance.name = "[GameUpdater] <color=yellow>NoInit<color>";
                     DontDestroyOnLoad(_instance);
                     _instance.InitTimeSystem();
@@ -51,25 +51,36 @@ namespace Runtime.ADAggregator
 
         private string _userId;
 
+        /// <summary>
+        /// 全局任意视频广告播放结束后事件， bool 表示是否完成奖励
+        /// </summary>
+        public event Action<bool> GLOBAL_ShowAwardVideoComplete;
+
+        /// <summary>
+        /// 全局任意视频广告玩家点击播放时
+        /// </summary>
+        public event Action<string , string> GLOBAL_ShowAwardVideoBefore;
+
         public string UserId => _userId;
 
 #pragma warning disable CS0414
         private bool _isInit = false;
 #pragma warning restore CS0414
 
-        public void Init(Action onCallback, string userId, ADConfig adConfig, IAdController controller,
-            params object[] args)
+        public void Init(Action          onCallback, string userId, ADConfig adConfig, IAdController controller,
+                         params object[] args)
         {
-            _isInit = true;
+            _isInit        = true;
             _instance.name = "[GameUpdater] <color=green>Init<color>";
-            AD_Dicts = new Dictionary<AD_Type, ADPlayer>();
-            _userId = userId;
+            AD_Dicts       = new Dictionary<AD_Type, ADPlayer>();
+            _userId        = userId;
 #if UNITY_EDITOR
             onCallback?.Invoke();
 #else
             controller.Init(adConfig , args);
             _adController = controller;
             _adConfig = adConfig;
+            PrewarmConfiguredPlayers();
             onCallback?.Invoke();
 #endif
         }
@@ -92,12 +103,12 @@ namespace Runtime.ADAggregator
                 return true;
             }
 #pragma warning disable CS0162
-            if (AD_Dicts.ContainsKey(adType) == false)
+            if (!TryGetOrCreatePlayer(adType, out var player))
             {
-                AD_Dicts[adType] = PlayerCreate(adType);
+                return false;
             }
 
-            return AD_Dicts[adType].IsReadly();
+            return player.IsReadly();
 #pragma warning restore CS0162
         }
 
@@ -112,9 +123,9 @@ namespace Runtime.ADAggregator
             }
             // Debug.LogError("准备加载广告" + adType);
 #pragma warning disable CS0162
-            if (!IsRealy(adType))
+            if (!IsRealy(adType) && TryGetOrCreatePlayer(adType, out var player))
             {
-                AD_Dicts[adType].LoadAD();
+                player.LoadAD();
             }
 #pragma warning restore CS0162
         }
@@ -135,7 +146,13 @@ namespace Runtime.ADAggregator
         /// <param name="callback"></param>
         public void AsyncPlayAD(AD_Type adType, string adScene, Action<bool> callback)
         {
+            
 #if UNITY_EDITOR
+            if (adType == AD_Type.AwardVideo)
+            {
+                this.OnVideoComplete(true);
+            }
+
             callback?.Invoke(true);
             return;
 #endif
@@ -144,17 +161,20 @@ namespace Runtime.ADAggregator
                 callback?.Invoke(true);
                 return;
             }
+
             _adController.EventLog("adScene", adScene);
             try
             {
                 _curAsyncPlayer?.Kill();
-                if (AD_Dicts.ContainsKey(adType) == false)
+                if (!TryGetOrCreatePlayer(adType, out var player))
                 {
-                    AD_Dicts[adType] = PlayerCreate(adType);
+                    callback?.Invoke(false);
+                    return;
                 }
 
-                var player = AD_Dicts[adType];
-                _curAsyncPlayer = new AsyncAdPlayer(player, callback);
+                if (adType == AD_Type.AwardVideo)
+                    GLOBAL_ShowAwardVideoBefore?.Invoke(player.Key , NormalizeScenario(adScene));
+                _curAsyncPlayer = new AsyncAdPlayer(player, NormalizeScenario(adScene), callback);
             }
             catch (Exception e)
             {
@@ -174,10 +194,75 @@ namespace Runtime.ADAggregator
                 return null;
             }
 #pragma warning disable CS0162
-            return _adController.CreateAdPlayer(type);
+            var adPlayer = _adController.CreateAdPlayer(type);
+            if (adPlayer == null)
+            {
+                return null;
+            }
+            adPlayer.ADType = type;
+            return adPlayer;
 #pragma warning restore CS0162
         }
 
+        public void EnterAdScenario(AD_Type adType, string adScene)
+        {
+#if UNITY_EDITOR
+            return;
+#endif
+            if (!_isInit || mIsGMModel)
+            {
+                return;
+            }
+#pragma warning disable CS0162
+            if (!TryGetOrCreatePlayer(adType, out var player))
+            {
+                return;
+            }
+
+            player.EnterAdScenario(NormalizeScenario(adScene));
+#pragma warning restore CS0162
+        }
+
+        private bool TryGetOrCreatePlayer(AD_Type type, out ADPlayer player)
+        {
+            if (AD_Dicts.TryGetValue(type, out player) && player != null)
+            {
+                return true;
+            }
+
+            player = PlayerCreate(type);
+            if (player == null)
+            {
+                return false;
+            }
+
+            AD_Dicts[type] = player;
+            return true;
+        }
+
+        private void PrewarmConfiguredPlayers()
+        {
+            foreach (AD_Type adType in Enum.GetValues(typeof(AD_Type)))
+            {
+                if (!TryGetOrCreatePlayer(adType, out var player))
+                {
+                    continue;
+                }
+
+                if (!player.AutoPreloadOnInit)
+                {
+                    continue;
+                }
+
+                player.LoadAD();
+            }
+        }
+
+        private static string NormalizeScenario(string scenario)
+        {
+            return string.IsNullOrWhiteSpace(scenario) ? "__default__" : scenario.Trim();
+        }
+
         public void CloseAd(AD_Type adType)
         {
 #if UNITY_EDITOR
@@ -201,13 +286,13 @@ namespace Runtime.ADAggregator
 
         #region TimeSystem
 
-        private List<Action> _updateList;
-        private const int DefaultLength = 1024;
-        private List<AdTimeHandler> _timeHandlers;
+        private       List<Action>        _updateList;
+        private const int                 DefaultLength = 1024;
+        private       List<AdTimeHandler> _timeHandlers;
 
         private void InitTimeSystem()
         {
-            this._updateList = new List<Action>(DefaultLength);
+            this._updateList   = new List<Action>(DefaultLength);
             this._timeHandlers = new List<AdTimeHandler>();
         }
 
@@ -296,5 +381,10 @@ namespace Runtime.ADAggregator
         {
             _adController.SetMask(true);
         }
+
+        internal void OnVideoComplete(bool isComplete)
+        {
+            GLOBAL_ShowAwardVideoComplete?.Invoke(isComplete);
+        }
     }
-}
+}

Runtime/ADAggregator/ADPlayer.cs

@@ -10,11 +10,46 @@ namespace Runtime.ADAggregator
         protected int curState;
 
         public    string     Key;
+        public    string     AdScene;
         protected ADListener adListener;
         public    Action     OnErrorAction;
+        public    Action     OnShowStartedAction;
 
+        public AD_Type ADType { get; internal set; }
         public int State => curState;
 
+        public virtual int MaxLoadAttempts
+        {
+            get
+            {
+                return ADType == AD_Type.AwardVideo ? 2 : 1;
+            }
+        }
+
+        public virtual float LoadRetryDelaySeconds
+        {
+            get
+            {
+                return ADType == AD_Type.AwardVideo ? 0.75f : 0f;
+            }
+        }
+
+        public virtual float ShowPendingTimeoutSeconds
+        {
+            get
+            {
+                return 5f;
+            }
+        }
+
+        public virtual bool AutoPreloadOnInit
+        {
+            get
+            {
+                return false;
+            }
+        }
+
         public ADPlayer Init(string key)
         {
             this.Key      = key;
@@ -42,12 +77,25 @@ namespace Runtime.ADAggregator
         {
         }
 
+        public virtual void OnPlayRequestStarted()
+        {
+        }
+
+        public virtual void EnterAdScenario(string scenario)
+        {
+        }
+
         /// <summary>
         /// 主动关闭广告
         /// </summary>
         public virtual void CloseAD()
         {
         }
+
+        protected void NotifyShowStarted()
+        {
+            OnShowStartedAction?.Invoke();
+        }
         
         public void OnError(object code, string message)
         {
@@ -56,4 +104,4 @@ namespace Runtime.ADAggregator
             curState = 0;
         }
     }
-}
+}

Runtime/ADAggregator/AsyncAdPlayer.cs

@@ -5,23 +5,40 @@ namespace Runtime.ADAggregator
 {
     public class AsyncAdPlayer
     {
-        private Action<bool> _callback;
-        private ADPlayer _adPlayer;
-        private bool firstLoad;
-        private bool isKill;
-        private bool isUpdate;
-        private AdTimeHandler overHandler;
-
-        private float _outTime;
-    
-        public AsyncAdPlayer(ADPlayer player , Action<bool> callback)
+        private enum AsyncPlayPhase
         {
-        
-            this._outTime = 0;
-            this._callback = callback;
-            this.isKill = false;
-            this.firstLoad = true;
-            this._adPlayer = player;
+            Loading,
+            ShowPending,
+            Playing,
+            Closing,
+            Completed
+        }
+
+        private const float LoadTimeoutSeconds = 15f;
+        private const float ShowAckTimeoutSeconds = 2f;
+
+        private Action<bool>  _callback;
+        private ADPlayer      _adPlayer;
+        private bool          isKill;
+        private bool          isUpdate;
+        private int           loadAttempts;
+        private float         nextLoadRetryTime;
+        private AdTimeHandler overHandler;
+        private AdTimeHandler _showPendingHandler;
+        private string        _adScene;
+        private AsyncPlayPhase _phase;
+        private float          _loadElapsed;
+    
+        public AsyncAdPlayer(ADPlayer player , string adScene, Action<bool> callback)
+        {
+            _adScene            = adScene;
+            _loadElapsed        = 0f;
+            _callback           = callback;
+            isKill              = false;
+            loadAttempts        = 0;
+            nextLoadRetryTime   = 0f;
+            _adPlayer           = player;
+            _phase              = AsyncPlayPhase.Loading;
             if (_adPlayer == null)
             {
 #if UNITY_EDITOR
@@ -33,7 +50,10 @@ namespace Runtime.ADAggregator
             }
             ADManager.Instance.OpenMask();
             _adPlayer.OnErrorAction = OnError;
-            isUpdate = true;
+            _adPlayer.OnShowStartedAction = OnShowStarted;
+            _adPlayer.AdScene       = _adScene;
+            _adPlayer.OnPlayRequestStarted();
+            isUpdate                = true;
             ADManager.Instance.AddUpdater(DoUpdate);
         }
 
@@ -42,66 +62,112 @@ namespace Runtime.ADAggregator
 #if UNITY_EDITOR
             Debug.LogError("广告异常: " + this._adPlayer.Key);
 #endif
-            // return;
-            // if (isUpdate)
-            // {
-            //     isUpdate = false;
-            //     ADManager.Instance.RemoveUpdater(DoUpdate);
-            // }
-            // ADManager.Instance.CloseMask();
-            // _callback?.Invoke(false);
-            // Clear();
+            if (_phase == AsyncPlayPhase.Loading)
+            {
+                return;
+            }
+
+            Fail(false);
         }
 
         private void DoUpdate()
         {
             if (!isUpdate)
-                return;
-            _outTime += Time.deltaTime;
-            if (this._outTime >= 15)
             {
-                _callback?.Invoke(false);
-                Kill();
+                return;
             }
+
+            switch (_phase)
+            {
+                case AsyncPlayPhase.Loading:
+                    UpdateLoading();
+                    break;
+            }
+        }
+
+        private void UpdateLoading()
+        {
+            _loadElapsed += Time.deltaTime;
+            if (_loadElapsed >= LoadTimeoutSeconds)
+            {
+                Fail(false);
+                return;
+            }
+
             if (_adPlayer.IsReadly())
             {
-#if UNITY_EDITOR
-                Debug.LogError("开始播放广告: " + this._adPlayer.Key);
-#endif
-                _adPlayer.ShowAD(OnCloseAD, OnComplete);
-                ADManager.Instance.CloseMask();
-                isUpdate = false;
-                ADManager.Instance.RemoveUpdater(DoUpdate);
+                BeginShow();
             }
-            else if(!_adPlayer.IsLoading())
+            else if (!_adPlayer.IsLoading())
             {
-                if (firstLoad)
+                if (loadAttempts < _adPlayer.MaxLoadAttempts)
                 {
+                    if (_loadElapsed < nextLoadRetryTime)
+                    {
+                        return;
+                    }
+
 #if UNITY_EDITOR
                     Debug.LogError("开始加载广告: " + this._adPlayer.Key);
 #endif
-                    this._outTime = 0;
                     _adPlayer.LoadAD();
-                    firstLoad = false;
+                    loadAttempts++;
+                    nextLoadRetryTime = _loadElapsed + _adPlayer.LoadRetryDelaySeconds;
                 }
                 else
                 {
-                    _callback?.Invoke(false);
-                    Kill();
+                    Fail(false);
                 }
             }
         }
 
+        private void BeginShow()
+        {
+#if UNITY_EDITOR
+            Debug.LogError("开始播放广告: " + _adPlayer.Key);
+#endif
+            try
+            {
+                _phase = AsyncPlayPhase.ShowPending;
+                _showPendingHandler = ADManager.Instance.CreateTimer(
+                    _adPlayer.ShowPendingTimeoutSeconds > 0 ? _adPlayer.ShowPendingTimeoutSeconds : ShowAckTimeoutSeconds,
+                    () => Fail(false));
+                _adPlayer.ShowAD(OnCloseAD, OnComplete);
+                isUpdate = false;
+                ADManager.Instance.RemoveUpdater(DoUpdate);
+            }
+            catch (Exception exception)
+            {
+                Debug.LogError(exception);
+                _showPendingHandler?.Kill();
+                Fail(false);
+            }
+        }
+
+        private void OnShowStarted()
+        {
+            if (isKill)
+            {
+                return;
+            }
+
+            _phase = AsyncPlayPhase.Playing;
+            _showPendingHandler?.Kill();
+            ADManager.Instance.CloseMask();
+        }
+
         private void OnCloseAD()
         {
 #if UNITY_EDITOR
-            Debug.LogError("关闭广告: " + this._adPlayer.Key);
+            Debug.LogError("关闭广告: " + _adPlayer.Key);
 #endif
+            _phase = AsyncPlayPhase.Closing;
+            _showPendingHandler?.Kill();
             if (overHandler == null)
             {
                 overHandler = ADManager.Instance.CreateTimer(1.5f, () =>
                 {
-                    this._callback?.Invoke(false);
+                    _callback?.Invoke(false);
                     Clear();
                 });
             }
@@ -109,30 +175,49 @@ namespace Runtime.ADAggregator
 
         private void OnComplete(bool obj)
         {
-            this.overHandler?.Kill();
-            this.overHandler = ADManager.Instance.CreateTimer(0.05f, () =>
+            _phase = AsyncPlayPhase.Completed;
+            _showPendingHandler?.Kill();
+            overHandler?.Kill();
+            overHandler = ADManager.Instance.CreateTimer(0.05f, () =>
             {
+                if (_adPlayer != null && _adPlayer.ADType == AD_Type.AwardVideo)
+                {
+                    ADManager.Instance.OnVideoComplete(obj);
+                }
                 _callback?.Invoke(obj);
                 Clear();
             });
         }
 
+        private void Fail(bool result)
+        {
+            _callback?.Invoke(result);
+            Kill();
+        }
+
         //销毁广告
         public void Kill() 
         {
             if (isKill)
                 return;
-            ADManager.Instance.CloseMask();
             ADManager.Instance.RemoveUpdater(DoUpdate);
             Clear();
         }
 
         private void Clear() 
         {
+            ADManager.Instance.CloseMask();
             isKill = true;
+            isUpdate = false;
+            if (_adPlayer != null)
+            {
+                _adPlayer.OnErrorAction = null;
+                _adPlayer.OnShowStartedAction = null;
+            }
             _callback = null;
             _adPlayer = null;
-            this.overHandler = null;
+            overHandler = null;
+            _showPendingHandler = null;
         }
     }
 }

Sample.meta

@@ -1,8 +0,0 @@
-fileFormatVersion: 2
-guid: 094f67b7dbe0a8d4bb32d358c57004c6
-folderAsset: yes
-DefaultImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

package.json

@@ -2,7 +2,7 @@
   "name": "com.foldcc.cc-framework.commercialization",
   "displayName": "CC-Framework.commercialization",
   "description": "商业化sdk通用组件，包含广告、内购、用户统计、归因统计等",
-  "version": "1.0.5",
+  "version": "1.0.14",
   "unity": "2021.1",
   "license": "MIT",
   "repository": {