CGC-内観

したがって、 CGCに関するトピックの続きで、私自身の経験に基づいてこのようなコンテストを開催するためのシステムの技術的な詳細を明らかにします。

1. システム構成
   まず、この種のシステムの構成要素を決定しましょう。
   まあ、最初に、最も重要なことはシミュレーションモジュールです。 さらに、もちろん、これはクライアントとサーバーであり、最後に、Code Game Showの最も重要な部分はビジュアライザーです。 次に、これらの各部分を個別に検討します。
   
   1. シミュレーター
      シミュレーションモジュールは、世界の物理、ユニットのセット、および一般的にゲームの世界に関連するすべてを定義します。 さらに、このモジュールは戦略間の戦いのシミュレーションを担当します。
      これは最初の質問を提起します-戦闘の結果を記録するものは何ですか？
      最初のオプションは、戦闘の経過に関する特定のストーリーを記録することです。これは、ビジュアライザーを使用して後で再現できます。
      2番目のアプローチは、シミュレーションとプレイを同時に行うことです。
      アプローチにはそれぞれ長所と短所があります。 2番目のアプローチの利点は、参加者が開発中の戦略の分析に費やす時間を削減することです。 ただし、最初のアプローチでは、速度と再生ポイントを設定する機能を実装できます。
      シミュレータのもう1つの重要な詳細は、異なる言語で記述された戦略からデータを収集できる必要があることです。
      
      ここには、いくつかの実装オプションがあります。
      最初の選択肢は、DLLでメンバー戦略をコンパイルし、シミュレータからこれらのライブラリを接続することです。 ただし、このオプションにはいくつかの問題があります。
      
      • すべての言語がDLL出力を提供できるわけではありません
      • DLLを使用する場合、それらは一般的なプロセスにロードされ、意図的にドロップする場合があります。
      
      より安全なのは、実行可能ファイルでコンパイルし、プロセス間通信を使用してシミュレータと参加者の戦略を伝達するオプションです。 コミュニケーションには好きなものを使用できます。実際には、標準の入出力を使用するシステム（ただし、お勧めしません）、ソケットを介して通信するシステムを見てきました。
      まあ、シミュレータのロジックは非常に簡単です：
      
      • 参加戦略とゲーム世界に関する情報（たとえば、使用したカードの識別子）が受信されます
      • シミュレータは参加者の戦略を起動し、代わりにInitメソッドを実行するコマンドを渡します
      • シミュレーターは各戦略のInitメソッドの結果を受け取り、ユーザーコードのエラー（実行時、制限時間、メモリ制限）を処理します。
      • シミュレーターは、Moveメソッドを1つずつ実行するコマンドを渡し、結果を収集します
      • 値を許容可能な間隔に戻し、戦闘をシミュレートします
      • ゲーム変数の値を更新し、Moveメソッドを再度呼び出します
      • 戦いの終わりに、戦いの結果を記録します
      
      
   2. お客様
      クライアントの主なタスクは、ソリューションを送信し、戦いの視聴を開始することです。
      規則の不正確さを解決するために、ju審員と参加者との間のコミュニケーションを機能させることも有用かもしれません。 競合中にクライアントが変更され、自動更新機能も役立つ場合に状況が発生することがあります。
      クライアントに機能はありません。
      
   3. サーバー
      サーバーは最も重大な部分の1つです。 競争の最初と最後の数分は、通常、サーバーにとって非常に良いテストです-そして、これらの分での検証要求は十分に大きく、サーバーは許容可能な時間内にそれらに応答する必要があります。
      
      サーバーには何が含まれていますか？ シミュレーションモジュールに移動します。
      実際には、ユーザーの接続とユーザーからの決定の受け入れに役立つメインサーバー。 これらのソリューションはコンパイルされます。 正常にコンパイルされたソリューションは、シミュレーションモジュールに渡されます。
      
      参加者がインストールするのと同じコンパイラを使用することを強くお勧めします-これによりエラーの数が減ります。
      
      ユーザー決定の処理を高速化するために、クラスターを使用できます（TIT SFUの場合と同様）が、クラスターがない場合は、分散サーバーを実装できます。
      
   4. ビジュアライザー
      このモジュールは、戦いを表示するために使用されます。 カラフルな特殊効果は、視聴をより面白く刺激的なものにし、再生を制御する機能がある場合、参加者の生活を簡素化します。 ただし、エフェクトに夢中にならないでください。ビジュアライザの速度が大幅に低下すると、競争が不可能になることに注意してください。
      
   
   
2. ユーザーAPI
   まあ、それはすべてあなたの想像力に依存します、私が注意したい唯一のことは、戦略をデバッグするためのメソッドを作ることをお勧めすることです-例えば、デバッグメッセージを出力する（戦略を書くときにのみ表示される）、ポイントとベクトルを出力する
   
   また、1日でAPIを発行することをお勧めします。2日間で、コンテストの前に、参加者の小さな集まりを配置して質問に答えます。 この記事の最後の例は、いずれかのCGCのAPIです。
   
3. 備考
   ゲームの世界に関するいくつかのコメント。 まず、難易度を検討します-参加者はゲームの世界を探索し、戦略を実行するのに4〜5時間しかありません。 ゲームの世界がより厳しくなればなるほど、プレイヤーは面白くなくなり、コードゲームショーの見栄えも悪くなります。
   
   ワールドが非常に複雑であるが、変更したくない場合は、ユーザーAPIに高レベルのメソッド（2点間のパスを見つけるメソッドなど）を含めるようにしてください。 あなたは1日か2日以上過ごす必要があります-それは通常1週間から1ヶ月かかります。
   最も一般的な言語のサポートを試みてください-これは参加者の輪を広げます。
   ゲームのバランスを取るための時間をとってください-バランスをとるためには、1〜2日以上を費やす必要があります。通常は1週間から1か月かかります。
   
4. ユーザーAPIの例
   IBonusインターフェイス-ボーナスオブジェクトのインターフェイスについて説明します
   IBonus：パブリックIMoveableObject
   ヒットポイントボーナスを取得
   戻り値：ボットがボーナスを獲得した場合にボットが受け取るヒットポイントの数
   int GetHP（）
   
   機関銃の弾薬ボーナスを取得する
   戻り値：ボーナスを拾った場合にボットが受け取るマシンガンの弾丸の数
   int GetMashinegunAmmo（）
   レーザー弾薬ボーナスを入手
   戻り値：ボットがボーナスを受け取った場合に受け取るマシンガンのチャージ数
   int GetLaserAmmo（）
   
   銃の弾薬ボーナスを取得する
   戻り値：ボットがボーナスを受け取った場合に受け取るマシンガンの砲弾の数
   int GetCannonAmmo（）
   
   ロケットランチャーの弾薬ボーナスを取得する
   戻り値：ボットがボーナスを受け取る場合に受け取るミサイルの数
   int GetRocketAmmo（）
   
   ボットの寿命を取得する
   戻り値：移動中のボーナスの残りのライフタイム
   int GetElapsedTime（）
   
   IBotインターフェイス-ゲームユニットのインターフェイスについて説明します
   IBot：パブリックIMoveableObject
   
   チーム名を取得
   戻り値：コマンドの名前を返します
   文字列GetTeamName（）
   
   ボット名を取得
   戻り値：ボットの名前または指定されていない場合は空の文字列を返します
   文字列GetName（）
   
   弾薬と銃の状態に関する情報を入手する
   この情報には、弾薬に関する情報（砲弾の数）と、銃が発射できる状態になるまでの時間が含まれています
   戻り値：銃の現在の状態
   SWeaponInfo GetCannon（）
   
   弾薬と機関銃の状態に関する情報を取得する
   この情報には、弾薬に関する情報（砲弾の数）と、機関銃の発射準備が整うまでの時間が含まれています。
   戻り値：マシンガンの現在の状態
   SWeaponInfo GetMashineGun（）
   
   弾薬とレーザーの状態に関する情報を入手する
   この情報には、弾薬に関する情報（電荷の数）とレーザーが発射できる状態になるまでの時間が含まれます。
   戻り値：現在のレーザーステータス
   SWeaponInfo GetLaser（）
   
   弾薬とロケットランチャーの状態に関する情報を取得する
   情報には、弾薬に関する情報（ショット数）とロケット発射装置が発射する準備が整うまでの時間が含まれます。
   戻り値：ロケットランチャーの現在の状態
   SWeaponInfo GetRocket（）
   
   ボットの種類を取得する
   戻り値：現在のボットのタイプを返します
   BotType GetType（）
   
   タワーターンを取得
   タワーの回転は、ボットの直径面に対してカウントされます。
   戻り値：ラジアン単位のタワーの相対回転
   フロートGetTurrelAngle（）
   
   ボットの健康状態を取得する
   戻り値：現在のヒットポイント数
   int GetHP（）
   インターフェースIMoveableObject-移動可能なオブジェクトのインターフェースを記述します。
   
   オブジェクトの位置を取得
   オブジェクトの中心の座標を返します。
   戻り値：左上隅の座標
   ポイントGetPosition（）
   
   オブジェクトの回転角度を取得します
   座標系の詳細については、IWorldインターフェイスの説明を参照してください
   戻り値：オブジェクトの回転をラジアンで返します
   フロートGetDirection（）
   
   オブジェクトの半径を取得
   ボーナス、シェル、ボットは円であり、
   戻り値：オブジェクトの半径を返します
   フロートgetradius（）
   
   オブジェクトの速度を取得する
   戻り値：速度ベクトルのモジュールを返します
   フロートGetSpeed（）
   
   衝撃速度ベクトルを取得する
   ボットが何らかのオブジェクト（発射物、別のボット、マップオブジェクト、ボーナスを除く）と衝突したとき、およびショット中に、パルス速度を取得します。
   戻り値：衝撃速度ベクトル
   ベクトルGetImpulseVelocity（）
   
   オブジェクトのテキストラベルを設定する
   テキストラベルを設定すると、オブジェクトを識別できます。 オブジェクトにラベルを設定すると、後でそのラベルから取得できます。 テキストラベルはどこにも表示されません。 参加者には、他の参加者のテキストラベルは表示されません。
   ボットにメモを貼ることは禁止されています。このようなマークは毎ターンリセットされます。
   パラメータ：
   オブジェクトのテキストラベルをマークする
   void SetMark（intマーク）
   現在のオブジェクトラベルを取得する
   戻り値：オブジェクトの現在のラベル;ラベルが設定されていない場合、-1が返されます
   int GetMark（）
   
   ISelfインターフェース-管理対象ユニットのインターフェースについて説明します。
   ISelf：パブリックIBot
   
   ボット名を設定
   ボットの名前の設定は、Init関数内でのみ可能です。 Move内の呼び出しは無視されます
   ボットの名前は20文字を超えないようにしてください。 名前の長さがそれらを超える場合、必要な長さに短縮されます。
   パラメータ：
   ボットの名前
   void SetName（文字列名）
   ボットタイプを設定する
   異なるタイプのボットには異なる特性があります。 ボットタイプの設定は、Init関数内でのみ可能です。 Move内の呼び出しは無視されます。
   パラメータ：
   タイプボットタイプ
   void SetType（BotTypeタイプ）
   
   設定速度
   速度ベクトルの値を変更します。 負の値は後方への移動に対応します。 速度が最大しきい値を超えるか、最小しきい値を下回る場合、許容値まで減少/増加します。
   パラメータ：
   スピード新しいスピード
   void SetSpeed（フロート速度）
   
   ボットの回転を設定する
   パラメータ：
   angleラジアン単位の新しい回転角度
   void SetDirection（フロート角）
   ボットタワーの回転を変更する
   パラメータ：
   ラジアン単位のデルタタワー角度増分
   void TurnTurrel（フロートデルタ）
   機関銃の発射
   機関銃からショットを行います。 マシンガンは常にボットの方向に向けて撃ちます。 機関銃のショットの準備ができていない場合、何も起こりません。
   void ShotMashinegun（）
   
   銃を発射する
   銃から撃ちます。 銃は塔に取り付けられています。 銃の発射準備が整っていない場合は、何も起こりません。
   void ShotCannon（）
   
   レーザーを発射する
   レーザーショットを発射します。 レーザーは常にボットの方向に向けて発射します。 レーザーを発射する準備ができていない場合、何も起こりません。
   パラメータ：
   レーザーの回転角
   void ShotLaser（フロート角）
   
   ロケットランチャーの発射
   ロケットランチャーからショットを作成します。 ロケットランチャーの発射準備が整っていない場合、何も起こりません。
   パラメータ：
   ターゲットターゲット
   void ShotRocket（IMoveableObject *ターゲット）
   
   IShellインターフェイス-マップ上にあるシェルのインターフェイスについて説明します。
   IShell：パブリックIMoveableObject
   
   所有者を取得します。
   戻り値：このシェルによって起動されたボット
   IBot * GetOwner（）
   
   ターゲットを取得します。
   レーザー、銃、機関銃などの砲弾の場合、ターゲットはNULLです
   オブジェクトが破棄された場合、NULLが返されます。
   戻り値：発射物ターゲット。
   IMoveableObject * GetTarget（）
   シェルのタイプを取得します。
   戻り値：シェルタイプ、詳細についてはShellTypeの説明を参照
   ShellType GetType（）
   戻り値：シェルからダメージを受けます。
   戻り値：発射物の損傷
   int GetHP（）
   
   インターフェイスIStaticObject-静的マップオブジェクトのインターフェイスについて説明します。
   オブジェクトのヒットポイントの数を取得する
   戻り値：ヒットポイントの現在の値
   int GetHP（）
   
   オブジェクト座標を取得する
   静的オブジェクトの座標は、その左上隅に対応しています。 座標系の詳細については、IWorldを参照してください
   戻り値：オブジェクト座標
   ポイントGetPosition（）
   
   オブジェクトサイズを取得する
   戻り値：オブジェクトサイズ
   サイズGetSize（）
   
   インターフェイスIWorld-ゲームワールドのインターフェイスについて説明します。
   
   現在の移動番号を取得
   番号付けは1から行われます。ゼロ移動はInitの呼び出しに対応します
   戻り値：現在の移動番号
   int GetCurrentStep（）
   
   総移動数を取得する
   戻り値：移動の総数（初期化を除く）
   int GetTotalStep（）
   
   静的オブジェクトのリストを取得します
   このリストはstd :: vectorタイプに基づいており、インデックスによるアクセスを許可します
   破壊されたオブジェクトはゲームから削除され、このリストには表示されません。
   戻り値：静的マップオブジェクトのリスト
   IStaticObjectList GetStaticObjects（）
   
   敵ボットのリストを取得する
   このリストはstd :: vectorタイプに基づいており、インデックスによるアクセスを許可します
   殺されたボットはゲームから削除され、このリストには表示されません。
   戻り値：敵ボットのリスト
   IEnemyList GetEnemies（）
   
   ボットのリストを取得する
   このリストはstd :: vectorタイプに基づいており、インデックスによるアクセスを許可します
   殺されたボットはゲームから削除され、このリストには表示されません。
   戻り値：ボットのリスト
   ISelfList GetSelfs（）
   
   マップ上のシェルのリストを取得します
   このリストはstd :: vectorタイプに基づいており、インデックスによるアクセスを許可します
   マップから飛んだり、オブジェクトと衝突したシェルはゲームから削除され、このリストには表示されません
   戻り値：マップ上のシェルのリスト
   IShellList GetShells（）
   
   カードのボーナスのリストを取得する
   このリストはstd :: vectorタイプに基づいており、インデックスによるアクセスを許可します
   有効期限が切れたボーナスやピックアップされたボーナスはゲームから削除され、このリストには表示されません
   戻り値：マップ上にあるボットのリスト
   IBonusList GetBonuses（）
   
   タグでオブジェクトを取得
   パラメータ：
   受信したオブジェクトのラベルをマークします
   戻り値：そのようなラベルを持つオブジェクトが見つかった場合、そのオブジェクトへのポインターが返され、そうでない場合はNULLが返されます
   IMoveableObject * GetByMark（intマーク）
   デバッグメッセージを追加
   デバッグのために視覚化中に表示されるデバッグメッセージを追加します。
   パラメータ：
   formatメッセージフォーマットは、長さn文字の文字列です。 次は、タスク形式に応じたn個のパラメーターです。
   dは整数（int）
   f-小数（浮動小数点数）
   s-文字列（文字列）
   他のすべての文字は解釈されず、メッセージに分類されます
   1つのメッセージの合計長は255文字を超えてはなりません。 文字列が長い場合、必要なサイズに縮小されます
   void AddMessage（文字列形式、...）
   
   デバッグポイントを追加
   デバッグのために視覚化中に表示されるデバッグポイントを追加します。
   パラメータ：
   p点座標
   動きでベクトルを表示するライフタイム
   void AddPoint（ポイントp、intライフタイム）
   
   デバッグベクターを追加
   デバッグのために視覚化中に表示されるデバッグベクトルを追加します。
   パラメータ：
   出発点
   終点
   動きでベクトルを表示するライフタイム
   void AddVector（ポイント開始、ポイント終了、intライフタイム）
   マップの幅を取得する
   戻り値：マップ幅
   int GetWidth（）
   
   マップの高さを取得
   戻り値：マップの高さ
   int GetHeight（）