mirror of
https://github.com/4jcraft/4jcraft.git
synced 2026-04-25 14:23:37 +00:00
49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
# Network Code Implementation Notes
|
|
|
|
## Overview
|
|
|
|
The networking classes are organized as follows:
|
|
|
|
```
|
|
Game \
|
|
^ |
|
|
| |
|
|
+-----------------------------+-----------------------------+ |
|
|
| | |
|
|
v v |
|
|
Game Network Manager <--------------------------------> Network Player Interface |- platform independent layers
|
|
^ ^ |
|
|
| | |
|
|
v | |
|
|
Platform Network Manager Interface | |
|
|
^ | /
|
|
| |
|
|
v v \
|
|
Platform Network Manager Implementation(1) <------> Network Player Implementation (3) |
|
|
^ ^ |_ platform specific layers
|
|
| | |
|
|
v v |
|
|
Platform specific network code(2) Platform specific player code (4) /
|
|
```
|
|
|
|
### Notes
|
|
|
|
- In general the game should **only communicate with the `GameNetworkManager` and `NetworkPlayerInterface` APIs**, which provide a platform independent interface for networking functionality. The `GameNetworkManager` may in general have code which is aware of the game itself, but it *shouldn't have any platform-specific networking code*. It communicates with a platform specific implementation of a `PlatformNetworkManagerInterface` to achieve this.
|
|
|
|
- The platform specific layers shouldn't contain any general game code, as this is much better placed in the platform independent layers to avoid duplicating effort.
|
|
|
|
- Platform specific files for each platform for the numbered classes in the previous diagram are currently:
|
|
|
|
|
|
## Platform-Specific Files
|
|
|
|
The platform-specific implementations for each numbered class in the diagram:
|
|
|
|
| Class | Xbox 360 | Sony | Other |
|
|
|-------|---------------------------------|----------------------------|-----------------------|
|
|
| (1) | PlatformNetworkManagerXbox | PlatformNetworkManagerSony | PlatformNetworkManagerStub |
|
|
| (2) | Provided by QNET | SQRNetworkManager | Qnet stub* |
|
|
| (3) | NetworkPlayerXbox | NetworkPlayerSony | NetworkPlayerXbox |
|
|
| (4) | Provided by QNET | SQRNetworkPlayer | Qnet stub* |
|
|
\*Temporarily provided by `extra64.h`
|