sora-sdk 2024.4.0.dev44__tar.gz → 2025.1.0__tar.gz

{sora_sdk-2024.4.0.dev44/src/sora_sdk.egg-info → sora_sdk-2025.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: sora_sdk
-Version: 2024.4.0.dev44
+Version: 2025.1.0
 Summary: WebRTC SFU Sora Python SDK
 Home-page: https://github.com/shiguredo/sora-python-sdk
 Author-email: "Shiguredo Inc." <contact+pypi@shiguredo.jp>
@@ -187,14 +187,14 @@ Project-URL: Documentation, https://sora-python-sdk.shiguredo.jp
 Project-URL: Discord, https://discord.gg/shiguredo
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE.md
+Dynamic: home-page
 
 # Sora Python SDK
 
@@ -228,13 +228,24 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 - Windows / macOS / Linux (Ubuntu) プラットフォームに対応
 - [WebRTC 統計情報](https://www.w3.org/TR/webrtc-stats/) の取得が可能
 - [WebRTC Encoded Transform](https://www.w3.org/TR/webrtc-encoded-transform/) に対応
+- 回線が不安定になった際、解像度とフレームレートどちらを維持するかの設定をする [DegradationPreference](https://w3c.github.io/mst-content-hint/#degradation-preference-when-encoding) に対応
+  - MAINTAIN_FRAMERATE / MAINTAIN_RESOLUTION / BALANCED が指定できる
 - 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)
+    - macOS arm64 で利用できる
+  - Intel VPL (AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+  - AMD AMF (VP9 /AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - AV1 エンコードは Windows x86_64 でのみ利用できる
+    - VP9 はデコードのみ利用できる
+  - NVIDIA Video Codec SDK (VP8 / VP9 / AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - VP8 と VP9 はデコードのみ利用できる
   - NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
   - [各プラットフォームで利用可能な HWA への対応](https://github.com/shiguredo/sora-cpp-sdk?tab=readme-ov-file#%E7%89%B9%E5%BE%B4)
 - [OpenH264](https://github.com/cisco/openh264) を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
+  - Ubuntu x86_64 / Ubuntu arm64 / Windows x86_64 / macOS arm64 で利用できる
 - 音声デバイス処理に [sounddevice](https://pypi.org/project/sounddevice/) などが利用できる
 - 映像デバイス処理に [opencv-python](https://pypi.org/project/opencv-python/) などが利用できる
 - 音声認識などの入力に受信した音声を利用できる
@@ -282,20 +293,24 @@ PyPI 経由ではインストールできません。
 
 ## システム条件
 
-- WebRTC SFU Sora 2023.2.0 以降
-- Python 3.10 以上
+- WebRTC SFU Sora 2024.1.0 以降
+- Python 3.11 以上
+
+## Python サポートポリシー
+
+直近の 3 バージョンの Python をサポートします。
 
 ## 対応プラットフォーム
 
-- Windows 11 x86_64
-- Windows Server 2022 x86_64
-- macOS Sequoia 15 arm64
-- macOS Ventura 14 arm64
 - Ubuntu 24.04 LTS x86_64
 - Ubuntu 24.04 LTS arm64
 - Ubuntu 22.04 LTS x86_64
 - Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
   - PyPI からではなくパッケージファイルを利用してください
+- macOS Sequoia 15 arm64
+- macOS Ventura 14 arm64
+- Windows 11 x86_64
+- Windows Server 2022 x86_64
 
 ### macOS の対応バージョン
 
@@ -319,12 +334,9 @@ PyPI 経由ではインストールできません。
 ### 優先実装が可能な機能一覧
 
 - Windows 11 arm64
-- macOS Sonoma 13 arm64
 - Ubuntu 22.04 arm64
+- Ubuntu 22.04 arm64 (NVIDIA Jetson JetPack SDK 6.1)
 - Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
-- AMD Video Core Next (VCN) 対応
-  - VP9 / AV1 / H.264 / H.265
-- Python 3.9 以前への対応
 
 ## サポートについて
 
@@ -347,9 +359,9 @@ Discord へお願いします。
 Apache License 2.0
 
 ```text
-Copyright 2023-2024, tnoho (Original Author)
-Copyright 2023-2024, Wandbox LLC (Original Author)
-Copyright 2023-2024, Shiguredo Inc.
+Copyright 2023-2025, tnoho (Original Author)
+Copyright 2023-2025, Wandbox LLC (Original Author)
+Copyright 2023-2025, Shiguredo Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0}/README.md

@@ -30,13 +30,24 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 - Windows / macOS / Linux (Ubuntu) プラットフォームに対応
 - [WebRTC 統計情報](https://www.w3.org/TR/webrtc-stats/) の取得が可能
 - [WebRTC Encoded Transform](https://www.w3.org/TR/webrtc-encoded-transform/) に対応
+- 回線が不安定になった際、解像度とフレームレートどちらを維持するかの設定をする [DegradationPreference](https://w3c.github.io/mst-content-hint/#degradation-preference-when-encoding) に対応
+  - MAINTAIN_FRAMERATE / MAINTAIN_RESOLUTION / BALANCED が指定できる
 - 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)
+    - macOS arm64 で利用できる
+  - Intel VPL (AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+  - AMD AMF (VP9 /AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - AV1 エンコードは Windows x86_64 でのみ利用できる
+    - VP9 はデコードのみ利用できる
+  - NVIDIA Video Codec SDK (VP8 / VP9 / AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - VP8 と VP9 はデコードのみ利用できる
   - NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
   - [各プラットフォームで利用可能な HWA への対応](https://github.com/shiguredo/sora-cpp-sdk?tab=readme-ov-file#%E7%89%B9%E5%BE%B4)
 - [OpenH264](https://github.com/cisco/openh264) を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
+  - Ubuntu x86_64 / Ubuntu arm64 / Windows x86_64 / macOS arm64 で利用できる
 - 音声デバイス処理に [sounddevice](https://pypi.org/project/sounddevice/) などが利用できる
 - 映像デバイス処理に [opencv-python](https://pypi.org/project/opencv-python/) などが利用できる
 - 音声認識などの入力に受信した音声を利用できる
@@ -84,20 +95,24 @@ PyPI 経由ではインストールできません。
 
 ## システム条件
 
-- WebRTC SFU Sora 2023.2.0 以降
-- Python 3.10 以上
+- WebRTC SFU Sora 2024.1.0 以降
+- Python 3.11 以上
+
+## Python サポートポリシー
+
+直近の 3 バージョンの Python をサポートします。
 
 ## 対応プラットフォーム
 
-- Windows 11 x86_64
-- Windows Server 2022 x86_64
-- macOS Sequoia 15 arm64
-- macOS Ventura 14 arm64
 - Ubuntu 24.04 LTS x86_64
 - Ubuntu 24.04 LTS arm64
 - Ubuntu 22.04 LTS x86_64
 - Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
   - PyPI からではなくパッケージファイルを利用してください
+- macOS Sequoia 15 arm64
+- macOS Ventura 14 arm64
+- Windows 11 x86_64
+- Windows Server 2022 x86_64
 
 ### macOS の対応バージョン
 
@@ -121,12 +136,9 @@ PyPI 経由ではインストールできません。
 ### 優先実装が可能な機能一覧
 
 - Windows 11 arm64
-- macOS Sonoma 13 arm64
 - Ubuntu 22.04 arm64
+- Ubuntu 22.04 arm64 (NVIDIA Jetson JetPack SDK 6.1)
 - Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
-- AMD Video Core Next (VCN) 対応
-  - VP9 / AV1 / H.264 / H.265
-- Python 3.9 以前への対応
 
 ## サポートについて
 
@@ -149,9 +161,9 @@ Discord へお願いします。
 Apache License 2.0
 
 ```text
-Copyright 2023-2024, tnoho (Original Author)
-Copyright 2023-2024, Wandbox LLC (Original Author)
-Copyright 2023-2024, Shiguredo Inc.
+Copyright 2023-2025, tnoho (Original Author)
+Copyright 2023-2025, Wandbox LLC (Original Author)
+Copyright 2023-2025, Shiguredo Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0}/buildbase.py

@@ -520,6 +520,7 @@ class WebrtcInfo(NamedTuple):
     webrtc_library_dir: str
     clang_dir: str
     libcxx_dir: str
+    libcxxabi_dir: str
 
 
 def get_webrtc_info(
@@ -536,6 +537,9 @@ def get_webrtc_info(
             webrtc_library_dir=os.path.join(webrtc_install_dir, "lib"),
             clang_dir=os.path.join(install_dir, "llvm", "clang"),
             libcxx_dir=os.path.join(install_dir, "llvm", "libcxx"),
+            libcxxabi_dir=os.path.join(
+                webrtc_install_dir, "include", "third_party", "libc++abi", "src"
+            ),
         )
     else:
         webrtc_build_source_dir = os.path.join(
@@ -556,6 +560,9 @@ def get_webrtc_info(
                 webrtc_build_source_dir, "src", "third_party", "llvm-build", "Release+Asserts"
             ),
             libcxx_dir=os.path.join(webrtc_build_source_dir, "src", "third_party", "libc++", "src"),
+            libcxxabi_dir=os.path.join(
+                webrtc_build_source_dir, "src", "third_party", "libc++abi", "src"
+            ),
         )
 
 
@@ -691,7 +698,7 @@ def build_and_install_boost(
 ):
     version_underscore = version.replace(".", "_")
     archive = download(
-        f"https://boostorg.jfrog.io/artifactory/main/release/{version}/source/boost_{version_underscore}.tar.gz",
+        f"https://archives.boost.io/release/{version}/source/boost_{version_underscore}.tar.gz",
         source_dir,
     )
     extract(archive, output_dir=build_dir, output_dirname="boost")
@@ -1701,7 +1708,10 @@ def get_build_platform() -> PlatformTarget:
     if arch in ("AMD64", "x86_64"):
         arch = "x86_64"
     elif arch in ("aarch64", "arm64"):
-        arch = "arm64"
+        if os == "ubuntu":
+            arch = "armv8"
+        else:
+            arch = "arm64"
     else:
         raise Exception(f"Arch {arch} not supported")
 
@@ -1800,8 +1810,8 @@ class Platform(object):
                 self._check(build.arch in ("x86_64", "arm64"))
         if target.os == "ubuntu":
             self._check(build.os == "ubuntu")
-            self._check(build.arch == "x86_64")
-            if target.arch == "x86_64":
+            self._check(build.arch in ("x86_64", "armv8"))
+            if build.arch == target.arch:
                 self._check(build.osver == target.osver)
         if target.os == "raspberry-pi-os":
             self._check(build.os == "ubuntu")

sora_sdk-2025.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "sora_sdk"
+authors = [{ name = "Shiguredo Inc.", email = "contact+pypi@shiguredo.jp" }]
+version = "2025.1.0"
+description = "WebRTC SFU Sora Python SDK"
+readme = "README.md"
+license = { file = "LICENSE" }
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">= 3.11"
+
+[project.urls]
+Source = "https://github.com/shiguredo/sora-python-sdk"
+Documentation = "https://sora-python-sdk.shiguredo.jp"
+Discord = "https://discord.gg/shiguredo"
+
+[build-system]
+requires = ["setuptools==76.1", "wheel==0.45.1"]
+build-backend = "setuptools.build_meta"
+
+[tool.uv]
+python-preference = "only-managed"
+dev-dependencies = [
+    "nanobind==2.5.0",
+    "setuptools==76.1",
+    "build==1.2.2.post1",
+    "wheel==0.45.1",
+    "typing-extensions",
+    "python-dotenv",
+    "numpy",
+    "httpx",
+    "pytest",
+    "ruff",
+    "mypy",
+    "pyjwt",
+    "pytest-repeat",
+    "psutil",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+
+[tool.pytest.ini_options]
+xfail_strict = true

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0}/run.py

@@ -127,7 +127,7 @@ def install_deps(
         install_cmake_args["platform"] = "macos-universal"
     elif platform.build.os == "ubuntu" and platform.build.arch == "x86_64":
         install_cmake_args["platform"] = "linux-x86_64"
-    elif platform.build.os == "ubuntu" and platform.build.arch == "arm64":
+    elif platform.build.os == "ubuntu" and platform.build.arch == "armv8":
         install_cmake_args["platform"] = "linux-aarch64"
     else:
         raise Exception("Failed to install CMake")
@@ -261,12 +261,24 @@ def main():
         if platform.target.os == "ubuntu":
             # クロスコンパイルの設定。
             # 本来は toolchain ファイルに書く内容
+
+            if platform.build.arch == "armv8":
+                # ビルド環境が armv8 の場合は libwebrtc のバイナリが使えないのでローカルの clang を利用する
+                cmake_args += [
+                    "-DCMAKE_C_COMPILER=clang-18",
+                    "-DCMAKE_CXX_COMPILER=clang++-18",
+                ]
+            else:
+                cmake_args += [
+                    f"-DCMAKE_C_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang')}",
+                    f"-DCMAKE_CXX_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang++')}",
+                ]
             cmake_args += [
-                f"-DCMAKE_C_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang')}",
-                f"-DCMAKE_CXX_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang++')}",
                 f"-DLIBCXX_INCLUDE_DIR={cmake_path(os.path.join(webrtc_info.libcxx_dir, 'include'))}",
+                f"-DLIBCXXABI_INCLUDE_DIR={cmake_path(os.path.join(webrtc_info.libcxxabi_dir, 'include'))}",
             ]
-            if platform.target.arch == "armv8":
+
+            if platform.build.arch != platform.target.arch:
                 sysroot = os.path.join(install_dir, "rootfs")
                 nb_cmake_dir = cmdcap(["uv", "run", "python", "-m", "nanobind", "--cmake_dir"])
                 cmake_args += [
@@ -279,7 +291,6 @@ def main():
                     "-DCMAKE_FIND_ROOT_PATH_MODE_LIBRARY=BOTH",
                     "-DCMAKE_FIND_ROOT_PATH_MODE_INCLUDE=BOTH",
                     "-DCMAKE_FIND_ROOT_PATH_MODE_PACKAGE=BOTH",
-                    f"-DCMAKE_SYSROOT={sysroot}",
                     f"-DPython_ROOT_DIR={cmake_path(os.path.join(sysroot, 'usr', 'include', 'python3.12'))}",
                     f"-DCMAKE_SYSROOT={sysroot}",
                     f"-DNB_CMAKE_DIR={nb_cmake_dir}",

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0}/src/sora_sdk/sora_sdk_ext.pyi

@@ -6,9 +6,9 @@ from numpy.typing import ArrayLike
 
 
 class Sora:
-    def __init__(self, use_hardware_encoder: bool | None = None, openh264: str | None = None) -> None: ...
+    def __init__(self, openh264: str | None = None, video_codec_preference: SoraVideoCodecPreference | None = None) -> None: ...
 
-    def create_connection(self, signaling_urls: list[str], role: str, channel_id: str, client_id: Optional[str] = None, bundle_id: Optional[str] = None, metadata: Optional[dict] = None, signaling_notify_metadata: Optional[dict] = None, audio_source: Optional[SoraTrackInterface] = None, video_source: Optional[SoraTrackInterface] = None, audio_frame_transformer: Optional[SoraAudioFrameTransformer] = None, video_frame_transformer: Optional[SoraVideoFrameTransformer] = None, audio: Optional[bool] = None, video: Optional[bool] = None, audio_codec_type: Optional[str] = None, video_codec_type: Optional[str] = None, video_bit_rate: Optional[int] = None, audio_bit_rate: Optional[int] = None, video_vp9_params: Optional[dict] = None, video_av1_params: Optional[dict] = None, video_h264_params: Optional[dict] = None, audio_opus_params: Optional[dict] = None, simulcast: Optional[bool] = None, spotlight: Optional[bool] = None, spotlight_number: Optional[int] = None, simulcast_rid: Optional[str] = None, spotlight_focus_rid: Optional[str] = None, spotlight_unfocus_rid: Optional[str] = None, forwarding_filter: Optional[dict] = None, forwarding_filters: Optional[list[dict]] = None, data_channels: Optional[list[dict]] = None, data_channel_signaling: Optional[bool] = None, ignore_disconnect_websocket: Optional[bool] = None, data_channel_signaling_timeout: Optional[int] = None, disconnect_wait_timeout: Optional[int] = None, websocket_close_timeout: Optional[int] = None, websocket_connection_timeout: Optional[int] = None, audio_streaming_language_code: Optional[str] = None, insecure: Optional[bool] = None, client_cert: Optional[bytes] = None, client_key: Optional[bytes] = None, ca_cert: Optional[bytes] = None, proxy_url: Optional[str] = None, proxy_username: Optional[str] = None, proxy_password: Optional[str] = None, proxy_agent: Optional[str] = None) -> SoraConnection: ...
+    def create_connection(self, signaling_urls: list[str], role: str, channel_id: str, client_id: Optional[str] = None, bundle_id: Optional[str] = None, metadata: Optional[dict] = None, signaling_notify_metadata: Optional[dict] = None, audio_source: Optional[SoraTrackInterface] = None, video_source: Optional[SoraTrackInterface] = None, audio_frame_transformer: Optional[SoraAudioFrameTransformer] = None, video_frame_transformer: Optional[SoraVideoFrameTransformer] = None, audio: Optional[bool] = None, video: Optional[bool] = None, audio_codec_type: Optional[str] = None, video_codec_type: Optional[str] = None, video_bit_rate: Optional[int] = None, audio_bit_rate: Optional[int] = None, video_vp9_params: Optional[dict] = None, video_av1_params: Optional[dict] = None, video_h264_params: Optional[dict] = None, audio_opus_params: Optional[dict] = None, simulcast: Optional[bool] = None, spotlight: Optional[bool] = None, spotlight_number: Optional[int] = None, simulcast_rid: Optional[str] = None, spotlight_focus_rid: Optional[str] = None, spotlight_unfocus_rid: Optional[str] = None, forwarding_filter: Optional[dict] = None, forwarding_filters: Optional[list[dict]] = None, data_channels: Optional[list[dict]] = None, data_channel_signaling: Optional[bool] = None, ignore_disconnect_websocket: Optional[bool] = None, data_channel_signaling_timeout: Optional[int] = None, disconnect_wait_timeout: Optional[int] = None, websocket_close_timeout: Optional[int] = None, websocket_connection_timeout: Optional[int] = None, audio_streaming_language_code: Optional[str] = None, insecure: Optional[bool] = None, client_cert: Optional[bytes] = None, client_key: Optional[bytes] = None, ca_cert: Optional[bytes] = None, proxy_url: Optional[str] = None, proxy_username: Optional[str] = None, proxy_password: Optional[str] = None, proxy_agent: Optional[str] = None, degradation_preference: Optional[SoraDegradationPreference] = None) -> SoraConnection: ...
 
     def create_audio_source(self, channels: int, sample_rate: int) -> SoraAudioSource: ...
 
@@ -156,6 +156,15 @@ class SoraConnection:
     @on_data_channel.setter
     def on_data_channel(self, arg: Callable[[str], None], /) -> None: ...
 
+class SoraDegradationPreference(enum.IntEnum):
+    DISABLED = 0
+
+    BALANCED = 3
+
+    MAINTAIN_FRAMERATE = 1
+
+    MAINTAIN_RESOLUTION = 2
+
 class SoraFrameTransformer:
     def enqueue(self, arg: SoraTransformableFrame, /) -> None: ...
 
@@ -313,6 +322,132 @@ class SoraVAD:
 
     def analyze(self, frame: SoraAudioFrame) -> float: ...
 
+class SoraVideoCodecCapability:
+    @property
+    def engines(self) -> list[SoraVideoCodecCapability.Engine]: ...
+
+    def to_json(self) -> object: ...
+
+    class Parameters:
+        @property
+        def version(self) -> str | None: ...
+
+        @property
+        def openh264_path(self) -> str | None: ...
+
+        @property
+        def vpl_impl(self) -> str | None: ...
+
+        @property
+        def vpl_impl_value(self) -> int | None: ...
+
+        @property
+        def nvcodec_gpu_device_name(self) -> str | None: ...
+
+        @property
+        def amf_runtime_version(self) -> str | None: ...
+
+        @property
+        def amf_embedded_version(self) -> str | None: ...
+
+    class Codec:
+        @property
+        def type(self) -> SoraVideoCodecType: ...
+
+        @property
+        def encoder(self) -> bool: ...
+
+        @property
+        def decoder(self) -> bool: ...
+
+        @property
+        def parameters(self) -> SoraVideoCodecCapability.Parameters: ...
+
+    class Engine:
+        @property
+        def name(self) -> SoraVideoCodecImplementation: ...
+
+        @property
+        def codecs(self) -> list[SoraVideoCodecCapability.Codec]: ...
+
+        @property
+        def parameters(self) -> SoraVideoCodecCapability.Parameters: ...
+
+class SoraVideoCodecImplementation(enum.IntEnum):
+    INTERNAL = 0
+
+    CISCO_OPENH264 = 1
+
+    INTEL_VPL = 2
+
+    NVIDIA_VIDEO_CODEC_SDK = 3
+
+    AMD_AMF = 4
+
+class SoraVideoCodecPreference:
+    def __init__(self, codecs: Sequence[SoraVideoCodecPreference.Codec] = []) -> None: ...
+
+    @property
+    def codecs(self) -> list[SoraVideoCodecPreference.Codec]: ...
+
+    @codecs.setter
+    def codecs(self, arg: Sequence[SoraVideoCodecPreference.Codec], /) -> None: ...
+
+    def to_json(self) -> object: ...
+
+    def find(self, arg: SoraVideoCodecType, /) -> int | None: ...
+
+    def get_or_add(self, arg: SoraVideoCodecType, /) -> int: ...
+
+    def has_implementation(self, arg: SoraVideoCodecImplementation, /) -> bool: ...
+
+    def merge(self, arg: SoraVideoCodecPreference, /) -> None: ...
+
+    class Parameters:
+        def __init__(self) -> None: ...
+
+    class Codec:
+        @overload
+        def __init__(self) -> None: ...
+
+        @overload
+        def __init__(self, type: SoraVideoCodecType, encoder: SoraVideoCodecImplementation | None = None, decoder: SoraVideoCodecImplementation | None = None, parameters: SoraVideoCodecPreference.Parameters = ...) -> None: ...
+
+        @property
+        def type(self) -> SoraVideoCodecType: ...
+
+        @type.setter
+        def type(self, arg: SoraVideoCodecType, /) -> None: ...
+
+        @property
+        def encoder(self) -> SoraVideoCodecImplementation | None: ...
+
+        @encoder.setter
+        def encoder(self, arg: SoraVideoCodecImplementation, /) -> None: ...
+
+        @property
+        def decoder(self) -> SoraVideoCodecImplementation | None: ...
+
+        @decoder.setter
+        def decoder(self, arg: SoraVideoCodecImplementation, /) -> None: ...
+
+        @property
+        def parameters(self) -> SoraVideoCodecPreference.Parameters: ...
+
+        @parameters.setter
+        def parameters(self, arg: SoraVideoCodecPreference.Parameters, /) -> None: ...
+
+class SoraVideoCodecType(enum.IntEnum):
+    VP8 = 1
+
+    VP9 = 2
+
+    H264 = 4
+
+    H265 = 5
+
+    AV1 = 3
+
 class SoraVideoFrame:
     def data(self) -> Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3))]: ...
 
@@ -348,4 +483,10 @@ class SoraVideoSource(SoraTrackInterface):
     @overload
     def on_captured(self, ndarray: Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3), order='C', device='cpu')], timestamp_us: int) -> None: ...
 
+def create_video_codec_preference_from_implementation(arg0: SoraVideoCodecCapability, arg1: SoraVideoCodecImplementation, /) -> SoraVideoCodecPreference: ...
+
 def enable_libwebrtc_log(arg: SoraLoggingSeverity, /) -> None: ...
+
+def get_video_codec_capability(openh264: str | None = None) -> SoraVideoCodecCapability: ...
+
+def rtc_log(arg0: SoraLoggingSeverity, arg1: str, /) -> None: ...

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0/src/sora_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: sora_sdk
-Version: 2024.4.0.dev44
+Version: 2025.1.0
 Summary: WebRTC SFU Sora Python SDK
 Home-page: https://github.com/shiguredo/sora-python-sdk
 Author-email: "Shiguredo Inc." <contact+pypi@shiguredo.jp>
@@ -187,14 +187,14 @@ Project-URL: Documentation, https://sora-python-sdk.shiguredo.jp
 Project-URL: Discord, https://discord.gg/shiguredo
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE.md
+Dynamic: home-page
 
 # Sora Python SDK
 
@@ -228,13 +228,24 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 - Windows / macOS / Linux (Ubuntu) プラットフォームに対応
 - [WebRTC 統計情報](https://www.w3.org/TR/webrtc-stats/) の取得が可能
 - [WebRTC Encoded Transform](https://www.w3.org/TR/webrtc-encoded-transform/) に対応
+- 回線が不安定になった際、解像度とフレームレートどちらを維持するかの設定をする [DegradationPreference](https://w3c.github.io/mst-content-hint/#degradation-preference-when-encoding) に対応
+  - MAINTAIN_FRAMERATE / MAINTAIN_RESOLUTION / BALANCED が指定できる
 - 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)
+    - macOS arm64 で利用できる
+  - Intel VPL (AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+  - AMD AMF (VP9 /AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - AV1 エンコードは Windows x86_64 でのみ利用できる
+    - VP9 はデコードのみ利用できる
+  - NVIDIA Video Codec SDK (VP8 / VP9 / AV1 / H.264 / H.265)
+    - Ubuntu x86_64 / Windows x86_64 で利用できる
+    - VP8 と VP9 はデコードのみ利用できる
   - NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
   - [各プラットフォームで利用可能な HWA への対応](https://github.com/shiguredo/sora-cpp-sdk?tab=readme-ov-file#%E7%89%B9%E5%BE%B4)
 - [OpenH264](https://github.com/cisco/openh264) を利用した H.264 のソフトウェアエンコーダー/デコーダーに対応
+  - Ubuntu x86_64 / Ubuntu arm64 / Windows x86_64 / macOS arm64 で利用できる
 - 音声デバイス処理に [sounddevice](https://pypi.org/project/sounddevice/) などが利用できる
 - 映像デバイス処理に [opencv-python](https://pypi.org/project/opencv-python/) などが利用できる
 - 音声認識などの入力に受信した音声を利用できる
@@ -282,20 +293,24 @@ PyPI 経由ではインストールできません。
 
 ## システム条件
 
-- WebRTC SFU Sora 2023.2.0 以降
-- Python 3.10 以上
+- WebRTC SFU Sora 2024.1.0 以降
+- Python 3.11 以上
+
+## Python サポートポリシー
+
+直近の 3 バージョンの Python をサポートします。
 
 ## 対応プラットフォーム
 
-- Windows 11 x86_64
-- Windows Server 2022 x86_64
-- macOS Sequoia 15 arm64
-- macOS Ventura 14 arm64
 - Ubuntu 24.04 LTS x86_64
 - Ubuntu 24.04 LTS arm64
 - Ubuntu 22.04 LTS x86_64
 - Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
   - PyPI からではなくパッケージファイルを利用してください
+- macOS Sequoia 15 arm64
+- macOS Ventura 14 arm64
+- Windows 11 x86_64
+- Windows Server 2022 x86_64
 
 ### macOS の対応バージョン
 
@@ -319,12 +334,9 @@ PyPI 経由ではインストールできません。
 ### 優先実装が可能な機能一覧
 
 - Windows 11 arm64
-- macOS Sonoma 13 arm64
 - Ubuntu 22.04 arm64
+- Ubuntu 22.04 arm64 (NVIDIA Jetson JetPack SDK 6.1)
 - Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
-- AMD Video Core Next (VCN) 対応
-  - VP9 / AV1 / H.264 / H.265
-- Python 3.9 以前への対応
 
 ## サポートについて
 
@@ -347,9 +359,9 @@ Discord へお願いします。
 Apache License 2.0
 
 ```text
-Copyright 2023-2024, tnoho (Original Author)
-Copyright 2023-2024, Wandbox LLC (Original Author)
-Copyright 2023-2024, Shiguredo Inc.
+Copyright 2023-2025, tnoho (Original Author)
+Copyright 2023-2025, Wandbox LLC (Original Author)
+Copyright 2023-2025, Shiguredo Inc.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

{sora_sdk-2024.4.0.dev44 → sora_sdk-2025.1.0}/src/sora_sdk.egg-info/SOURCES.txt

@@ -9,18 +9,27 @@ run.py
 setup.py
 src/sora_sdk/__init__.py
 src/sora_sdk/py.typed
-src/sora_sdk/sora_sdk_ext.cpython-310-darwin.so
+src/sora_sdk/sora_sdk_ext.cpython-311-darwin.so
 src/sora_sdk/sora_sdk_ext.pyi
 src/sora_sdk.egg-info/PKG-INFO
 src/sora_sdk.egg-info/SOURCES.txt
 src/sora_sdk.egg-info/dependency_links.txt
 src/sora_sdk.egg-info/top_level.txt
+tests/test_amd_amf.py
+tests/test_apple_video_toolbox.py
+tests/test_authz.py
+tests/test_authz_simulcast.py
 tests/test_ca_cert.py
+tests/test_capability.py
+tests/test_degradation_preference.py
 tests/test_encoded_transform.py
-tests/test_macos.py
+tests/test_intel_vpl.py
+tests/test_memory_leak.py
 tests/test_messaging.py
 tests/test_messaging_header.py
+tests/test_nvidia_video_codec_sdk.py
 tests/test_openh264.py
+tests/test_opus.py
 tests/test_re_offer_re_answer_sdp.py
 tests/test_sendonly_recvonly.py
 tests/test_signaling.py