Game Frame X 廣告系統的快手小遊戲平台適配器。為發佈到快手小遊戲平台的遊戲提供激勵影片廣告整合。
ENABLE_KUAISHOU_MINI_GAME、ENABLE_KUAISHOU_MINI_GAME_ADVERTISEMENT)本套件是 Game Frame X 廣告核心 BaseAdvertisementManager 的適配器實現。透過 Unity Inspector 設定 AdvertisementComponent 後,自動發現並載入。
| 類別 | 說明 |
|---|---|
KuaiShouMiniGameAdvertisementManager | 激勵影片廣告管理器 — 載入、展示及生命週期管理 |
KuaiShouVideoAdCallback | 廣告載入/展示事件回調處理器 |
GameFrameXAdvertisementKuaiShouMiniGameCroppingHelper | IL2CPP link.xml 替代方案 — 保留類型引用 |
{
"dependencies": {
"com.gameframex.unity.advertisement": "https://github.com/GameFrameX/com.gameframex.unity.advertisement.git",
"com.gameframex.unity.advertisement.kuaishouminigame": "https://github.com/gameframex/com.gameframex.unity.advertisement.kuaishouminigame.git"
}
}
或在 Unity Package Manager 視窗中透過 git URL 新增。
在 Unity Inspector 中設定:將 AdvertisementComponent 新增到 GameObject,然後在實作類型下拉選單中選擇 KuaiShouMiniGameAdvertisementManager。
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);
| 平台 | 支援 |
|---|---|
| 快手小遊戲 (WebGL) | 是 |
| Android | 否 |
| iOS | 否 |
| Standalone | 否 |
需要
UNITY_WEBGL和ENABLE_KUAISHOU_MINI_GAME腳本巨集定義。
本專案基於 MIT 授權 和 Apache 授權 2.0 雙重授權。