Game Frame X Advertisement (KuaiShou Mini Game)

인디 게임 개발자를 위한 올인원 솔루션 · 인디 개발자의 꿈을 실현

📖 문서 • 🚀 빠른 시작 • 💬 QQ 그룹

🌐 언어: English | 简体中文 | 繁體中文 | 日本語 | 한국어

프로젝트 개요

Game Frame X 광고 시스템의 쿠아이서우(快手) 미니 게임 플랫폼 어댑터. 쿠아이서우 미니 게임 플랫폼에 게시되는 게임을 위한 리워드 동영상 광고 통합을 제공합니다.

기능

쿠아이서우 미니 게임 SDK 기반 리워드 동영상 광고 지원
광고 자동 로드 및 표시 실패 시 재시도
IL2CPP 코드 스트리핑 보호
조건부 컴파일 (ENABLE_KUAISHOU_MINI_GAME, ENABLE_KUAISHOU_MINI_GAME_ADVERTISEMENT)
Game Frame X 광고 컴포넌트와 원활한 통합

아키텍처

이 패키지는 Game Frame X 광고 코어의 BaseAdvertisementManager 어댑터 구현입니다. Unity Inspector에서 AdvertisementComponent를 설정하면 자동으로 검색 및 로드됩니다.

클래스	설명
`KuaiShouMiniGameAdvertisementManager`	리워드 동영상 광고 관리자 — 로드, 표시 및 수명 주기 관리
`KuaiShouVideoAdCallback`	광고 로드/표시 이벤트 콜백 핸들러
`GameFrameXAdvertisementKuaiShouMiniGameCroppingHelper`	IL2CPP link.xml 대체 — 타입 참조 유지

빠른 시작

설치

광고 코어 패키지 설치
이 어댑터를 Unity Package Manager (UPM)로 추가:

{
  "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에서 설정: GameObject에 AdvertisementComponent를 추가한 후, 구현 유형 드롭다운에서 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);