# リリースノート **CHANGE** : 後方互換性のない変更 **UPDATE** : 後方互換性がある変更 **ADD** : 後方互換性がある追加 **FIX** : バグ修正 NVIDIA Jetson JetPack SDK での利用は [NVIDIA Jetson JetPack SDK](jetson_jetpack.html) をご確認ください。 ## 2025.5.2 **日付**: 2025-12-22 **対応 Sora C++ SDK**: 2025.6.2 **対応 Sora**: 2025.1.x / 2025.2.x **対応 Python**: 3.12 / 3.13 / 3.14 - [FIX] `video_h265_params` への対応が洩れていたのを修正しました ## 2025.5.1 **日付**: 2025-12-08 **対応 Sora C++ SDK**: 2025.6.1 **対応 Sora**: 2025.1.x / 2025.2.x **対応 Python**: 3.12 / 3.13 / 3.14 - [FIX] Sora C++ SDK のバージョンを `2025.6.1` にアップデートしました- 最新の Raspberry Pi OS で libcamera が 0.6 に上がり動作しない問題を修正しました ## 2025.5.0 **日付**: 2025-12-01 **対応 Sora C++ SDK**: 2025.6.0 **対応 Sora**: 2025.1.x / 2025.2.x **対応 Python**: 3.12 / 3.13 / 3.14 - [ADD] Python 3.14 に対応しました - [ADD] Python 3.11 を非対応にしました - [ADD] Raspberry Pi OS 向けのパッケージを sora-sdk-rpi として PyPI に追加しました- `uv add sora-sdk-rpi` でインストールできます - Raspberry Pi OS Bookworm の arm64v8 に対応しています - [ADD] Raspberry Pi OS 向けに libcamera を利用できる `Sora.create_libcamera_source()` を追加しました - [ADD] Raspberry Pi OS 向けに V4L2-M2M API 経由で H.264 ハードウェアアクセラレーターを利用できる `VideoCodecImplementation.RASPI_V4L2M2M` を追加しました- Raspberry Pi 5 は H.264 ハードウェアアクセラレーターが搭載されていないため利用できません - [ADD] サイマルキャスト機能で初期の `rid` を指定する `simulcast_request_rid` オプションを追加しました- デフォルトは未指定です- `simulcast` を `true` で指定する必要があります- `sendrecv` または `recvonly` でのみ有効です - [UPDATE] Sora C++ SDK のバージョンを `2025.6.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m143.7499.1.0` にアップデートしました - CMAKE_VERSION を `4.1.2` にアップデートしました ## 2025.4.0 **日付**: 2025-09-12 **対応 Sora C++ SDK**: 2025.5.0 **対応 Sora**: 2024.2.x / 2025.1.x **対応 Python**: 3.11 / 3.12 / 3.13 - [CHANGE] run.py をサブコマンド形式に変更しました- 従来: `python run.py `- 新形式: `python run.py build ` - [UPDATE] Sora C++ SDK のバージョンを `2025.5.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m139.7258.3.0` にアップデートしました - CMAKE_VERSION を `4.1.3` にアップデートしました - BOOST_VERSION を `1.89.0` にアップデートしました - [UPDATE] `.github/workflows` 内のすべてのワークフローファイルを新しい `run.py build` 形式にアップデートしました - [UPDATE] nanobind を `2.9.2` にアップデートしました - [UPDATE] Sora C++ SDK のバージョンを `2025.5.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m139.7258.3.0` にアップデートしました- CMAKE_VERSION を `4.1.0` にアップデートしました- BOOST_VERSION を `1.89.0` にアップデートしました - [ADD] run.py に format サブコマンドを追加しました- C++ ファイルの clang-format によるフォーマット機能- Python ファイルの ty によるタイプチェック機能 - [FIX] GitHub Actions の check_ubuntu_wheel ジョブで uv 0.8 以降の externally managed Python 環境エラーを修正しました- `uv run --with` から `uv pip install` を使用する方式に変更- checkouts せずに仮想環境を作成して wheel ファイルをテストするように変更 ## 2025.3.0 **日付**: 2025-07-09 **対応 Sora C++ SDK**: 2025.4.0 **対応 Sora**: 2024.2.x / 2025.1.x **対応 Python**: 3.11 / 3.12 / 3.13 - [UPDATE] Sora C++ SDK のバージョンを `2025.4.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m138.7204.0` にアップデートしました - CMAKE_VERSION を `4.0.3` にアップデートしました - [ADD] `__version__` でバージョンを取得できるようにしました - [ADD] Ubuntu 22.04 arm64 でのビルドを追加しました - [ADD] WebSocket 接続時に `User-Agent` を上書きする機能を追加しました - [ADD] `on_rpc` コールバックを追加しました- Sora 2025.2.0 から利用できる用になる予定です - [FIX] pyi ファイルを Python のバージョン毎に生成していなかった問題を修正しました - [FIX] Ubuntu arm64 での Python 3.11 と 3.12 に対応できていなかった問題を修正しました ## 2025.2.3 **日付**: 2025-05-23 **対応 Sora C++ SDK**: 2025.3.1 **対応 Sora**: 2024.1.x / 2024.2.x **対応 Python**: 3.11 / 3.12 / 3.13 - [FIX] 切断時に落ちる問題を解消するために [Sora C++ SDK](https://github.com/shiguredo/sora-cpp-sdk) を `2025.3.1` にアップデートしました ## 2025.2.2 **日付**: 2025-05-15 **対応 Sora C++ SDK**: 2025.3.0 **対応 Sora**: 2024.1.x / 2024.2.x **対応 Python**: 3.11 / 3.12 / 3.13 - [FIX] Python 3.13 で [nanobind](https://github.com/wjakob/nanobind) によるメモリーリークが発生している問題を修正しました ## 2025.2.1 **日付**: 2025-05-01 **対応 Sora C++ SDK**: 2025.3.0 **対応 Sora**: 2024.1.x / 2024.2.x **対応 Python**: 3.11 / 3.12 / 3.13 - [FIX] [PyPI](https://pypi.org/) を Organization に移行した事による Publishing ができない問題を修正しました ## 2025.2.0 **日付**: 2025-05-01 **対応 Sora C++ SDK**: 2025.3.0 **対応 Sora**: 2024.1.x / 2024.2.x **対応 Python**: 3.11 / 3.12 / 3.13 - [UPDATE] [nanobind](https://github.com/wjakob/nanobind) を `2.5.0` にアップデートしました - [UPDATE] [Sora C++ SDK](https://github.com/shiguredo/sora-cpp-sdk) を `2025.2.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m136.7103.0.0` にアップデートしました - BOOST_VERSION を `1.88.0` にアップデートしました - CMAKE_VERSION を `4.0.1` にアップデートしました - OPENH264_VERSION を `v2.6.0` にアップデートしました ## 2025.1.0 **日付**: 2025-03-19 **対応 Sora C++ SDK**: 2025.2.0 **対応 Sora**: 2024.1.x / 2024.2.x **対応 Python**: 3.11 / 3.12 / 3.13 - [CHANGE] macOS Sonoma 13 のサポートを終了しました- 今後は優先実装でのサポートとなります - [CHANGE] Python 3.10 のサポートを終了しました- 今後は優先実装でのサポートとなります - [SPEC 0 — Minimum Supported Dependencies](https://scientific-python.org/specs/spec-0000/) を参考に直近 3 バージョンのサポートに変更しました - [CHANGE] `Sora()` から `use_hardware_encoder` を廃止しました- 今後は Sora.video_codec_preference を利用してください - [CHANGE] mTLS で利用する `client_cert` と `client_key` をファイルパスではなくファイルの中身を指定するように変更しました- `str` 型から `bytes` 型に変更しました - open("cert-key.pem", “rb”).read() などで読み込んだバイナリを渡すようにしてください - [CHANGE] シグナリング接続時の `"type": "connect"` 時に `multistream` 項目を送らないように変更しました- 今回の変更により Sora 2022.1.0 以前には接続できなくなります - [UPDATE] [Sora C++ SDK](https://github.com/shiguredo/sora-cpp-sdk) を `2025.2.0` にアップデートしました- WEBRTC_BUILD_VERSION を `m132.6834.5.8` にアップデートしました - BOOST_VERSION を `1.87.0` にアップデートしました - CMAKE_VERSION を `3.31.6` にアップデートしました - OPENH264_VERSION を `2.6.0` にアップデートしました - [UPDATE] [nanobind](https://github.com/wjakob/nanobind) を `2.5.0` にアップデートしました - [ADD] マルチ転送フィルター用の `forwarding_filters` を追加しました- 将来的に `forwarding_filter` は廃止する予定ですので、 `forwarding_filters` を利用してください - [ADD] Ubuntu 24.04 arm64v8 に対応しました- Python 3.12 でのみ対応しています - [ADD] Ubuntu 24.04 arm64 上で arm64v8 向けのビルドを行えるようにしました - [ADD] Windows x86_64で [OpenH264](https://www.openh264.org/) を利用した H.264 のデコードとエンコードが利用可能になりました - [ADD] [AMD AMF](https://gpuopen.com/advanced-media-framework/) を利用したハードウェアアクセラレーター機能に対応しました - [ADD] Sora.video_codec_preference を追加しました- コーデックのエンコード/デコードを細かく指定できるようになりました - 詳細は Sora.video_codec_preference をご確認ください - [ADD] エンコード時の劣化優先順位を指定する `degradation_preference` を追加しました- `Sora.create_connection()` の引数に `degradation_preference` を追加しました - Enum 型 `SoraDegradationPreference` を追加しました- `MAINTAIN_RESOLUTION` は解像度を優先 - `MAINTAIN_FRAMERATE` はフレームレートを優先 - `BALANCED` はバランスを優先 - `DISABLED` は無効 - [ADD] Sora.create_connection の引数に `audio_opus_params` を追加しました- Opus のパラメーターを指定できるようになりました - [ADD] [WebRTC Encoded Transform](https://www.webrtc.org/blog/webrtc-encoded-transform) に対応しました- `SoraTransformableAudioFrame` と `SoraTransformableVideoFrame` を追加しました - `SoraAudioFrameTransformer` と `SoraVideoFrameTransformer` を追加しました - `create_connection()` の引数に `audio_frame_transformer` と `video_frame_transformer` を追加しました - `SoraMediaTrack` に `set_frame_transformer()` を追加しました - 詳細は [WebRTC Encoded Transform](webrtc_encoded_transform.html) をご確認ください - [ADD] Python 3.13 に対応しました - [ADD] CA 証明書を指定できる `ca_cert` を追加しました- open("ca.pem", “rb”).read() などで読み込んだバイナリを渡すようにしてください - [ADD] 受信したシグナリングメッセージを取得できる `on_signaling_message` コールバックを追加しました- `connect` / `redirect` / `offer` / `answer` / `re-offer` / `re-answer` / `disconnect` メッセージが取得できます - `switched` メッセージは SoraConnection.on_switched を利用してください - `ping` と `pong` メッセージは取得できません - 詳細は SoraConnection.on_signaling_message をご確認ください - [ADD] シグナリングの WebSocket 終了時のコードと理由が取得できる `on_ws_close` コールバックを追加しました- SDK 側で WebSocket が切断された際には `code` は `1000` 、 `reason` は `"SELF-CLOSED"` が返ります - 詳細は SoraConnection.on_ws_close をご確認ください - [ADD] 転送フィルターを複数指定できるマルチ転送フィルターに対応しました ## 2024.3.0 **日付**: 2024-08-05 **対応 Sora C++ SDK**: 2024.7.0 **対応 Sora**: 2023.2.x / 2024.1.x **対応 Python**: 3.10 / 3.11 / 3.12 - [CHANGE] Python 3.8 と 3.9 のサポートを終了しました- 今後は優先実装でのサポートとなります - [CHANGE] NVIDIA Jetson 向け sora_sdk バイナリを PyPI から削除しました- `support/jetson-jetpack-6` ブランチでメンテナンスを継続します - 今後は PyPI 経由ではなく、GitHub Releases から whl ファイルをダウンロードして利用してください - [UPDATE] Sora C++ SDK を `2024.7.0` にアップデートしました - [UPDATE] nanobind を `2.0.0` にアップデートしました - [UPDATE] cmake を `3.29.6` にアップデートしました - [UPDATE] libwebrtc のバージョンを `m127.6533.1.1` にアップデートしました - [UPDATE] Windows 向けビルドを Windows Server 2022 x86_64 に変更しました - [ADD] メッセージング機能の `header` に対応しました - [ADD] WebRTC Encoded Transform に対応しました- `SoraTransformableAudioFrame` と `SoraTransformableVideoFrame` を追加しました - `SoraAudioFrameTransformer` と `SoraVideoFrameTransformer` を追加しました - `create_connection()` の引数に `audio_frame_transformer` と `video_frame_transformer` を追加しました - `SoraMediaTrack` に `set_frame_transformer()` を追加しました - 詳細は [WebRTC Encoded Transform](webrtc_encoded_transform.html) をご確認ください - [ADD] macOS 向けビルドに macOS 14 arm64 を追加しました - [ADD] `sora_sdk` に型を追加しました - [ADD] `SoraConnection` に `get_stats` 関数を追加しました - [ADD] Sora C++ SDK と libwebrtc のローカルビルドを利用できるようにしました - [FIX] `SoraAudioSink.read` が `timeout` を無視して失敗を返す問題を修正しました - [FIX] MSVC 内部コンパイルエラーにより Windows で nanobind のビルドができない問題を修正しました ## 2024.2.0 **日付**: 2024-04-09 **対応 Sora C++ SDK**: 2024.6.0 **対応 Sora**: 2023.2.x **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 / 3.12 - [CHANGE] Lyra のサポートを廃止し、以下のオプションを削除しました- `audio_codec_lyra_bitrate` - `audio_codec_lyra_usedtx` - `check_lyra_version` - [UPDATE] Sora C++ SDK のバージョンを `2024.6.0` に上げました - [UPDATE] WEBRTC_BUILD_VERSION を `m122.6261.1.0` に上げました - [UPDATE] nanobind のバージョンを `1.9.2` に上げて固定したバージョンとしました - [UPDATE] ruff の最小バージョンを `0.3.0` に上げました - [UPDATE] BOOST_VERSION を `1.84.0` に上げました - [UPDATE] Intel VPL を利用した `H.265` に対応しました - [ADD] Sora Python SDK Samples を `examples` に移動しました - [ADD] シグナリング `"type": "switched"` メッセージの受信を通知する `on_switched` コールバックを追加しました - [FIX] Ubuntu 20.04 arm64 NVIDIA Jetson 5.1.2 で AV1 が正常に配信されない問題を修正しました ### 既知の問題 - Intel VPL を利用したときに H.264 の映像が正常に受信できない- Intel VPL の問題と Sora C++ SDK の両方に問題が発生しています - Sora C++ SDK の問題は修正され、動作が改善する予定です - 完全な修正は Intel VPL の不具合が修正される必要があります ## 2024.1.0 **日付**: 2024-02-20 **対応 Sora C++ SDK**: 2024.1.0 **対応 Sora**: 2023.2.x **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 / 3.12 - [CHANGE] Python フォーマッターを [Ruff](https://github.com/astral-sh/ruff) に変更しました - [CHANGE] `SoraAudioSource.on_data` の引数名を変更しました - [CHANGE] `SoraVideoSource.on_captured` の引数名を変更しました - [CHANGE] `SoraVAD.analyze` の引数名を変更しました - [CHANGE] `SoraConnection.on_track` の引数を `SoraMediaTrack` に変更しました - [UPDATE] Python 3.12 に対応しました - [UPDATE] [nanobind](https://github.com/wjakob/nanobind) の最小を `1.8.0` に上げました - [UPDATE] Sora C++ SDK のバージョンを `2024.1.0` に上げました- WebRTC m116 で cricket::Codec は protected になったので cricket::CreateVideoCodec に修正しました - WebRTC m118 でパッケージディレクトリが変更されたためそれに追従しました - WebRTC m120 の webrtc::EncodedImage API の変更に追従しました - WEBRTC_BUILD_VERSION を `m120.6099.1.2` に上げました - BOOST_VERSION を `1.83.0` に上げました - CMAKE_VERSION を `3.27.7` に上げました - [UPDATE] `ForwardingFilter` に `version` と `metadata` を追加しました- WebRTC SFU Sora の `2023.2.x` へ追従しました - [UPDATE] NVIDIA JetPack SDK を `5.1.2` に上げました - [ADD] `SoraMediaTrack` を追加しました - [ADD] 発話区間の検出が可能な `SoraVAD` を追加しました - [ADD] リアルタイム性を重視した `AudioStreamSink` を追加しました - [ADD] AudioStreamSink が返す音声フレームとして pickle が可能な `AudioFrame` を追加しました ### 既知の問題 - C++ SDK の問題で NVIDIA JetPack SDK 5.1.2 での AV1 配信が正常に行えません- `2024.2.0` で問題は解消されています ## 2023.3.1 **日付**: 2023-07-13 **対応 Sora C++ SDK**: 2023.7.1 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [FIX] C++ SDK のバージョンを 2023.7.2 にアップデートしました- 特定のタイミングで切断が発生すると Closing 状態で止まってしまう問題を修正しました ## 2023.3.0 **日付**: 2023-07-06 **対応 Sora C++ SDK**: 2023.7.1 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [CHANGE] signaling_url を signaling_urls へ変更しました- 引数の型を str から List[str] に変更しました ## 2023.2.0 **日付**: 2023-07-03 **対応 Sora C++ SDK**: 2023.7.1 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [ADD] Ubuntu 22.04 x86_64 で OpenH264 を利用した H.264 のデコードとエンコードが利用可能になりました- 今までは HWA が無いと H.264 が利用できませんでしたが、 [OpenH264](http://www.openh264.org/) のバイナリをダウンロードし、設定することで利用可能になりました ## 2023.1.2 **日付**: 2023-06-28 **対応 Sora C++ SDK**: 2023.7.1 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [FIX] Windows 版のバイナリが正常に動作しない問題を修正しました ## 2023.1.1 **日付**: 2023-06-27 **対応 Sora C++ SDK**: 2023.7.1 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [FIX] connect 直後に disconnect すると落ちる問題を修正しました ## 2023.1.0 **日付**: 2023-06-19 **対応 Sora C++ SDK**: 2023.7.0 **対応 Sora**: 2023.1.x 以降 **対応 Python**: 3.8 / 3.9 / 3.10 / 3.11 - [ADD] PyPI に sora_sdk として公開しました - [ADD] macOS 13 arm64 向けの whl パッケージへ対応しました- Python 3.8 / 3.9 / 3.10 / 3.11 の Python のバージョンに対応しました - [ADD] Windows 11 x86_64 向けの whl パッケージへ対応しました- Python 3.8 / 3.9 / 3.10 / 3.11 の Python のバージョンに対応しました - [ADD] Ubuntu 22.04 x86_64 向けの whl パッケージへ対応しました- Python 3.8 / 3.9 / 3.10 / 3.11 の Python のバージョンに対応しました - [ADD] Ubuntu 20.04 arm64 向けの whl パッケージへ対応しました- NVIDIA Jetson のみに対応しています - JetPack SDK 5 系のみに対応しています - Python 3.8 にのみ対応しています - [ADD] HTTP Proxy に対応しました - [ADD] クライアント認証 (mTLS) に対応しました - [ADD] サイマルキャスト機能に対応しました - [ADD] スポットライト機能に対応しました - [ADD] 転送フィルター機能に対応しました - [ADD] 音声コーデック Lyra に対応しました - [ADD] 映像コーデック VP9 と AV1 と H.264 のパラメーター設定に対応しました - [ADD] 音声ストリーミングの言語コードに対応しました - [ADD] データチャネルメッセージング対応しました- `data_channel_signaling` を指定できるようにしました - `ignore_disconnect_websocket` を指定できるようにしました - [ADD] データチャネルシグナリング対応しました- `on_message` コールバック有効化しました - `data_channels` を指定できるようにしました - [ADD] 音声と映像の無効化を利用可能にしました - [ADD] 音声と映像の送受信 / 送信 / 受信サンプルを追加しました - [ADD] メッセージング機能の 送受信 / 送信 / 受信サンプルを追加しました