examples

README

Examples

We've built an extensive collection of examples covering common use-cases. You can modify and extend these examples to get started quickly.

For more full featured examples that use 3rd party libraries see our example-webrtc-applications repo.

Overview

Media API

• Reflect: The reflect example demonstrates how to have Pion send back to the user exactly what it receives using the same PeerConnection.
• Play from Disk: The play-from-disk example demonstrates how to send video to your browser from a file saved to disk.
• Play from Disk Renegotation: The play-from-disk-renegotation example is an extension of the play-from-disk example, but demonstrates how you can add/remove video tracks from an already negotiated PeerConnection.
• Insertable Streams: The insertable-streams example demonstrates how Pion can be used to send E2E encrypted video and decrypt via insertable streams in the browser.
• Save to Disk: The save-to-disk example shows how to record your webcam and save the footage to disk on the server side.
• Broadcast: The broadcast example demonstrates how to broadcast a video to multiple peers. A broadcaster uploads the video once and the server forwards it to all other peers.
• RTP Forwarder: The rtp-forwarder example demonstrates how to forward your audio/video streams using RTP.
• RTP to WebRTC: The rtp-to-webrtc example demonstrates how to take RTP packets sent to a Pion process into your browser.
• Simulcast: The simulcast example demonstrates how to accept and demux 1 Track that contains 3 Simulcast streams. It then returns the media as 3 independent Tracks back to the sender.

Data Channel API

• Data Channels: The data-channels example shows how you can send/recv DataChannel messages from a web browser.
• Data Channels Create: Example data-channels-create shows how you can send/recv DataChannel messages from a web browser. The difference with the data-channels example is that the data channel is initialized from the server side in this example.
• Data Channels Close: Example data-channels-close is a variant of data-channels that allow playing with the life cycle of data channels.
• Data Channels Detach: The data-channels-detach example shows how you can send/recv DataChannel messages using the underlying DataChannel implementation directly. This provides a more idiomatic way of interacting with Data Channels.
• Data Channels Detach Create: Example data-channels-detach-create shows how you can send/recv DataChannel messages using the underlying DataChannel implementation directly. This provides a more idiomatic way of interacting with Data Channels. The difference with the data-channels-detach example is that the data channel is initialized in this example.
• ORTC: Example ortc shows how you an use the ORTC API for DataChannel communication.
• Pion to Pion: Example pion-to-pion is an example of two pion instances communicating directly! It therefore has no corresponding web page.

Miscellaneous

• Custom Logger The custom-logger demonstrates how the user can override the logging and process messages instead of printing to stdout. It has no corresponding web page.

Usage

We've made it easy to run the browser based examples on your local machine.

1. Build and run the example server:

   GO111MODULE=on go get github.com/pion/webrtc/v3
   git clone https://github.com/pion/webrtc.git $GOPATH/src/github.com/pion/webrtc
   cd $GOPATH/src/github.com/pion/webrtc/examples
   go run examples.go
   

2. Browse to localhost to browse through the examples. Note that you can change the port of the server using the --address flag:

   go run examples.go --address localhost:8080
   go run examples.go --address :8080            # listen on all available interfaces
   

WebAssembly

Pion WebRTC can be used when compiled to WebAssembly, also known as WASM. In this case the library will act as a wrapper around the JavaScript WebRTC API. This allows you to use WebRTC from Go in both server and browser side code with little to no changes

Some of our examples have support for WebAssembly. The same examples server documented above can be used to run the WebAssembly examples. However, you have to compile them first. This is done as follows:

1. If the example supports WebAssembly it will contain a main.go file under the jsfiddle folder.
2. Build this main.go file as follows:

   GOOS=js GOARCH=wasm go build -o demo.wasm
   

3. Start the example server. Refer to the usage section for how you can build the example server.
4. Browse to localhost. The page should now give you the option to run the example using the WebAssembly binary.