logo
1
0
WeChat Login
docs(readme): 重写为多语言 README 并统一 GitHub URL

GameFrameX Logo

Game Frame X - 도우인 미니 게임 광고

Version License Documentation

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

📖 문서🚀 빠른 시작


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


프로젝트 개요

GameFrameX 광고 컴포넌트의 도우인 미니 게임 어댑터 레이어입니다. StarkSDK를 기반으로 리워드 동영상 광고의 로드, 표시 및 라이프사이클 관리를 래핑합니다.

빠른 시작

방법 1: manifest.json 수정

{
  "com.gameframex.unity.advertisement.douyinminigame": "https://github.com/gameframex/com.gameframex.unity.advertisement.douyinminigame.git"
}

방법 2: Unity Package Manager

Window > Package Manager를 열고 +를 클릭하여 Add package from git URL을 선택한 후 입력:

https://github.com/gameframex/com.gameframex.unity.advertisement.douyinminigame.git

방법 3: 수동 설치

이 저장소를 Unity 프로젝트의 Packages/ 디렉토리에 클론하면 자동으로 인식됩니다.

사용 예시

이 패키지는 com.gameframex.unity.advertisement의 하위 컴포넌트로, 공개 API를 직접 노출하지 않습니다. 메인 광고 패키지를 통해 통일적으로 접근하세요:

아키텍처

기능

  • 리워드 동영상 광고 로드 및 표시
  • 광고 로드/표시 성공 및 실패 콜백
  • 광고 닫기 시 유효 시청 자동 판정
  • IL2CPP 코드 스트리핑 방지 (Preserve 속성 + CroppingHelper)
  • 조건부 컴파일 (UNITY_WEBGL + ENABLE_DOUYIN_MINI_GAME)

의존성

의존성설명
com.gameframex.unity.advertisement메인 광고 패키지, BaseAdvertisementManager 기본 클래스 제공
starksdk.dllByteDance StarkSDK 런타임 라이브러리
ttsdk.dllByteDance TTSDK 런타임 라이브러리

프로젝트 구조

Runtime/
├── DouYinMiniGame/
│   ├── DouYinMiniGameAdvertisementManager.cs   # 광고 관리자, BaseAdvertisementManager 상속
│   └── DouYinVideoAdCallback.cs                # 동영상 광고 콜백 핸들러
├── GameFrameXAdvertisementDouYinMiniGameCroppingHelper.cs  # 스트리핑 방지 헬퍼
└── GameFrameX.Advertisement.DouYinMiniGame.Runtime.asmdef   # 어셈블리 정의

플랫폼 지원

  • 코드는 UNITY_WEBGLENABLE_DOUYIN_MINI_GAME이 정의된 경우에만 컴파일됩니다.
  • 도우인 공식 SDK의 리워드 광고 인터페이스는 표시 성공/실패 콜백을 완전히 구현하지 않아, 일부 콜백이 트리거되지 않을 수 있습니다.

문서 및 자료

라이선스

MIT