コンテンツにスキップ
🚧 Preview · GameMaker アダプターはまだ初期プレビュー段階であり、API は今後も変更される可能性があります。

GameMaker 概要

IGP GameMaker SDK を使うと、GameMaker ゲームに IGP のゲーム認可、実名認証とアンチアディクション、実績を組み込めます。最初の公開版は Windows のデスクトップクライアント機能に集中しており、ルーム機能はまだ未対応です。

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

  • ランタイムライフサイクル: 初期化、フレーム更新、状態スナップショット取得、イベントポーリング、終了処理を行えます。
  • ゲーム認可: 起動時に、現在のプレイヤーが IGP 上でそのゲームを正しく所持しているか確認し、authorized_online / authorized_offline などの状態を返します(プロトコル上は RequestGameAuthorization)。
  • 接続状態の確認: ローカルの IGP デスクトップクライアントとの接続が準備できているかを観測できます。
  • デスクトップ capabilities: 呼び出し前に、現在のデスクトップ連携で使える機能を確認できます。
  • 実名認証とアンチアディクション: 現在状態の読み取り、状態更新、anti_addiction_state_changed イベント受信ができます。
  • 実績解除: key を指定して実績を解除できます。
  • 実績進捗報告: key と増分を指定して進捗を送れます。
  • イベントキュー: 接続、認可、アンチアディクション、実績、エラー、切断イベントを 1 つのポーリング経路で受け取れます。
  • マルチプレイヤールーム(作成 / 参加 / ready / realtime / state / RPC)
  • macOS / Linux / コンソール / モバイル
  • 現在の Windows runtime 以外の GameMaker ターゲット
  • GameMaker 2024.2 LTS 以上
  • Windows 10 以上
  • ローカルに IGP デスクトップクライアント がインストール済みであること
  • IGP 運営から発行された appId

GameMaker アダプターは zip パッケージとして配布されます。展開後には次が含まれます。

  • IGP.GamemakerDesktopBridge.Native.dll - Windows 用ネイティブブリッジ
  • GML runtime スクリプト - ブリッジの C API を GameMaker 関数へ包むもの
  • windows-auth-achievements サンプルプロジェクト - GameMaker でそのまま開ける
  • INTEGRATION.mdSMOKE-CHECKLIST.md - 導入手順とスモークチェック手順

現在のバージョンとダウンロードは リリースノート にあります。

  1. GameMaker インストール を読む
  2. 最小検証フローを完了する: GameMaker Quick Start
  3. 基本フローを確認する: 起動と接続
  4. 対象機能に応じて続ける:
  5. 一通りの確認を行う: テスト
  6. 状態やエラーを調べる場合: GameMaker デバッグ
  7. エクスポート関数や低レベル境界を確認する場合: GameMaker Native Bridge
  8. サンプルプロジェクトとパッケージ内容を確認する場合: Windows 認可・実績サンプル

このページおよび IGP GameMaker SDK は、YoYo Games、GameMaker、Opera によるスポンサー、提携、承認を受けたものではありません。

GameMaker、GameMaker ロゴ、および関連ブランドアセットは、YoYo Games / Opera およびその関連会社に帰属します。GameMaker の名称、ロゴ、ブランドアセットの使用は GameMaker brand guidelines に従う必要があります。