sora-sdk 2024.4.0.dev45__cp311-cp311-macosx_15_0_arm64.whl → 2025.1.0__cp311-cp311-macosx_15_0_arm64.whl

{sora_sdk-2024.4.0.dev45.data → sora_sdk-2025.1.0.data}/purelib/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.dev45.dist-info → sora_sdk-2025.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: sora_sdk
-Version: 2024.4.0.dev45
+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-2025.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+sora_sdk-2025.1.0.data/purelib/sora_sdk/__init__.py,sha256=wmp56UEjNDhA8r3i98RVW_6oVTCskhSOd8qENIU6B5Q,1180
+sora_sdk-2025.1.0.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sora_sdk-2025.1.0.data/purelib/sora_sdk/sora_sdk_ext.cpython-311-darwin.so,sha256=r7TxoXLRgr-f-or3ek2V5KgcsaH1fUMpgKLQ620i9u8,14616928
+sora_sdk-2025.1.0.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=tjh-XIdJx0A0OlE-PlYglKua0lIezpUJyX91pPTTXUY,15384
+sora_sdk-2025.1.0.dist-info/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
+sora_sdk-2025.1.0.dist-info/METADATA,sha256=euZGBV__Cko_Ki2z_2RuYNW5PUe6f0A79ZC3ELIfcuE,21045
+sora_sdk-2025.1.0.dist-info/NOTICE.md,sha256=lYwHwtm82A3TWxdWhE-TEuCF517wKb1sdk8eBMH47Yk,31624
+sora_sdk-2025.1.0.dist-info/WHEEL,sha256=iUX9MVyQPlqcbj1J89EPRyXxI0aHHHaR3CeuJ8dOcv0,109
+sora_sdk-2025.1.0.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
+sora_sdk-2025.1.0.dist-info/RECORD,,

{sora_sdk-2024.4.0.dev45.dist-info → sora_sdk-2025.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (76.1.0)
 Root-Is-Purelib: false
 Tag: cp311-cp311-macosx_15_0_arm64
 

sora_sdk-2024.4.0.dev45.dist-info/RECORD

@@ -1,10 +0,0 @@
-sora_sdk-2024.4.0.dev45.data/purelib/sora_sdk/__init__.py,sha256=wmp56UEjNDhA8r3i98RVW_6oVTCskhSOd8qENIU6B5Q,1180
-sora_sdk-2024.4.0.dev45.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sora_sdk-2024.4.0.dev45.data/purelib/sora_sdk/sora_sdk_ext.cpython-311-darwin.so,sha256=u0-8vRh3FO6noSzY2VDKl1mOw1tDeqyO78Gtmvj3ZhQ,14566128
-sora_sdk-2024.4.0.dev45.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=olz4kMGitd32S0YCX6a-E1NUxxf9ACFObD1iZ377v2w,11555
-sora_sdk-2024.4.0.dev45.dist-info/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
-sora_sdk-2024.4.0.dev45.dist-info/METADATA,sha256=Bqfp221UefPesUw9jtrTPN6VSdiCKotinNFKlBUGYzM,20234
-sora_sdk-2024.4.0.dev45.dist-info/NOTICE.md,sha256=lYwHwtm82A3TWxdWhE-TEuCF517wKb1sdk8eBMH47Yk,31624
-sora_sdk-2024.4.0.dev45.dist-info/WHEEL,sha256=BH79EMEZDNHclVtodvdRJ5hxB6-dyW8VVf908vJ9aKg,109
-sora_sdk-2024.4.0.dev45.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
-sora_sdk-2024.4.0.dev45.dist-info/RECORD,,