Game Frame X 广告系统的穿山甲(CSJ/Pangle)平台适配器。为 iOS 和 Android 应用提供基于字节跳动穿山甲广告 SDK 的激励视频广告集成。
UNITY_IOS、UNITY_ANDROID)本包是 Game Frame X 广告核心 BaseAdvertisementManager 的适配器实现。通过 Unity Inspector 配置 AdvertisementComponent 后,自动发现并加载。
| 类 | 说明 |
|---|---|
CSJAdvertisementManager | 激励视频广告管理器 — 加载、展示及生命周期管理 |
CSJAdvertisementConfig | 广告配置,包含 appId 和 adUnitId 字段 |
CSJBridge | iOS/Android 原生平台调用桥接 |
CSJNativeMessageHandler | 原生消息回调处理器 |
GameFrameXAdvertisementCSJCroppingHelper | IL2CPP link.xml 替代方案 — 保留类型引用 |
{
"dependencies": {
"com.gameframex.unity.advertisement": "https://github.com/GameFrameX/com.gameframex.unity.advertisement.git",
"com.gameframex.unity.advertisement.csj": "https://github.com/gameframex/com.gameframex.unity.advertisement.csj.git"
}
}
或在 Unity Package Manager 窗口中通过 git URL 添加。
在 Unity Inspector 中配置:将 AdvertisementComponent 添加到 GameObject,然后在实现类型下拉框中选择 CSJAdvertisementManager。
using GameFrameX.Advertisement.Runtime;
// 标准方式:通过 GameEntry(不依赖 com.gameframex.unity.entry)
var adComponent = GameEntry.GetComponent<AdvertisementComponent>();
// 设置服务端验证数据(可选)
adComponent.SetExtraData("userId", player.UserId);
// 播放激励视频广告
var option = new AdvertisementPlayOption
{
OnSuccess = (data) => Debug.Log("广告展示成功"),
OnFail = (err) => Debug.LogError($"广告展示失败: {err}"),
OnShowResult = (watched) =>
{
if (watched)
{
// 发放奖励
}
},
};
adComponent.Play(option);
// 快捷方式:通过 GameApp(需要 com.gameframex.unity.entry)
GameApp.Advertisement.SetExtraData("userId", player.UserId);
var option2 = new AdvertisementPlayOption
{
OnSuccess = (data) => Debug.Log("广告展示成功"),
OnFail = (err) => Debug.LogError($"广告展示失败: {err}"),
OnShowResult = (watched) =>
{
if (watched)
{
// 发放奖励
}
},
};
GameApp.Advertisement.Play(option2);
| 平台 | 支持 |
|---|---|
| iOS | 是 |
| Android | 是 |
| WebGL | 否 |
| Standalone | 否 |
需要
UNITY_IOS或UNITY_ANDROID脚本宏定义。
本项目基于 MIT 许可证 和 Apache 许可证 2.0 双重授权。