Welcome to the official Wowza Media Systems Web Real-time Communication (WebRTC) client examples. These examples are intended to help developers bring live streaming into their applications using WebRTC.

• About WebRTC
• Getting Started
  • Set up WebRTC
  • Directory Structure
  • Run the example code
• Resources
• Contact
• License

WebRTC is an open source project to enable real-time communication of audio, video, and data in web browsers and native apps. WebRTC is designed for peer-to-peer connections but includes fallbacks in case direct connections fail. Encryption is mandatory for WebRTC streams, so you must host the examples on a web server using SSL encryption.

You'll need to setup WebRTC for either Wowza Streaming Engine or Wowza Streaming Cloud to run the examples in this repo. The following links include steps for both.

Set up WebRTC streaming with Wowza Streaming Engine

Connect a WebRTC stream to Wowza Streaming Cloud

Note: Keep in mind that encryption is mandatory for WebRTC streams.

In the src folder, you'll find the following:

• css and images - Assets used by the example HTML pages.
• lib - JavaScript libraries for managing the WebRTC setup.
  • AvMenu.js - Controls the selected input for publishing and screen sharing.
  • Settings.js - Creates a set of configuration settings and copy functionality.
  • SoundMeter.js - Provides a audio meter.
  • WowzaMungeSDP.js - Generates an SPD for peer signaling.
  • WowzaPeerConnectionPlay.js - Manages the signaling process for playback.
  • WowzaPeerConnectionPublish.js - Manages the signaling process for publishing.
  • WowzaWebRTCPlay.js - Controls the playback state.
  • WowzaWebRTCPublish.js - Controls the publishing state.
• dev-view-publish.html - Example HTML page that can create a WebRTC stream with video, audio, and screen share input and publish it to Wowza Streaming Engine.
• dev-view-play.html - Example HTML page that can play back a WebRTC stream from Wowza Streaming Engine.
• play.js and publish.js - JavaScript files that use libraries imported from the lib folder to control the WebRTC setup for publishing and playing streams.

To run on your local host, in the project directory execute:

 $ npx serve

Go to localhost:5000/src/ to view the examples.

If you are not running the examples from localhost, an HTTPS connection is required for WebRTC to access local devices.

• WebRTC workflows in Wowza Streaming Engine
• Wowza Streaming Engine WebRTC Publish Example (CodePen)
• Wowza Streaming Engine WebRTC Player Example (CodePen)

Wowza Media Systems™, LLC

Wowza Media Systems provides developers with a platform to create streaming applications and solutions. See the Wowza Developer Portal to learn more about our APIs and SDKs.

This code is distributed under the BSD 3-Clause License.