foldcc/CC-Framework.Commercialization
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: 1.0.12

Browse Source
This commit is contained in:
CORE-FOLDCCCore
2026-04-22 17:41:45 +08:00
parent 377a279ac3
commit 957c4e4045
5 changed files with 134 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
CHANGELOG.md
View File

@@ -1,3 +1,15 @@
# [1.0.12]
### 新增
* `ADManager` 新增 `EnterAdScenario(AD_Type, string)`，支持应用层显式上报广告场景到达。
* `ADPlayer` 增加预热、重试和播放前钩子能力，用于平台层策略化调度。
### 修复
* `AsyncAdPlayer` 增强首播失败补偿和多次加载尝试，降低冷启动首次播放失败概率。
* 初始化后可按广告位配置自动预热，避免高价值广告位首次点击才开始建链。
# [1.0.0]
基础版本.

84
Runtime/ADAggregator/ADManager.cs
View File

@@ -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

33
Runtime/ADAggregator/ADPlayer.cs
View File

@@ -15,9 +15,32 @@ namespace Runtime.ADAggregator
public Action OnErrorAction;
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 bool AutoPreloadOnInit
{
get
{
return false;
}
}
public ADPlayer Init(string key)
{
this.Key = key;
@@ -45,6 +68,14 @@ namespace Runtime.ADAggregator
{
}
public virtual void OnPlayRequestStarted()
{
}
public virtual void EnterAdScenario(string scenario)
{
}
/// <summary>
/// 主动关闭广告
/// </summary>

15
Runtime/ADAggregator/AsyncAdPlayer.cs
View File

@@ -10,6 +10,8 @@ namespace Runtime.ADAggregator
private bool firstLoad;
private bool isKill;
private bool isUpdate;
private int loadAttempts;
private float nextLoadRetryTime;
private AdTimeHandler overHandler;
private string _Ad_scene;
@@ -23,6 +25,8 @@ namespace Runtime.ADAggregator
this._callback = callback;
this.isKill = false;
this.firstLoad = true;
this.loadAttempts = 0;
this.nextLoadRetryTime = 0f;
this._adPlayer = player;
if (_adPlayer == null)
{
@@ -36,6 +40,7 @@ namespace Runtime.ADAggregator
ADManager.Instance.OpenMask();
_adPlayer.OnErrorAction = OnError;
_adPlayer.AdScene = this._Ad_scene;
_adPlayer.OnPlayRequestStarted();
isUpdate = true;
ADManager.Instance.AddUpdater(DoUpdate);
}
@@ -83,14 +88,20 @@ namespace Runtime.ADAggregator
}
else if(!_adPlayer.IsLoading())
{
if (firstLoad)
if (loadAttempts < _adPlayer.MaxLoadAttempts)
{
if (this._outTime < nextLoadRetryTime)
{
return;
}
#if UNITY_EDITOR
Debug.LogError("开始加载广告: " + this._adPlayer.Key);
#endif
this._outTime = 0;
_adPlayer.LoadAD();
loadAttempts++;
firstLoad = false;
nextLoadRetryTime = this._outTime + _adPlayer.LoadRetryDelaySeconds;
}
else
{

2
package.json
View File

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