Skip to content

Commit 7677e64

Browse files
authored
Create README.md
1 parent fec0ef7 commit 7677e64

File tree

1 file changed

+42
-0
lines changed

1 file changed

+42
-0
lines changed

README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# UniRCP
2+
Unity Implementation of the Rabbit Control Protocol (https://github.com/rabbitControl/RCP)
3+
4+
## Dependencies:
5+
- UniRx (https://github.com/neuecc/UniRx)
6+
- BindingsRx (https://github.com/grofit/bindingsrx)
7+
- RCPSharp (https://github.com/lukasIO/rcp-csharp -> forked and adjusted datatypes for unity)
8+
9+
## What is this
10+
A reactive server implementation for a rapid setup of remote controlling (almost) everything within unity during runtime.
11+
Using RabbitControl, a client application (i.e. (here)[https://github.com/rabbitControl/rcp-ts-client] which is running online (here)[https://rabbitcontrol.github.io/client/] automatically generates a UI for remote controlling the parameters that you choose to expose via this RCP server.
12+
13+
## How does it work
14+
Place the RabbitControl Prefab from this Repo in your Scene.<br>
15+
By default it will use Websockets as the transport layer.
16+
17+
To expose some fields/parameters/transforms to the RCP Server, have a look at the ControlTest.cs file, for a single float it would look like this:
18+
```c#
19+
using RabbitControl;
20+
21+
public class ControlTest : MonoBehaviour {
22+
23+
public float myFloat;
24+
25+
void Start () {
26+
SetupRabbitControls();
27+
}
28+
29+
private void SetupRabbitControls()
30+
{
31+
myFloat
32+
.ToValueParameter(nameof(myFloat)) //create a RCP Parameter out of your variable and expose it to/on the server
33+
.BindParameterTo(() => myFloat, x => myFloat = x); //two way binding using of the value using BindingsRx internally
34+
}
35+
```
36+
37+
## Features
38+
- Two-Way Binding (you can choose not to though)
39+
- Supports a lot of basic datatypes (int, float, string, enum, ...)
40+
- grouping of multiple parameters (also nested groups)
41+
- this is a WIP, not all datatypes are supported yet, very much untested.
42+

0 commit comments

Comments
 (0)