https://github.com/gameframex/com.gameframex.unity.advertisement.csj
CSJ (穿山甲/Pangle) advertisement adapter for Game Frame X — rewarded video ads for iOS/Android Unity games with native bridge and IL2CPP protection
https://github.com/gameframex/com.gameframex.unity.advertisement.csj
ads advertisement android bytedance csharp csj game-framework gameframex ios mobile-sdk pangle rewarded-video unity unity3d upm
Last synced: 10 days ago
JSON representation
CSJ (穿山甲/Pangle) advertisement adapter for Game Frame X — rewarded video ads for iOS/Android Unity games with native bridge and IL2CPP protection
- Host: GitHub
- URL: https://github.com/gameframex/com.gameframex.unity.advertisement.csj
- Owner: GameFrameX
- License: apache-2.0
- Created: 2026-05-15T14:21:17.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-22T03:22:50.000Z (11 days ago)
- Last Synced: 2026-06-22T05:11:57.243Z (10 days ago)
- Topics: ads, advertisement, android, bytedance, csharp, csj, game-framework, gameframex, ios, mobile-sdk, pangle, rewarded-video, unity, unity3d, upm
- Language: C#
- Homepage: https://gameframex.doc.alianblank.com
- Size: 59.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Game Frame X Advertisement (CSJ / 穿山甲)
[](https://github.com/GameFrameX/com.gameframex.unity.advertisement.csj/blob/main/LICENSE.md)
[](https://github.com/GameFrameX/com.gameframex.unity.advertisement.csj/releases)
[](https://unity.com/)
[](https://gameframex.doc.alianblank.com)
インディゲーム開発者向けオールインワンソリューション · インディ開発者の夢を支援
[ドキュメント](https://gameframex.doc.alianblank.com) · [クイックスタート](#quick-start) · QQグループ: 467608841 / 233840761
[English](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | **日本語** | [한국어](README.ko.md)
## プロジェクト概要
[Game Frame X 広告システム](https://github.com/GameFrameX/com.gameframex.unity.advertisement)の穿山甲（CSJ/Pangle）プラットフォームアダプター。ByteDance の穿山甲広告 SDK を使用し、iOS/Android アプリ向けにリワード動画広告の統合を提供します。
### 機能
- 穿山甲（CSJ/Pangle）SDK によるリワード動画広告サポート
- ネイティブ iOS/Android プラットフォームサポート
- IL2CPP コードストリッピング保護
- 条件付きコンパイル（`UNITY_IOS`、`UNITY_ANDROID`）
- Game Frame X 広告コンポーネントとのシームレスな統合
## アーキテクチャ
本パッケージは Game Frame X 広告コアの `BaseAdvertisementManager` の**アダプター実装**です。Unity Inspector で `AdvertisementComponent` を設定することで自動的に検出・読み込みされます。
| クラス | 説明 |
|--------|------|
| `CSJAdvertisementManager` | リワード動画広告マネージャー — ロード、表示、ライフサイクル管理 |
| `CSJAdvertisementConfig` | appId と adUnitId フィールドを含む広告設定 |
| `CSJBridge` | iOS/Android ネイティブプラットフォーム呼び出しブリッジ |
| `CSJNativeMessageHandler` | ネイティブメッセージコールバックハンドラー |
| `GameFrameXAdvertisementCSJCroppingHelper` | IL2CPP link.xml の代替 — 型参照を保持 |
## クイックスタート
### インストール
以下のいずれかの方法を選択してください：
1. Unity プロジェクトの `Packages/manifest.json` を編集し、`scopedRegistries` セクションを追加してください：
```json
{
"scopedRegistries": [
{
"name": "GameFrameX",
"url": "https://gameframex.upm.alianblank.uk",
"scopes": [
"com.gameframex"
]
}
],
"dependencies": {
"com.gameframex.unity.advertisement.csj": "1.0.0"
}
}
```
`scopes` は、どのパッケージをこのレジストリから解決するかを制御します。`com.gameframex` で始まるパッケージのみがこのレジストリから取得されます。
2. `manifest.json` の `dependencies` に直接追加：
```json
{
"com.gameframex.unity.advertisement.csj": "https://github.com/gameframex/com.gameframex.unity.advertisement.csj.git"
}
```
3. Unity の **Package Manager** で **Git URL** を使用して追加：`https://github.com/gameframex/com.gameframex.unity.advertisement.csj.git`
4. リポジトリを Unity プロジェクトの `Packages` ディレクトリにクローンしてください。自動的に読み込まれます。
## プラットフォーム対応
| プラットフォーム | 対応 |
|------------------|------|
| iOS | はい |
| Android | はい |
| WebGL | いいえ |
| Standalone | いいえ |
> `UNITY_IOS` または `UNITY_ANDROID` スクリプト定義シンボルが必要です。
## ドキュメントとリソース
- [Game Frame X ドキュメント](https://gameframex.doc.alianblank.com)
- [穿山甲開発者ポータル](https://www.csjplatform.com)
## コミュニティとサポート
- QQグループ：[参加](https://qm.qq.com/q/urCUAqJCJm)
- GitHub Issues：[バグ報告](https://github.com/gameframex/com.gameframex.unity.advertisement.csj/issues)
## 変更履歴
### v1.0.0
- 初回リリース
- 穿山甲（CSJ/Pangle）プラットフォームのリワード動画広告対応
- IL2CPP ストリッピング保護
## 依存関係
| パッケージ | 説明 |
|----------|------|
| (无) | - |
## ライセンス
詳しくは [LICENSE.md](LICENSE.md) をご参照ください。