Skip to content

Commit 380cc1f

Browse files
committed
documentation #33: add installation and debugging info
1 parent c3fb39e commit 380cc1f

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

README.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,18 @@ This GStreamer-based plugin enables Unity to communicate with a Reachy 2 through
44

55
## Requirements
66

7-
Currently, only the Windows platform is supported. The project requires [CMake](https://cmake.org/) to be generated and then Visual Studio to be built (tested with VS 2022).
7+
Currently, only the Windows platform is supported.
8+
The GStreamer library 1.24 is required. Download the [runtime](https://gstreamer.freedesktop.org/data/pkg/windows/1.24.8/msvc/gstreamer-1.0-msvc-x86_64-1.24.8.msi) installer.
89

9-
The GStreamer library 1.24 is required. Download the [runtime](https://gstreamer.freedesktop.org/data/pkg/windows/1.24.8/msvc/gstreamer-1.0-msvc-x86_64-1.24.8.msi) and [development](https://gstreamer.freedesktop.org/data/pkg/windows/1.24.8/msvc/gstreamer-1.0-devel-msvc-x86_64-1.24.8.msi) installers.
10+
For developing, the project requires [CMake](https://cmake.org/) to be generated and then Visual Studio to be built (tested with VS 2022). The [gstreamer development installer](https://gstreamer.freedesktop.org/data/pkg/windows/1.24.8/msvc/gstreamer-1.0-devel-msvc-x86_64-1.24.8.msi) is also required.
11+
12+
13+
## Installation
14+
15+
From the *Window/Package Manager*, hit the + button and *add package from git URL*:
16+
```
17+
https://github.com/pollen-robotics/GstreamerWebRTCUnityPlugin.git?path=/UnityProject/Packages/com.pollenrobotics.gstreamerwebrtc#main
18+
```
1019

1120
## Build
1221

@@ -21,6 +30,7 @@ git clone git@github.com:pollen-robotics/GstreamerWebRTCUnityPlugin.git
2130
```console
2231
cd GstreamerWebRTCUnityPlugin\Plugin
2332
mkdir build
33+
cd build
2434
cmake -G "Visual Studio 17 2022" ..
2535
````
2636

@@ -34,12 +44,6 @@ cmake --build . --config Release
3444
3545
Alternatively, you can open the `*.sln` file in the build folder and build the project with Visual Studio (or press Ctrl+Shift+B).
3646
37-
## Installation
38-
39-
The built DLL and script files are located in the `GstreamerWebRTCUnityPlugin\UnityProject\Packages\com.pollenrobotics.gstreamerwebrtc` folder.
40-
41-
Simply copy and paste this folder into the Packages folder of your Unity app.
42-
4347
## Testing
4448
4549
The `GstreamerWebRTCUnityPlugin\UnityProject` is an example project that uses this plugin. It receives and displays audiovisual streams while sending sound from the microphone. The connection to the data is limited to the opening of the service channel.
@@ -68,3 +72,8 @@ Figure can be generated with [graphviz](https://graphviz.org/)
6872
dot -Tpng -O pipeline.dot
6973
```
7074

75+
### Debug from Visual Studio
76+
77+
In the solution explorer, select **UnityGstreamerPlugin** as the startup project. In the *Confguration Properties/Debugging* of this project set the *Command* as *D:\UnityHub\2022.3.41f1\Editor\Unity.exe* and *Commands Arguments* as *-projectPath C:\Users\Fabien\Dev\UnityGstreamerPlugin\UnityProject* (with the right paths).
78+
79+
Hit F5 to start the debugging. The Unity project should start.

0 commit comments

Comments
 (0)