mirror of
https://github.com/giongto35/cloud-game.git
synced 2026-07-20 16:54:25 +00:00
Update Readme format (#162)
This commit is contained in:
parent
d8d3658783
commit
27cee3976a
6 changed files with 14 additions and 11 deletions
25
README.md
vendored
25
README.md
vendored
|
|
@ -10,11 +10,11 @@
|
|||
## Introduction
|
||||
CloudRetro provides an open-source cloud gaming platform for retro games. It started as an experiment for testing cloud gaming performance with [WebRTC](https://github.com/pion/webrtc/) and [libretro](https://www.libretro.com/), and now it aims to deliver the most modern and convenient gaming experience through the technology.
|
||||
|
||||
Theoretically, in cloud gaming, games are run on remote servers and media are streamed to the player optimally to ensure the most comfortable user interaction. It opens the ability to play any retro games on web-browser directly, which are fully compatible with multi-platform like Desktop, Android, ~~IOS~~. It enhances crowdplay ([TwitchPlaysPokemon](https://en.wikipedia.org/wiki/Twitch_Plays_Pok%C3%A9mon)) with realtime interaction. E.g: [Play Pokemon Emerald together](http://cloudretro.io/?id=652e45d78d2b91cd%7CPokemon%20-%20Emerald%20Version%20%28U%29).
|
||||
Theoretically, in cloud gaming, games are run on remote servers and media are streamed to the player optimally to ensure the most comfortable user interaction. It opens the ability to play any retro games on web-browser directly, which are fully compatible with multi-platform like Desktop, Android, ~~IOS~~.
|
||||
|
||||
## Try the service at
|
||||
Single play: **[http://cloudretro.io](http://cloudretro.io)**
|
||||
Crowd play: **[Pokemon Emerald](http://cloudretro.io/?id=652e45d78d2b91cd%7CPokemon%20-%20Emerald%20Version%20%28U%29)**
|
||||
Direct play an existing game: **[Pokemon Emerald](http://cloudretro.io/?id=652e45d78d2b91cd%7CPokemon%20-%20Emerald%20Version%20%28U%29)**
|
||||
*Chrome and Chrome on Android is recommended. It's not working on iPhone and some other explorers. Click help button in the game UI to see keyboard mapping.*
|
||||
|
||||
\*In ideal network condition and less resource contention on servers, the game will run smoothly as in the video demo. Because I only hosted the platform on limited servers in US East, US West, Eu, Singapore, you may experience some latency issues + connection problem. You can try hosting the service following the instruction the next section to have a better sense of performance.
|
||||
|
|
@ -77,8 +77,13 @@ Because the coordinator and workers need to run simultaneously. Workers connect
|
|||
* `go run cmd/coordinator/main.go` - spawn coordinator
|
||||
* `go run cmd/worker/main.go --coordinatorhost localhost:8000` - spawn workers connecting to coordinator
|
||||
|
||||
## Wiki
|
||||
- [Wiki](https://github.com/giongto35/cloud-game/wiki)
|
||||
## Technical Document
|
||||
- [webrtchacks Blog: Open Source Cloud Gaming with WebRTC](https://webrtchacks.com/open-source-cloud-gaming-with-webrtc/)
|
||||
- [Wiki (outdated)](https://github.com/giongto35/cloud-game/wiki)
|
||||
|
||||
| High level | Worker internal |
|
||||
| :--------------------------------------------: | :--------------------------------------------: |
|
||||
|  |  |
|
||||
|
||||
## FAQ
|
||||
- [FAQ](https://github.com/giongto35/cloud-game/wiki/FAQ)
|
||||
|
|
@ -87,19 +92,17 @@ Because the coordinator and workers need to run simultaneously. Workers connect
|
|||
By clicking these deep link, you can join the game directly and play it together with other people.
|
||||
- [Play Pokemon Emerald](http://cloudretro.io/?id=652e45d78d2b91cd%7CPokemon%20-%20Emerald%20Version%20%28U%29)
|
||||
- [Fire Emblem](http://cloudretro.io/?id=314ea4d7f9c94d25___Fire%20Emblem%20%28U%29%20%5B%21%5D)
|
||||
- [Advance War](http://cloudretro.io/?id=10fe582a7635b039___Advance%20Wars%20%28USA%29)
|
||||
- [Harvest Moon](http://cloudretro.io/?id=3f7462269e976303___Harvest%20Moon%20-%20Back%20to%20Nature%20%28USA%29)
|
||||
- [Play Pokemon Fire Red](http://cloudretro.io/?id=68bf168be6728020___Pokemon%20-%20Fire%20Red%20Version%20%28U%29%20%28V1.1%29)
|
||||
- [Mario](http://cloudretro.io/?id=1953c570fee1f9e4___Super%20Mario%20Bros)
|
||||
|
||||
And you can host the new game by yourself by accessing [cloudretro.io](http://cloudretro.io) and click "share" button to generate a deeplink to your current game.
|
||||
_Disclaimer: You may experience lagging when joining a room because the room is in a different zone. In that case, you should create a new room for crowd play._
|
||||
|
||||

|
||||
<p align="center">
|
||||
<img width="420" height="300" src="docs/img/multiplatform.png"> <br>
|
||||
Synchronize a game session on multiple devices
|
||||
</p>
|
||||
|
||||
## Contribution
|
||||
- The project cannot be possible without the contribution with those amazing people:
|
||||
- [sergystepanov](https://github.com/sergystepanov/) for Front end refactor; Audio re-implementation; bilinear, nearest neighbor interpolation scaling; Window setup document.
|
||||
- [sergystepanov](https://github.com/sergystepanov/) for Front end refactor; Audio re-implementation; bilinear, nearest neighbor interpolation scaling; Window setup document; build workflow on multi-os.
|
||||
- [sadlil](https://github.com/sadlil) for massive code structure reogranization; log and monitor server introduction.
|
||||
|
||||
## Credits
|
||||
|
|
|
|||
BIN
docs/img/landing-page-dark.png
vendored
Normal file
BIN
docs/img/landing-page-dark.png
vendored
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
BIN
docs/img/multiplatform.png
vendored
Normal file
BIN
docs/img/multiplatform.png
vendored
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.1 MiB |
BIN
docs/img/overview.png
vendored
Normal file
BIN
docs/img/overview.png
vendored
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 49 KiB |
BIN
docs/img/worker-internal.png
vendored
Normal file
BIN
docs/img/worker-internal.png
vendored
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
BIN
docs/img/worker.png
vendored
BIN
docs/img/worker.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 84 KiB |
Loading…
Add table
Add a link
Reference in a new issue