WSNet2をプロジェクトに合わせて調整するための設定をWSNet2.WSNet2Settingsクラスを通して行えます。
- 保持できるEventの数
- 初期値: 16 個
入室時のonSuccessコールバック中やroom.Pause()で一時停止している間に受信したEventを保持するためのプールサイズです。
自動拡張されないので、十分な量を設定してください。
- 各Eventのバッファサイズの初期値
- 初期値: 256 byte
各イベントを保持するバッファサイズの初期値です。
EvPoolSize個のバッファが確保されます。
各バッファは必要に応じて自動的に拡張されます。
- 保持できるMsgの数
- 初期値: 16 個
送信待ちメッセージを保持するためのプールのサイズです。 回線切断による再接続中のメッセージをプールするだけでなく、再接続時の不達メッセージの再送にも使われます。
- 各Msgのバッファサイズの初期値
- 初期値: 256 byte
各メッセージを保持するバッファサイズの初期値です。
MsgPoolSize個のバッファが確保されます。
各バッファは必要に応じて自動的に拡張されます。
- 最大連続再接続試行回数
- 初期値: 5 回
websocket再接続試行回数の上限です。 この回数連続して接続に失敗したら再試行を打ち切り、部屋から切断したことになります。 再接続に成功したら失敗回数のカウントは0に戻ります。
- 接続タイムアウト
- 初期値: 5000 ミリ秒 (=5秒)
websocket接続のタイムアウト時間です。 接続要求に対してこの時間応答が無かった場合、その接続は失敗として扱われます。
- 再接続インターバル
- 初期値: 1000 ミリ秒 (=1秒)
接続要求してから、次の再接続を要求するまでの最低間隔です。 この時間以上接続していたり、タイムアウト時間がこの時間より長い場合は、即時に再接続が試行されます。
- 最大Ping間隔
- 初期値: 10000 ミリ秒 (=10秒)
Ping間隔は部屋に設定されたClientDeadlineに応じて自動計算されますが、
この時間より長くなることはありません。
WSNet2では、Pingメッセージに対応するPongイベントによって観戦者数や各Playerの最終Msg受信時刻を同期するため、 あまり長い間隔にしてしまうとこれらの情報のリアルタイム性が損なわれてしまいます。
- 最小Ping間隔
- 初期値: 1000 ミリ秒 (=1秒)
Ping間隔はRoomのClientDeadlineに応じて自動計算されますが、通信頻度が過剰にならないようにするため、この時間より短くなることはありません。
逆に言えば、ClientDeadlineがこの値より短い場合、タイムアウトしないためのPingが機能しなくなります。