Interceptor is a framework for building RTP/RTCP communication software. This framework defines a interface that each interceptor must satisfy. These interceptors are then run sequentially. We also then provide common interceptors that will be useful for building RTC software.
This package was built for pion/webrtc, but we designed it to be consumable by anyone. With the following tenets in mind.
- Useful defaults. Each interceptor will be configured to give you a good default experience.
- Unblock unique use cases. New use cases are what is driving WebRTC, we want to empower them.
- Encourage modification. Add your own interceptors without forking. Mixing with the ones we provide.
- Empower learning. This code base should be useful to read and learn even if you aren't using Pion.
- NACK Generator/Responder
- Sender and Receiver Reports
- Transport Wide Congestion Control Feedback
- Packet Dump
- Google Congestion Control
- Stats A webrtc-stats compliant statistics generation
- Interval PLI Generate PLI on a interval. Useful when no decoder is available.
- Bandwidth Estimation
- JitterBuffer, re-order packets and wait for arrival
- FlexFec
- RTCP Feedback for Congestion Control the standardized alternative to TWCC.
The public interface is defined in interceptor.go. The methods you need to satisy are broken up into 4 groups.
BindRTCPWriterandBindRTCPReaderallow you to inspect/modify RTCP traffic.BindLocalStreamandBindRemoteStreamnotify you of a new SSRC stream and allow you to inspect/modify.UnbindLocalStreamandUnbindRemoteStreamnotify you when a SSRC stream has been removedClosecalled when the interceptor is closed.
Interceptors also pass Attributes between each other. These are a collection of key/value pairs and are useful for storing metadata or caching.
noop.go is an interceptor that satisfies this interface, but does nothing. You can embed this interceptor as a starting point so you only need to define exactly what you need.
chain.go is used to combine multiple interceptors into one. They are called sequentially as the packet moves through them.
The examples directory provides some basic examples. If you need more please file an issue! You should also look in pion/webrtc for real world examples.
The library is used as a part of our WebRTC implementation. Please refer to that roadmap to track our major milestones.
Pion has an active community on the Slack.
Follow the Pion Twitter for project updates and important WebRTC news.
We are always looking to support your projects. Please reach out if you have something to build! If you need commercial support or don't want to use public methods you can contact us at [email protected]
Check out the contributing wiki to join the group of amazing people making this project possible
MIT License - see LICENSE for full text