sora-sdk 2024.3.0

WebRTC SFU Sora Python SDK

Sora Python SDK

Sora Python SDK は WebRTC SFU Sora の Python クライアントアプリケーションを開発するためのライブラリです。Sora C++ SDK をベースにしています。

About Shiguredo's open source software

We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.

Please read https://github.com/shiguredo/oss/blob/master/README.en.md before use.

時雨堂のオープンソースソフトウェアについて

利用前に https://github.com/shiguredo/oss をお読みください。

Sora Python SDK について

様々なプラットフォームに対応しすぐに使い始められる WebRTC SFU Sora 向けの Python SDK です。

特徴

• Sora C++ SDK ベース
• WebRTC 部分の機能は libwebrtc を採用
• Windows / macOS / Linux (Ubuntu) プラットフォームに対応
• NVIDIA Jetson JetPack SDK に対応
• Intel / Apple / NVIDIA のハードウェアデコーダー/エンコーダーに対応
  • Intel VPL (AV1 / H.264 / H.265)
  • Apple Video Toolbox (H.264 / H.265)
  • NVIDIA Video Codec SDK (VP9 / H.264 / H.265)
  • NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
• OpenH264 を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
• 物体検出などの入力に Sora 経由で受信した映像が利用できる
• 音声認識などの入力に Sora 経由で受信した音声を利用できる
• pip install sora_sdk でインストール可能

利用イメージ

• データチャンネルを利用して Python において映像、音声を解析した結果を Sora 経由で配信する
• Text to Speech の音声を Sora 経由で配信する
• 映像入力に対して Pillow などで加工した映像を Sora を経由で配信する
• A チャンネルの参加者からの映像と音声を B チャンネルに対して加工した上で Sora 経由で配信する

ドキュメント

Sora Python SDK

サンプル集

examples を参照してください。

sora_sdk パッケージの追加

pip

pip install sora_sdk

Rye

Rye

rye add sora_sdk
rye sync

NVIDIA Jetson 向けパッケージ

PyPI 経由ではインストールできません。 パッケージバイナリを配布しておりますので、そちらをご利用ください。

システム条件

• WebRTC SFU Sora 2023.2.0 以降
• Python 3.10 以上

対応プラットフォーム

• Windows 11 x86_64
• Windows Server 2022 x86_64
• macOS Ventura 14 arm64
• macOS Sonoma 13 arm64
• Ubuntu 24.04 LTS x86_64
• Ubuntu 22.04 LTS x86_64
• Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
  • PyPI からではなくパッケージファイルを利用してください

対応機能

• Sora の機能へ追従
• VP8 / VP9 / AV1 / H.264 / H.265 のハードウェアアクセラレーター (HWA) 対応
  • 各プラットフォームで利用可能な HWA への対応
• OpenH264 を利用した H.264 のソフトウェアエンコーダー/デコーダーへの対応

優先実装

優先実装とは Sora のライセンスを契約頂いているお客様向けに Sora Python SDK の実装予定機能を有償にて前倒しで実装することです。

詳細は Discord やメールなどでお気軽にお問い合わせください

• DataChannel 対応
  • アダワープジャパン株式会社 様
• Intel VPL H.265 対応
  • アダワープジャパン株式会社 様

優先実装が可能な機能一覧

詳細は Discord やメールなどでお気軽にお問い合わせください

• Windows 11 arm64
• Ubuntu 24.04 arm64
• Ubuntu 22.04 arm64
• Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
• AMD Video Core Next (VCN) 対応
  • VP9 / AV1 / H.264 / H.265
• Python 3.9 以前への対応

サポートについて

Discord

• サポートしません
• アドバイスします
• フィードバック歓迎します

最新の状況などは Discord で共有しています。質問や相談も Discord でのみ受け付けています。

https://discord.gg/shiguredo

バグ報告

Discord へお願いします。

ライセンス

Apache License 2.0

Copyright 2023-2024, tnoho (Original Author)
Copyright 2023-2024, Wandbox LLC (Original Author)
Copyright 2023-2024, Shiguredo Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

このリポジトリに含まれる shiguremaru.png ファイルのライセンスは CC BY-NC-ND 4.0 です。

OpenH264

https://www.openh264.org/BINARY_LICENSE.txt

"OpenH264 Video Codec provided by Cisco Systems, Inc."