aiortc

.. image:: docs/_static/aiortc.svg :width: 120px :alt: aiortc

.. image:: https://img.shields.io/pypi/l/aiortc.svg :target: https://pypi.python.org/pypi/aiortc :alt: 许可证

.. image:: https://img.shields.io/pypi/v/aiortc.svg :target: https://pypi.python.org/pypi/aiortc :alt: 版本

.. image:: https://img.shields.io/pypi/pyversions/aiortc.svg :target: https://pypi.python.org/pypi/aiortc :alt: Python版本

.. image:: https://github.com/aiortc/aiortc/workflows/tests/badge.svg :target: https://github.com/aiortc/aiortc/actions :alt: 测试

.. image:: https://img.shields.io/codecov/c/github/aiortc/aiortc.svg :target: https://codecov.io/gh/aiortc/aiortc :alt: 覆盖率

.. image:: https://readthedocs.org/projects/aiortc/badge/?version=latest :target: https://aiortc.readthedocs.io/ :alt: 文档

什么是aiortc？

aiortc是一个用于Python的Web实时通信(WebRTC)_和对象实时通信(ORTC)_的库。它建立在Python标准异步I/O框架asyncio之上。

该API紧密跟随其JavaScript对应部分，同时使用Python风格的结构：

• 承诺被协程替代
• 事件使用pyee.EventEmitter发出

要了解更多关于aiortc的信息，请阅读文档_。

.. _Web实时通信(WebRTC): https://webrtc.org/ .. _对象实时通信(ORTC): https://ortc.org/ .. _阅读文档: https://aiortc.readthedocs.io/en/latest/

为什么我应该使用aiortc？

主要的WebRTC和ORTC实现要么内置于网络浏览器中，要么以原生代码的形式存在。虽然它们经过了广泛的实战测试，但其内部结构复杂，并且不提供Python绑定。此外，它们与媒体栈紧密耦合，使得插入音频或视频处理算法变得困难。

相比之下，aiortc的实现相当简单易读。因此，对于希望了解WebRTC工作原理或修改其内部结构的程序员来说，这是一个很好的起点。通过利用Python生态系统中可用的广泛模块，也很容易创建创新产品。例如，您可以构建一个同时处理信令和数据通道的完整服务器，或使用OpenCV对视频帧应用计算机视觉算法。

此外，我们投入了大量精力为aiortc代码编写了广泛的测试套件，以确保一流的代码质量。

实现状态

aiortc允许您交换音频、视频和数据通道，并定期测试与Chrome和Firefox的互操作性。以下是它的一些特性：

• SDP生成/解析
• 交互式连接建立，支持半嗅探和mDNS
• DTLS密钥和证书生成
• DTLS握手、加密/解密（用于SCTP）
• SRTP密钥生成、RTP和RTCP的加密和解密
• 纯Python SCTP实现
• 数据通道
• 发送和接收音频（Opus / PCMU / PCMA）
• 发送和接收视频（VP8 / H.264）
• 音频/视频/数据通道的捆绑
• RTCP报告，包括用于恢复丢包的NACK / PLI

安装

安装aiortc最简单的方法是运行：

.. code:: bash

pip install aiortc

从源代码构建

如果您的系统没有可用的轮子或者您希望从源代码构建aiortc，您需要在系统上安装几个库：

• 用于音频编码/解码的Opus
• 用于视频编码/解码的LibVPX

Linux .....

在Debian/Ubuntu上运行：

.. code:: bash

apt install libopus-dev libvpx-dev

OS X ....

在OS X上运行：

.. code:: bash

brew install opus libvpx

许可证

aiortc根据BSD许可证_发布。

.. _BSD许可证: https://aiortc.readthedocs.io/en/latest/license.html