8acb1a3a29
Some checks failed
REUSE Compliance Check / lint (push) Failing after 0s
Browser E2E / Test (push) Failing after 3s
Test / test (1.24) (push) Failing after 0s
Test / test-i386 (1.25) (push) Failing after 0s
Test / test-i386 (1.24) (push) Failing after 0s
Test / test-windows (1.25) (push) Failing after 0s
Test / test-windows (1.24) (push) Failing after 0s
Test / test (1.25) (push) Failing after 0s
Examples Tests / Test (push) Failing after 3s
Test / test-macos (1.25) (push) Failing after 0s
Test / test-macos (1.24) (push) Failing after 0s
Go mod tidy / tidy (push) Failing after 0s
Test / test-wasm (push) Failing after 0s
CodeQL / analyze (push) Failing after 1s
Fuzz / fuzz (push) Failing after 0s
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# play-from-disk
|
|
play-from-disk demonstrates how to send video and/or audio to your browser from files saved to disk.
|
|
|
|
For an example of playing H264 from disk see [play-from-disk-h264](https://github.com/pion/example-webrtc-applications/tree/main/play-from-disk-h264)
|
|
|
|
## Instructions
|
|
### Create IVF named `output.ivf` that contains a VP8/VP9/AV1 track and/or `output.ogg` that contains a Opus track
|
|
```
|
|
ffmpeg -i "$INPUT_FILE" -g 30 -b:v 2M output.ivf
|
|
ffmpeg -i "$INPUT_FILE" -vn -c:a libopus -ac 2 -frame_duration 20 -page_duration 20000 -map_metadata -1 output.ogg
|
|
```
|
|
|
|
**Note**: In the `ffmpeg` command which produces the .ivf file, the argument `-b:v 2M` specifies the video bitrate to be 2 megabits per second. We provide this default value to produce decent video quality, but if you experience problems with this configuration (such as dropped frames etc.), you can decrease this. See the [ffmpeg documentation](https://ffmpeg.org/ffmpeg.html#Options) for more information on the format of the value.
|
|
|
|
### Download play-from-disk
|
|
|
|
```
|
|
go install github.com/pion/webrtc/v4/examples/play-from-disk@latest
|
|
```
|
|
|
|
### Open play-from-disk example page
|
|
[jsfiddle.net](https://jsfiddle.net/8kup9mvn/) you should see two text-areas, 'Start Session' button and 'Copy browser SessionDescription to clipboard'
|
|
|
|
### Run play-from-disk with your browsers Session Description as stdin
|
|
The `output.ivf` you created should be in the same directory as `play-from-disk`. In the jsfiddle press 'Copy browser Session Description to clipboard' or copy the base64 string manually.
|
|
|
|
Now use this value you just copied as the input to `play-from-disk`
|
|
|
|
#### Linux/macOS
|
|
Run `echo $BROWSER_SDP | play-from-disk`
|
|
#### Windows
|
|
1. Paste the SessionDescription into a file.
|
|
1. Run `play-from-disk < my_file`
|
|
|
|
### Input play-from-disk's Session Description into your browser
|
|
Copy the text that `play-from-disk` just emitted and copy into the second text area in the jsfiddle
|
|
|
|
### Hit 'Start Session' in jsfiddle, enjoy your video!
|
|
A video should start playing in your browser above the input boxes. `play-from-disk` will exit when the file reaches the end
|
|
|
|
Congrats, you have used Pion WebRTC! Now start building something cool
|