djsundog/ffplayout
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

simplify preview streaming example

Browse Source
This commit is contained in:
jb-alvarado 2023-07-13 07:46:41 +02:00
parent bf993a1332
commit 6ca710ded6
1 changed files with 16 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/preview_stream.md
View File

@ -25,24 +25,15 @@ The ffplayout engine has no special preview config parameters, but you can add y
-ar 44100 -ar 44100
-b:a 128k -b:a 128k
-flags +global_header -flags +global_header
-f flv rtmp://preview.local/live/stream -f flv rtmp://127.0.0.1/live/stream
... ...
``` ```
In this documentation we suspect, that you are using [ffplayout-frontend](https://github.com/ffplayout/ffplayout-frontend) and that you using [SRS](https://github.com/ossrs/srs) at least for the preview stream. In the past we used HLS for the preview, but now it is possible to also use [HTTP-FLV](https://github.com/ossrs/srs/wiki/v4_EN_DeliveryHttpStream) for less latency. In this documentation we suspect, that you are using [ffplayout-frontend](https://github.com/ffplayout/ffplayout-frontend) and that you using [SRS](https://github.com/ossrs/srs) at least for the preview stream. The most stable solution is previewing over HLS, but it is also possible to use [HTTP-FLV](https://github.com/ossrs/srs/wiki/v4_EN_DeliveryHttpStream) for less latency.
To get this working we have to follow some steps. ffplayout engine needs a direction where it can stream on and SRS need a virtual host for the rtmp input. Because both runs on the same machine, we use for that a redirection in the **/etc/hosts** file: To get this working we have to follow some steps.
**If you want to use HLS as preview, replace `rtmp://preview.local/live/stream` with `rtmp://127.0.0.1/live/stream` and you can skip the redirection in the hosts file.** #### First step is to compile and install SRS:
```
...
127.0.0.1 preview.local
```
Add this line to **/etc/hosts** ans save it.
#### Next step is to compile and install SRS:
```BASH ```BASH
# install some tool for compiling # install some tool for compiling
@ -114,13 +105,6 @@ stats {
disk sda vda xvda xvdb; disk sda vda xvda xvdb;
} }
vhost preview.local {
http_remux {
enabled on;
mount [vhost]/[app]/[stream].flv;
}
}
# for normal HLS streaming # for normal HLS streaming
vhost __defaultVhost__ { vhost __defaultVhost__ {
enabled on; enabled on;
@ -129,6 +113,13 @@ vhost __defaultVhost__ {
mix_correct on; mix_correct on;
} }
# switch enable off, for hls preview
http_remux {
enabled on;
mount [vhost]/[app]/[stream].flv;
}
# switch enable off, for http-flv preview
hls { hls {
enabled on; enabled on;
hls_path /var/www/srs; hls_path /var/www/srs;
@ -150,8 +141,8 @@ Now you can enable and start SRS with: `systemctl enable --now srs` and check if
We assume that you have already installed nginx and you are using it already for the frontend. So open the frontend config **/etc/nginx/sites-enabled/ffplayout.conf** and add a new location to it: We assume that you have already installed nginx and you are using it already for the frontend. So open the frontend config **/etc/nginx/sites-enabled/ffplayout.conf** and add a new location to it:
```NGINX ```NGINX
location /preview/stream.flv { location /live/stream.flv {
proxy_pass http://preview.local:8080/live/stream.flv; proxy_pass http://127.0.0.1:8080/live/stream.flv;
} }
``` ```
@ -195,9 +186,8 @@ server {
alias /var/www/srs/live/; alias /var/www/srs/live/;
} }
location /preview/stream.flv { location /live/stream.flv {
# HTTP-FLV preview proxy_pass http://127.0.0.1:8080/live/stream.flv;
proxy_pass http://preview.local:8080/live/stream.flv;
} }
} }
``` ```
@ -208,4 +198,4 @@ Restart Nginx.
You can (re)start ffplayout and when you setup everything correct it should run without errors. You can (re)start ffplayout and when you setup everything correct it should run without errors.
You can go now in your frontend configuration and change the `player_url` to: `http://[domain or IP]/preview/stream.flv` or `http://[domain or IP]/live/stream.m3u8`, save and reload the page. When you go now to the player tap you should see the preview video. You can go now in your frontend configuration and change the `player_url` to: `http://[domain or IP]/live/stream.flv` or `http://[domain or IP]/live/stream.m3u8`, save and reload the page. When you go now to the player tap you should see the preview video.