Game Frame X Advertisement (CSJ / 穿山甲)

インディゲーム開発者向けオールインワンソリューション · インディ開発者の夢を支援

📖 ドキュメント • 🚀 クイックスタート • 💬 QQグループ

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

プロジェクト概要

Game Frame X 広告システムの穿山甲（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 の代替 — 型参照を保持

クイックスタート

インストール

広告コアパッケージをインストール
本アダプターを Unity Package Manager (UPM) で追加：

{
  "dependencies": {
    "com.gameframex.unity.advertisement": "https://github.com/GameFrameX/com.gameframex.unity.advertisement.git",
    "com.gameframex.unity.advertisement.csj": "https://github.com/gameframex/com.gameframex.unity.advertisement.csj.git"
  }
}

または Unity Package Manager ウィンドウで git URL から追加。

使用例

Unity Inspector で設定：GameObject に AdvertisementComponent を追加し、実装タイプのドロップダウンから CSJAdvertisementManager を選択します。

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);