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 雙重授權。