Changes between Version 9 and Version 10 of gstreamer

Timestamp:

03/03/2020 12:11:49 AM (4 years ago)

Author:

Tim Harvey

Comment:

added rtmp section

gstreamer

@@ -1250 +1250 @@
 
 
+
+[=#rtmp]
+== RTMP Streaming
+Real-Time Messaging Protocol (RTMP) is a protocol for streaming audio, video and data over the internet. It was originally developed by Macromedia and proprietary but has since been released for public use. It is a TCP-based protocol which maintains persistent connections.
+
+Using RTMP requires you have:
+ * an RTMP server (ie Youtube or Nginx)
+ * a stream transmitter (ie Gateworks board)
+ * a stream receiver (ie Web browser or Gateworks board)
+
+[=#youtube]
+=== !YouTube Live Streaming
+It is possible to stream video to !​YouTube Live Streaming from the Gateworks board using GStreamer's rtmpsink element.
+
+To create a !YouTube live feed via RTMP:
+ - goto !YouTube Live Control Room (https://www.youtube.com/livestreaming/)
+ - goto http://youtube.com and login to your account
+ - click the Camera icon on the top left to add a stream and select 'Go Live'
+ - select Stream at the top
+ - create a title and specify your !YouTube attributes (ie Public, etc etc) then hit 'Create Stream'
+ - take note of your 'Stream key' needed for the encoder pipeline
+ - start your gstreamer pipeline to capture/encode/stream via {{{rtpmsink}}} to the youtube 'Streamer URL' (see [#rtmpsink below])
+ - once YouTube says your stream is ready (indicating its receiving data) hit the 'GO LIVE' button at the top left
+ - Now you can hit the 'Share' icon at the top left to get a URL to share to view the stream
+
+ 
+[=#rtmpsink]
+=== GStreamer rtmpsink transmitter
+Once you have an RTMP server you can use GStreamer to stream live content to it with the {{{rtmpsink}}} element.
+
+Examples:
+ * color-bar pattern from videotestsrc and audio from audiotestsrc
+{{{#!bash
+gst-launch-1.0 \
+  videotestsrc ! "video/x-raw,width=640,height=360,framerate=15/1" ! \
+  v4l2h264enc extra-controls="controls,h264_profile=4,video_bitrate=620000" ! \
+  h264parse ! \
+  mux. \
+audiotestsrc is-live=true ! "audio/x-raw,format=S16LE,endianness=1234, signed=true,width=16,depth=16,rate=44100,channels=2" ! \
+  voaacenc bitrate=128000 ! \
+  aacparse ! "audio/mpeg,mpegversion=4,stream-format=raw" ! \
+  mux. \
+flvmux streamable=true name=mux ! queue ! \
+ rtmpsink location="rtmp://a.rtmp.youtube.com/live2/ee12-bsgt-e22v-8qr1"
+}}}
+ * captured video/audio:
+{{{#!bash
+gst-launch-1.0 \
+  v4l2src device=$DEVICE ! \
+  v4l2h264enc extra-controls="controls,h264_profile=4,video_bitrate=620000" ! \
+  h264parse ! \
+  mux. \
+alsasrc device="sysdefault:CARD=sgtl5000audio" ! \
+  voaacenc bitrate=128000 ! \
+  aacparse ! "audio/mpeg,mpegversion=4,stream-format=raw" ! \
+  mux. \
+flvmux streamable=true name=mux ! queue ! \
+ rtmpsink location="rtmp://a.rtmp.youtube.com/live2/ee12-bsgt-e22v-8qr1"
+}}}
+
+Note that the {{{location}}} property of the {{{rtmpsink}}} is configured on your server. For !YouTube for example they provide the URL and you need to append the 'Stream Key' to that path
+
+
 [=#troubleshooting]
 = Troubleshooting