Unity 概要
IGP Unity SDK を使うと、Unity ゲームに ゲーム認可、ゲームデータ同期、実績、実名認証とアンチアディクション を組み込めます。
このページでは Unity 固有の詳細だけを扱います。機能別の導入手順は、「機能別に使う」の対応ページを優先して参照してください。
- ゲーム認可: 起動時に、現在のプレイヤーが IGP 上でそのゲームを正しく所持しているか確認します。結果は
authorized_online/authorized_offlineを返します（プロトコル上はRequestGameAuthorization）。 - デスクトップ接続: ローカルの IGP デスクトップクライアントへ接続し、リトライ、必要時の起動、capabilities 取得を行います。
- ゲームデータ同期: 対局開始後、RoomNode の KCP/TCP reliable と任意の UDP unreliable lane で realtime とゲームデータを転送します。
- State と RPC: プレイヤー状態の同期や、ルーム内の他プレイヤーに対するロジック呼び出しを行います。
- 実績: 実績の解除と進捗報告を行います。
- 実名認証とアンチアディクションモジュール: 任意導入で、状態イベント、年齢区分、残りプレイ時間を読めます。
- Mirror transport: すでに Mirror を使っている Unity プロジェクト向けの任意パッケージです。
- GameKit / Leaderboard / Share: ランキングや共有などの GameKit 機能を任意で導入できます。
- Unity
2022.3 LTS以上 - Windows 10 以上
- Desktop 機能を使う場合はローカルに IGP デスクトップクライアント が必要です
- IGP 運営から発行された
appId
パッケージ構成
Section titled “パッケージ構成”4 つの公開 module を必要に応じて導入します。各 module は Unity Package とオフライン UPM tarball の両方で提供します。
| パッケージ | 用途 | 対象プロジェクト |
|---|---|---|
cn.indiegp.sdk.unity | runtime と Editor ツールを含むメインパッケージ | すべての導入案件で必須 |
cn.indiegp.sdk.unity.multiplayer | RoomNode Game data plane、Realtime、KCP/TCP/UDP、および任意の Mirror integration | ゲームデータ同期または Mirror が必要なプロジェクト |
cn.indiegp.sdk.unity.compliance | 実名認証とアンチアディクション補助 API | 状態やイベントの読み取りが必要なプロジェクト |
cn.indiegp.sdk.unity.game-kit | GameKit 拡張パッケージ。現在は Leaderboard と Share を含みます | ランキングや共有などの GameKit 機能が必要なプロジェクト |
メインパッケージの Assets/IGP.UnitySDK/Samples には Achievements があります。
Multiplayer パッケージの Assets/IGP.UnitySDK.Multiplayer/Samples には次のサンプルがあります。
RealtimeMessaging- realtime / state / RPC の例
導入を始める
Section titled “導入を始める”Core は現在の Unity runtime platform を Desktop、Mobile の順に判定し、
一致した Host Session runtime を 1 つだけ作成します。attach 失敗で platform
は切り替わらず、利用者による設定も不要です。Multiplayer はその選択を参照しません。引数なしの入口は現在の Core provider
から descriptor を取得し、descriptor overload は呼び出し元から明示的に
受け取ります。どちらも RoomNode の Game data plane だけを作成します。
- パッケージを入れる: Unity インストール
- 対象機能に合わせて最小検証フローを完了する: Unity Quick Start
- 基本フローを確認する: 起動と接続
- 対象機能に応じて続ける:
- 対象機能に応じた確認を行う: テスト
- Editor でデスクトップ機能をデバッグする場合: Unity デバッグ
- 最新のバージョンとダウンロードを確認する場合: リリースノート
- Preview 段階のため、API に互換性のない変更が入る可能性があります。必ず固定バージョンを指定してください。
- Windows 10 以上のみ対応です。他の OS はサポート範囲外です。
- Host descriptor の取得失敗は warning だけを記録し、Core 初期化を失敗
させません。
IsRuntimeCreatedは false のままで、明示的に再試行できます。 - 現在の正式な検証対象は Windows Desktop のみです。Mobile Host provider は 公開 support matrix にまだ含まれていません。
商標・著作権表示
Section titled “商標・著作権表示”このページおよび IGP Unity SDK は、Unity Technologies またはその関連会社によるスポンサー、提携、承認を受けたものではありません。
Unity、Unity ロゴ、およびその他の Unity 商標は、米国およびその他の地域における Unity Technologies またはその関連会社の商標または登録商標です。Unity の商標、ロゴ、ブランドアセットの使用は Unity trademark guidelines に従う必要があります。