クライアント基本インターフェース

概要

ACE PCアンチチートのクライアントSDKは、ゲームクライアントに統合してローカル環境でのチート検出と保護を行うためのインターフェースを提供します。

初期化

クライアントSDKの初期化

cpp

// クライアントSDKの初期化
AceClientConfig config;
config.game_id = GAME_ID;
config.game_key = "your_game_key";
config.log_level = ACE_LOG_INFO;

int ret = AceClientInit(&config);
if (ret != 0) {
    printf("ACE Client SDK init failed: %d\n", ret);
}

主要インターフェース

ユーザーログイン通知

プレイヤーがゲームにログインした際に呼び出します：

cpp

AceUserLogin(player_id, session_token);

ユーザーログアウト通知

プレイヤーがゲームからログアウトした際に呼び出します：

cpp

AceUserLogout(player_id);

アンチチートデータ取得

サーバーに送信するアンチチートデータを取得します：

cpp

char buffer[4096];
int data_len = 0;
int ret = AceGetAntiCheatData(buffer, sizeof(buffer), &data_len);

コールバック設定

ローカルでのチート検出コールバックを設定します：

cpp

void OnLocalCheatDetected(int cheat_type, const char* detail) {
    printf("Local cheat detected: type=%d\n", cheat_type);
}

AceSetLocalCheatCallback(OnLocalCheatDetected);

ゲームループ統合

ゲームのメインループ内で定期的に呼び出す必要があるインターフェースです：

cpp

// ゲームメインループ内
void GameLoop() {
    // ... ゲームロジック ...
    
    // ACEの定期処理（フレームごと、または一定間隔で呼び出し）
    AceClientTick();
}

終了処理

cpp

AceClientUninit();

エラーコード

コード	説明
0	成功
-1	未初期化
-2	パラメータ不正
-3	初期化失敗
-4	ドライバーロード失敗
-5	ネットワークエラー

注意事項

初期化はゲーム起動直後に実行してください
AceClientTick()は定期的に呼び出す必要があります
ゲーム終了時には必ずAceClientUninit()を呼び出してください
マルチスレッド環境での使用に対応しています

クライアント基本インターフェース ​

概要 ​

初期化 ​

クライアントSDKの初期化 ​

主要インターフェース ​

ユーザーログイン通知 ​

ユーザーログアウト通知 ​

アンチチートデータ取得 ​

コールバック設定 ​

ゲームループ統合 ​

終了処理 ​

エラーコード ​

注意事項 ​