Unity 概要

IGP Unity SDK を使うと、Unity ゲームに ゲーム認可、マルチプレイヤールーム、リアルタイム通信、実績、実名認証とアンチアディクション を組み込めます。導入側で必要なのは appId の設定だけで、IGP デスクトップクライアントやバックエンドサービスとの通信は SDK が処理します。

このページでは Unity 固有の詳細だけを扱います。機能別の導入手順は、「機能別に使う」の対応ページを優先して参照してください。

機能リスト

ゲーム認可: 起動時に、現在のプレイヤーが IGP 上でそのゲームを正しく所持しているか確認します。結果は authorized_online / authorized_offline を返します（プロトコル上は RequestGameAuthorization）。
デスクトップ接続: ローカルの IGP デスクトップクライアントへ接続し、リトライ、必要時の起動、capabilities 取得を行います。
ルーム: ルームの作成、参加、退出、および ready / start / finish のライフサイクルイベントをサポートします。host / guest で対称です。
リアルタイム通信: ルーム内の信頼性付きメッセージ、KCP データプレーン、大きなメッセージの自動分割を扱います。
State と RPC: プレイヤー状態の同期や、ルーム内の他プレイヤーに対するロジック呼び出しを行います。
実績: 実績の解除と進捗報告を行います。
実名認証とアンチアディクションモジュール: 任意導入で、状態イベント、年齢区分、残りプレイ時間を読めます。
Mirror transport: すでに Mirror を使っている Unity プロジェクト向けの任意パッケージです。

導入前提

Unity 2022.3 LTS 以上
Windows 10 以上
ローカルに IGP デスクトップクライアント がインストール済みであること
IGP 運営から発行された appId

パッケージ構成

Unity の import package として導入します。必要に応じて 3 つのパッケージを使います。

パッケージ	用途	対象プロジェクト
`cn.indiegp.sdk.unity`	runtime と Editor ツールを含むメインパッケージ	すべての導入案件で必須
`cn.indiegp.sdk.unity.mirror-transport`	Mirror transport アダプター	すでに Mirror を使っているプロジェクトのみ
`cn.indiegp.sdk.unity.compliance`	実名認証とアンチアディクション補助 API	状態やイベントの読み取りが必要なプロジェクト

メインパッケージにはサンプルも含まれます。インポート後は Assets/IGP.UnitySDK/Samples で確認できます。

StarterDemo - 最小導入例
RoomLifecycle - ルームライフサイクルの例
RealtimeMessaging - realtime / state / RPC の例
Achievements - 実績解除と進捗報告の例
HostedPlayground - 手動検証用の総合プレイグラウンド

導入を始める

パッケージを入れる: Unity インストール
対象機能に合わせて最小検証フローを完了する: Unity Quick Start
基本フローを確認する: 起動と接続
対象機能に応じて続ける:
対象機能に応じた確認を行う: テスト
Editor でデスクトップ機能または完全なルームフローをデバッグする場合: Unity デバッグ
最新のバージョンとダウンロードを確認する場合: リリースノート

現在の制約

Preview 段階のため、API に互換性のない変更が入る可能性があります。必ず固定バージョンを指定してください。
Windows 10 以上のみ対応です。他の OS はサポート範囲外です。
マルチプレイヤールーム機能はローカルの IGP デスクトップクライアントからの起動に依存します。CI やクラウドビルドのような完全ヘッドレス環境は、現時点でルーム経路の対象ユースケースではありません。

商標・著作権表示

このページおよび IGP Unity SDK は、Unity Technologies またはその関連会社によるスポンサー、提携、承認を受けたものではありません。

Unity、Unity ロゴ、およびその他の Unity 商標は、米国およびその他の地域における Unity Technologies またはその関連会社の商標または登録商標です。Unity の商標、ロゴ、ブランドアセットの使用は Unity trademark guidelines に従う必要があります。