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

GameFrameX Logo

Game Frame X - 抖音小游戏广告

Version License Documentation

独立游戏前后端一体化解决方案 · 独立游戏开发者的圆梦大使

📖 文档🚀 快速开始


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


项目简介

GameFrameX 广告组件的抖音小游戏适配层,基于 StarkSDK 封装激励视频广告的加载、展示与生命周期管理。

快速开始

方式一:修改 manifest.json

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

方式二:Unity Package Manager

打开 Window > Package Manager,点击 + 选择 Add package from git URL,输入:

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

方式三:手动安装

将本仓库克隆到 Unity 项目的 Packages/ 目录下即可自动识别。

使用示例

本包为 com.gameframex.unity.advertisement 的子组件,不直接对外暴露接口。请通过主广告包统一调用:

架构概览

功能特性

  • 激励视频广告加载与展示
  • 广告加载/展示成功与失败回调
  • 广告关闭时自动判断有效观看
  • IL2CPP 代码裁剪防护(Preserve 属性 + CroppingHelper
  • 条件编译(UNITY_WEBGL + ENABLE_DOUYIN_MINI_GAME

依赖

依赖说明
com.gameframex.unity.advertisement广告主包,提供 BaseAdvertisementManager 基类
starksdk.dll字节跳动 StarkSDK 运行时库
ttsdk.dll字节跳动 TTSDK 运行时库

项目结构

Runtime/
├── DouYinMiniGame/
│   ├── DouYinMiniGameAdvertisementManager.cs   # 广告管理器,继承 BaseAdvertisementManager
│   └── DouYinVideoAdCallback.cs                # 视频广告回调处理器
├── GameFrameXAdvertisementDouYinMiniGameCroppingHelper.cs  # 防裁剪辅助类
└── GameFrameX.Advertisement.DouYinMiniGame.Runtime.asmdef   # 程序集定义

平台支持

  • 代码仅在 UNITY_WEBGL 且定义了 ENABLE_DOUYIN_MINI_GAME 宏时编译。
  • 抖音官方 SDK 的激励广告接口未完整实现播放成功/失败的回调,部分回调可能不会触发。

文档与资源

开源协议

MIT