LogoLogo
日本語
日本語
  • Diarkis ヘルプセンター
  • Diarkis の概要
  • 始めよう
    • Diarkis サーバーテンプレート
    • Diarkis クライアント SDK
    • チュートリアル
      • 1. Diarkis サーバーをローカル環境で起動する
      • 2. テストクライアントで疎通確認する
      • 3. カスタムコマンドを実装する
      • Diarkis クライアントからサーバに接続する
    • サンプル
  • Diarkis のモジュール
    • Room モジュール
      • Room モジュールをサーバーでセットアップする
      • Room サンプル
        • room_broadcast
      • Room モジュールをクライアントから利用する
      • Room のその他の機能
    • MatchMaker モジュール
      • MatchMaker モジュールをサーバーでセットアップする
    • Field モジュール
      • Field モジュールをサーバーでセットアップする
    • P2P モジュール
      • P2P モジュールをサーバーでセットアップする
      • P2P サンプル
    • DM (Direct Message) モジュール
      • DM モジュールをサーバーでセットアップする
    • Notifier モジュール
      • Notifier モジュールをサーバーでセットアップする
    • Session モジュール
      • Session モジュールをサーバーでセットアップする
    • Group モジュール
      • Group モジュールをサーバーでセットアップする
  • Diarkis サーバー
    • Diarkis サーバをクラウド環境で起動する
      • AWS
    • Diarkis サーバーを Windows 環境で起動する
    • MARS サーバー
    • UDP サーバー
    • TCP サーバー
    • HTTP サーバー
    • Metrics API
    • サーバー間通信 - Mesh
  • Diarkis クライアント
    • ランタイム・ライブラリ
      • Diarkis RUDP
    • Diarkis Module
      • Diarkis Module の初期化と終了
      • Diarkis Module のカスタイマイズ
      • Diarkis Module のロギング・システム
      • マイグレーション
      • Diarkis のスレッド
    • サンプル
      • C++
        • room_broadcast
        • directmessage_simple
        • group_sample
        • matching_and_turn
        • matchmaker_ticker
        • p2p_rudp_sample
        • session_simple
      • Unreal Engine Plugin
        • FieldWalker
      • Unity Plugin
        • FieldWalker
          • HowToReplicatePosition.md
  • Diarkis ツール
    • Diarkis CLI
      • cgo を利用するプロジェクトをビルドする方法
      • Diarkis CLI v3 への切り替え手順
  • リファレンス
    • API リファレンス
    • リリースノート
      • v1.0
      • v1.0.1
      • v1.0.2
      • v1.0.3
      • v1.0.4
      • v1.0.5
      • v1.0.6
  • サポート
    • ライセンスと購入
GitBook提供
このページ内
  • はじめに
  • 環境準備
  • サーバー・テンプレートからプロジェクトを生成する
  • セットアップ
  • サーバー・バイナリの生成
  • サーバーの起動
  • 接続情報の取得

役に立ちましたか?

  1. 始めよう
  2. チュートリアル

1. Diarkis サーバーをローカル環境で起動する

前へチュートリアル次へ2. テストクライアントで疎通確認する

最終更新 1 か月前

役に立ちましたか?

はじめに

本ページでは Diarkis サーバーテンプレート を利用して Diarkis サーバーをローカル環境で起動する手順を解説します。Diarkis での開発を始める前にこちらの手順を一通り試すことをおすすめいたします。

環境準備

サーバー・テンプレートを導入するには Go 1.22 以降が必要です。

インストール方法はプラットフォーム毎に異なりますので、公式ドキュメントに従ってインストールします。

Diarkis のサーバー開発は、macOS, Linux, Windows で行うことができます。

Windows 環境でサーバーを起動する場合は Diarkis サーバーを Windows 環境で起動する をご覧ください。

サーバー・テンプレートからプロジェクトを生成する

  1. まずは任意の PATH で git clone https://github.com/Diarkis/diarkis-server-template.git として、repository をクローンします。

  2. 以下のコマンドを実行して、プロジェクトを生成します。出力先は output に指定した絶対パスとなります

make init project_id={project ID} builder_token={builder token} output={absolute path to install}

# 例
make init project_id=00000000000 builder_token=xxxx-yyyy-zzzz output=/tmp/diarkis-dir

ここで記載されている、project ID builder token は Diarkis のエンタープライズ・ライセンスをお持ちの developer 様に発行される情報となります。 diarkis の本体自体は、クローズド・ソースで作成されている、かつ go で実装されているために、diarkis-cli をつかって、ビルドする必要があります。

セットアップ

生成したプロジェクトにて以下コマンドを実行します。

cd path/to/project
make init

これにより、開発に必要な各種リソース (コード補完を利用するためのリファレンス など)がダウンロードされます。

サーバー・バイナリの生成

ローカル向けにバイナリを生成する際は、以下の make タスクを実行します。

make build-local

上記を実行すると、 remote_bin 配下に、diarkis のバイナリが生成されます。

% ls remote_bin
health-check http         mars         ms           tcp          testcli      udp

サーバーの起動

MARS, HTTP, UDP の各サーバーを起動します。

make server target=mars
make server target=http
make server target=udp
# 本チュートリアルでは利用しませんが、TCP サーバーは以下コマンドで起動できます。
# make server target=tcp

# make コマンドを利用せずに以下のコマンドでも同様に起動可能です
./remote_bin/mars ./configs/mars/main.json
./remote_bin/http
./remote_bin/udp

接続情報の取得

mars, http, udp が起動していれば、curl で以下のように接続情報を取得することができます。これでサーバーの起動は完了です。

% curl -X POST http://127.0.0.1:7000/endpoint/type/UDP/user/test
{"encryptionMacKey":"xxxxxxxxxx","serverType":"UDP","serverHost":"127.0.0.1","serverPort":7100,"sid":"xxxxxxxxxx","encryptionKey":"xxxxxxxxxx","encryptionIV":"xxxxxxxxxx"}%

上記の HTTP エンドポイントは UDP サーバーに対して uid test で認証したことを意味します。ここから返却された情報を各種クライアント・ライブラリから利用して、パケットのやり取りが可能となります。

過去バージョンが必要な場合は、任意のバージョンの tag をチェックアウトするか、からダウンロードすることでご利用いただけます。

https://go.dev/doc/install
リリース一覧