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

@@ -80,6 +80,7 @@ namespace Runtime.ADAggregator
             controller.Init(adConfig , args);
             _adController = controller;
             _adConfig = adConfig;
+            PrewarmConfiguredPlayers();
             onCallback?.Invoke();
 #endif
         }
@@ -102,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
         }
 
@@ -122,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
         }
@@ -165,15 +166,15 @@ namespace Runtime.ADAggregator
             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];
                 if (adType == AD_Type.AwardVideo)
-                    GLOBAL_ShowAwardVideoBefore?.Invoke(player.Key , adScene);
-                _curAsyncPlayer = new AsyncAdPlayer(player, adScene, callback);
+                    GLOBAL_ShowAwardVideoBefore?.Invoke(player.Key , NormalizeScenario(adScene));
+                _curAsyncPlayer = new AsyncAdPlayer(player, NormalizeScenario(adScene), callback);
             }
             catch (Exception e)
             {
@@ -194,11 +195,74 @@ namespace Runtime.ADAggregator
             }
 #pragma warning disable CS0162
             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
@@ -323,4 +387,4 @@ namespace Runtime.ADAggregator
             GLOBAL_ShowAwardVideoComplete?.Invoke(isComplete);
         }
     }
-}
+}

Runtime/ADAggregator/ADPlayer.cs

@@ -13,11 +13,43 @@ namespace Runtime.ADAggregator
         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;
@@ -45,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)
         {
@@ -59,4 +104,4 @@ namespace Runtime.ADAggregator
             curState = 0;
         }
     }
-}
+}

Runtime/ADAggregator/AsyncAdPlayer.cs

@@ -5,25 +5,40 @@ namespace Runtime.ADAggregator
 {
     public class AsyncAdPlayer
     {
+        private enum AsyncPlayPhase
+        {
+            Loading,
+            ShowPending,
+            Playing,
+            Closing,
+            Completed
+        }
+
+        private const float LoadTimeoutSeconds = 15f;
+        private const float ShowAckTimeoutSeconds = 2f;
+
         private Action<bool>  _callback;
         private ADPlayer      _adPlayer;
-        private bool          firstLoad;
         private bool          isKill;
         private bool          isUpdate;
+        private int           loadAttempts;
+        private float         nextLoadRetryTime;
         private AdTimeHandler overHandler;
-        private string        _Ad_scene;
-
-        private float _outTime;
+        private AdTimeHandler _showPendingHandler;
+        private string        _adScene;
+        private AsyncPlayPhase _phase;
+        private float          _loadElapsed;
     
         public AsyncAdPlayer(ADPlayer player , string adScene, Action<bool> callback)
         {
-
-            this._Ad_scene = adScene;
-            this._outTime  = 0;
-            this._callback = callback;
-            this.isKill    = false;
-            this.firstLoad = true;
-            this._adPlayer = player;
+            _adScene            = adScene;
+            _loadElapsed        = 0f;
+            _callback           = callback;
+            isKill              = false;
+            loadAttempts        = 0;
+            nextLoadRetryTime   = 0f;
+            _adPlayer           = player;
+            _phase              = AsyncPlayPhase.Loading;
             if (_adPlayer == null)
             {
 #if UNITY_EDITOR
@@ -35,7 +50,9 @@ namespace Runtime.ADAggregator
             }
             ADManager.Instance.OpenMask();
             _adPlayer.OnErrorAction = OnError;
-            _adPlayer.AdScene       = this._Ad_scene;
+            _adPlayer.OnShowStartedAction = OnShowStarted;
+            _adPlayer.AdScene       = _adScene;
+            _adPlayer.OnPlayRequestStarted();
             isUpdate                = true;
             ADManager.Instance.AddUpdater(DoUpdate);
         }
@@ -45,71 +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;
-            var callback = _callback;
-            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);
-                if (_adPlayer.ADType != AD_Type.AwardVideo)
-                {
-                    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();
                 });
             }
@@ -117,15 +175,26 @@ 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, () =>
             {
-                ADManager.Instance.OnVideoComplete(obj);
+                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() 
         {
@@ -139,9 +208,16 @@ namespace Runtime.ADAggregator
         {
             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;
         }
     }
 }

package.json

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