add play-from-disk-264 example (WIP: need to update RTP h264 payloader to align with pion rtp 1.7.1)

Author: Rain Liu

Cargo.toml

@@ -24,7 +24,7 @@ rtcp = "0.4.1"
 srtp = { package = "webrtc-srtp", version = "0.5.0" }
 sctp = { package = "webrtc-sctp", version = "0.3.8" }
 data = { package = "webrtc-data", version = "0.2.8" }
-media = { package = "webrtc-media", version = "0.2.0" }
+media = { package = "webrtc-media", version = "0.2.1" }
 interceptor = "0.2.3"
 tokio = { version = "1.12.0", features = ["full"] }
 log = "0.4.14"
@@ -107,6 +107,11 @@ name = "play-from-disk-vp9"
 path = "examples/play-from-disk-vp9/play-from-disk-vp9.rs"
 bench = false
 
+[[example]]
+name = "play-from-disk-h264"
+path = "examples/play-from-disk-h264/play-from-disk-h264.rs"
+bench = false
+
 [[example]]
 name = "play-from-disk-renegotiation"
 path = "examples/play-from-disk-renegotiation/play-from-disk-renegotiation.rs"

crates/media

@@ -8,6 +8,7 @@ All examples are ported from [Pion](https://github.com/pion/webrtc/tree/master/e
 - [x] [Reflect](reflect): The reflect example demonstrates how to have webrtc-rs send back to the user exactly what it receives using the same PeerConnection.
 - [x] [Play from Disk VP8](play-from-disk-vp8): The play-from-disk-vp8 example demonstrates how to send VP8 video to your browser from a file saved to disk.
 - [x] [Play from Disk VP9](play-from-disk-vp9): The play-from-disk-vp9 example demonstrates how to send VP9 video to your browser from a file saved to disk.
+- [ ] [Play from Disk H264](play-from-disk-h264): The play-from-disk-h264 example demonstrates how to send H264 video to your browser from a file saved to disk.
 - [x] [Play from Disk Renegotiation](play-from-disk-renegotiation): The play-from-disk-renegotiation example is an extension of the play-from-disk example, but demonstrates how you can add/remove video tracks from an already negotiated PeerConnection.
 - [x] [Insertable Streams](insertable-streams): The insertable-streams example demonstrates how webrtc-rs can be used to send E2E encrypted video and decrypt via insertable streams in the browser.
 - [x] [Save to Disk](save-to-disk): The save-to-disk example shows how to record your webcam and save the footage to disk on the server side.

examples/README.md

@@ -0,0 +1,34 @@
+# play-from-disk-h264
+play-from-disk-h264 demonstrates how to send h264 video and/or audio to your browser from files saved to disk.
+
+## Instructions
+### Create IVF named `output.264` that contains a H264 track and/or `output.ogg` that contains a Opus track
+```
+ffmpeg -i $INPUT_FILE -an -c:v libx264 -bsf:v h264_mp4toannexb -b:v 2M -max_delay 0 -bf 0 output.h264
+ffmpeg -i $INPUT_FILE -c:a libopus -page_duration 20000 -vn output.ogg
+```
+
+### Build play-from-disk-h264
+```
+cargo build --example play-from-disk-h264
+```
+
+### Open play-from-disk-h264 example page
+[jsfiddle.net](https://jsfiddle.net/9s10amwL/) you should see two text-areas and a 'Start Session' button
+
+### Run play-from-disk-h264 with your browsers SessionDescription as stdin
+The `output.h264` you created should be in the same directory as `play-from-disk-h264`. In the jsfiddle the top textarea is your browser, copy that and:
+
+#### Linux/macOS
+Run `echo $BROWSER_SDP | ./target/debug/examples/play-from-disk-h264 -v output.h264 -a output.ogg`
+#### Windows
+1. Paste the SessionDescription into a file.
+1. Run `./target/debug/examples/play-from-disk-h264 -v output.h264 -a output.ogg < my_file`
+
+### Input play-from-disk-h264's SessionDescription into your browser
+Copy the text that `play-from-disk-h264` just emitted and copy into second text area
+
+### Hit 'Start Session' in jsfiddle, enjoy your video!
+A video should start playing in your browser above the input boxes. `play-from-disk-h264` will exit when the file reaches the end
+
+Congrats, you have used WebRTC.rs!