mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-05-20 13:19:07 +08:00
88d623bedb
* Add vitepress tree * Update existing workflows so they dont trigger on changes in the docs path * Add nojekyll, package.json, LICENCE etc * Add crowdin docs upload/download scripts * Add docs flaw checker workflows * Used docs prefix for docs workflows * Crowdin obvious fixes * ci: docs move to self hosted runner runs on a beefy server for faster builds Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: don't run build action for docs or ci changes Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: update runners Signed-off-by: Ramon Roche <mrpollo@gmail.com> * Add docs/en * Add docs assets and scripts * Fix up editlinks to point to PX4 sources * Download just the translations that are supported * Add translation sources for zh, uk, ko * Update latest tranlsation and uorb graphs * update vitepress to latest --------- Signed-off-by: Ramon Roche <mrpollo@gmail.com> Co-authored-by: Ramon Roche <mrpollo@gmail.com>
83 lines
3.6 KiB
Markdown
83 lines
3.6 KiB
Markdown
# Video Streaming (Companion Computer/QGroundControl)
|
|
|
|
PX4-based vehicles support video streaming using a camera connected to a [companion computer](../companion_computer/index.md).
|
|
|
|
::: info
|
|
You can't video stream directly from a camera connected to PX4.
|
|
:::
|
|
|
|
GStreamer is used to send the video to _QGroundControl_ over an IP link.
|
|
To support streaming use cases you will need to install _GStreamer_ development packages on both your companion computer and on the system running _QGroundControl_.
|
|
_QGroundControl_ uses GStreamer 1.18.1 and a stripped down version of _QtGstreamer_ to support UDP RTP and RSTP video streaming.
|
|
|
|
## Companion Computer Setup
|
|
|
|
You will need to install the _GStreamer_ packages that match those used by QGC.
|
|
|
|
For a Ubuntu companion, a minimal set might be:
|
|
|
|
```sh
|
|
sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-libav gstreamer1.0-gl -y
|
|
```
|
|
|
|
For the full set you can mirror the QGC dependencies installed by [/tools/setup/install-dependencies-debian.sh](https://github.com/mavlink/qgroundcontrol/blob/master/tools/setup/install-dependencies-debian.sh).
|
|
At time of writing this is:
|
|
|
|
```sh
|
|
DEBIAN_FRONTEND=noninteractive apt-get -y --quiet install \
|
|
libgstreamer1.0-dev \
|
|
libgstreamer-plugins-bad1.0-dev \
|
|
libgstreamer-plugins-base1.0-dev \
|
|
libgstreamer-plugins-good1.0-dev \
|
|
libgstreamer-gl1.0-0 \
|
|
gstreamer1.0-plugins-bad \
|
|
gstreamer1.0-plugins-base \
|
|
gstreamer1.0-plugins-good \
|
|
gstreamer1.0-plugins-ugly \
|
|
gstreamer1.0-plugins-rtp \
|
|
gstreamer1.0-gl \
|
|
gstreamer1.0-libav \
|
|
gstreamer1.0-rtsp \
|
|
gstreamer1.0-vaapi \
|
|
gstreamer1.0-x
|
|
```
|
|
|
|
::: tip
|
|
For other companion platforms you can mirror the instructions in the [corresponding installation scripts](https://github.com/mavlink/qgroundcontrol/tree/master/tools/setup).
|
|
:::
|
|
|
|
General instructions for starting the stream on a companion computer are provided in the [QGroundControl VideoReceiver GStreamer README](https://github.com/mavlink/qgroundcontrol/blob/master/src/VideoManager/VideoReceiver/GStreamer/README.md).
|
|
|
|
The setup of cameras and data links depends on many factors.
|
|
Examples in this library are listed below (note, these are options, not "recommended"):
|
|
|
|
- [Video Streaming using WFB-ng Wifi](../companion_computer/video_streaming_wfb_ng_wifi.md) (Tutorial): Using RPi and WiFi module in unconnected (broadcast) mode to stream video and as a bidirectional telemetry link.
|
|
|
|
## QGC Setup
|
|
|
|
To setup and use video steaming with QGC:
|
|
|
|
1. Install GStreamer if using Ubuntu QGC 4 release builds (or earlier)
|
|
|
|
::: tip
|
|
All other QGroundControl builds include GStreamer binaries, including daily builds, release builds after version 4, and builds for other platforms include GStreamer binaries.
|
|
:::
|
|
|
|
Install the runtime dependencies using the command:
|
|
|
|
```sh
|
|
sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-libav gstreamer1.0-gl -y
|
|
```
|
|
|
|
1. Start QGC
|
|
1. Enable video in _Fly View_: [QGroundControl > General Settings (Settings View) > Video](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/settings_view/general.html#video)
|
|
1. If everything works, you should see the video stream displayed in the QGC Video Switcher (QGC Fly View bottom left corner).
|
|
You can click on the video switcher to toggle the video full-screen, as shown in the screenshot below.
|
|
|
|
|
|
|
|
## Gazebo Classic Simulation
|
|
|
|
[Gazebo Classic](../sim_gazebo_classic/index.md) supports video streaming from within the simulated environment.
|
|
For more information see [Gazebo Classic Simulation > Video Streaming](../sim_gazebo_classic/index.md#video-streaming).
|