status-go/vendor/github.com/pion/interceptor/README.md

Pion Interceptor

RTCP and RTCP processors for building real time communications

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.

Current Interceptors

• 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.

Planned Interceptors

• Bandwidth Estimation
  • NADA
• JitterBuffer, re-order packets and wait for arrival
• FlexFec
• RTCP Feedback for Congestion Control the standardized alternative to TWCC.

Interceptor Public API

The public interface is defined in interceptor.go. The methods you need to satisy are broken up into 4 groups.

• BindRTCPWriter and BindRTCPReader allow you to inspect/modify RTCP traffic.
• BindLocalStream and BindRemoteStream notify you of a new SSRC stream and allow you to inspect/modify.
• UnbindLocalStream and UnbindRemoteStream notify you when a SSRC stream has been removed
• Close called 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.

Examples

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.

Roadmap

The library is used as a part of our WebRTC implementation. Please refer to that roadmap to track our major milestones.

Community

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 team@pion.ly

Contributing

Check out the contributing wiki to join the group of amazing people making this project possible

License

MIT License - see LICENSE for full text