⚡️ WebGear_RTC: Implemented a new easy way of defining Custom Streaming Class

[abhiTronix]

Description

With this PR, WebGear_RTC now provides custom_stream attribute with its options parameter that allows you to easily define your own Custom Streaming Class with suitable source that you want to use to transform your frames before sending them onto the browser. This implementation support Auto-Reconnection or Auto-Refresh works out-of-the-box.

Notable Changes:

• 💥 Removed support for assigning Custom Media Server Class(inherited from aiortc's VideoStreamTrack) in WebGear_RTC through its config global parameter.
• ✨ Added new custom_stream attribute with WebGear_RTC options parameter that allows you to easily define your own Custom Streaming Class with suitable source(such as OpenCV).
• ⚡️ This implementation supports repeated Auto-Reconnection or Auto-Refresh out-of-the-box.
• 🧑‍💻 This implementation is more user-friendly and easy to integrate within complex APIs.
• 🎨 This implementation supports all vidgear's VideoCapture APIs readily as input.
• 🏗️ This implementation requires at-least read() and stop() methods implemented within Custom Streaming Class, otherwise WebGear_RTC will throw ValueError.
• 🥚 WebGear_RTC API now automatically constructs av.frame.Frame from numpy.nd.array based on available channels in frames.
• 🏗️ WebGear_RTC API will now throws ValueError if source parameter is None and custom_stream attribute isn't defined.
• CI:
  • 👷 Updated CI tests for new WebGear_RTC custom streaming class.
• Docs:
  • 📝 Added related usage docs for new WebGear_RTC custom streaming class.
  • 📝 Updated Advanced examples using WebGear_RTC's custom streaming class.
  • 👽️ Added changes for upgrading mkdocs-material from 7.x to 8.x in docs.
  • 🚸 Added outdated version warning block.
  • 🐛 Fixed content tabs failing to work.
  • 🚩 Updated WebGear_RTC parameters.
  • 🔥 Removed slugify from mkdocs causing invalid hyperlinks in docs.
  • 🐛 Fixed hyperlink in announcement bar.
  • 💄 Updated code highlighting.

Requirements / Checklist

• I have read the PR Guidelines.
• I have read the Documentation.
• I have updated the documentation accordingly(if required).

Related Issue

#258

Context

Currently for using OpenCV with WebGear_RTC we use Custom Source/Server which do not implement close_connection route or __reset_connections internal function. With this PR, WebGear_RTC now provides custom_stream attribute with its options parameter that allows you to easily define your own Custom Streaming Class with suitable source which can seamlessly handle restarting of source/server any number of times.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

[codecov]

Codecov Report

Merging #272 (c0c66e5) into testing (0cb52d1) will increase coverage by 4.52%.
The diff coverage is 86.95%.

@@             Coverage Diff             @@
##           testing     #272      +/-   ##
===========================================
+ Coverage    90.24%   94.76%   +4.52%     
===========================================
  Files           16       16              
  Lines         3034     3040       +6     
===========================================
+ Hits          2738     2881     +143     
+ Misses         296      159     -137     

Impacted Files	Coverage Δ
vidgear/gears/asyncio/webgear_rtc.py	94.97% <86.95%> (+1.41%)	⬆️
vidgear/gears/screengear.py	90.51% <0.00%> (+1.45%)	⬆️
vidgear/gears/helper.py	94.06% <0.00%> (+1.69%)	⬆️
vidgear/gears/videogear.py	100.00% <0.00%> (+3.84%)	⬆️
vidgear/gears/camgear.py	88.30% <0.00%> (+4.67%)	⬆️
vidgear/gears/pigear.py	100.00% <0.00%> (+84.44%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0cb52d1...c0c66e5. Read the comment docs.