sora-sdk 2025.3.0.dev3__cp313-cp313-macosx_15_0_arm64.whl → 2025.5.0.dev10__cp313-cp313-macosx_15_0_arm64.whl

{sora_sdk-2025.3.0.dev3.data → sora_sdk-2025.5.0.dev10.data}/purelib/sora_sdk/__init__.py

@@ -1,5 +1,28 @@
 from .sora_sdk_ext import *  # noqa: F401,F403
 
+# インストールされたパッケージの場合は importlib.metadata から取得
+# 開発環境の場合は VERSION ファイルから取得
+try:
+    from importlib.metadata import version, PackageNotFoundError
+
+    try:
+        __version__ = version("sora_sdk")
+    except PackageNotFoundError:
+        # パッケージがインストールされていない場合（開発環境）
+        import os
+
+        _version_file = os.path.join(
+            os.path.dirname(os.path.dirname(os.path.dirname(__file__))), "VERSION"
+        )
+        if os.path.exists(_version_file):
+            with open(_version_file, "r") as f:
+                __version__ = f.read().strip()
+        else:
+            __version__ = "unknown"
+except ImportError:
+    # Python 3.8 以前の互換性のため
+    __version__ = "unknown"
+
 """
 sink はそれぞれ track が必要で参照を保持する必要がある
 しかしながら、 sink の C++ 側で shared_ptr として track を持つと、

{sora_sdk-2025.3.0.dev3.data → sora_sdk-2025.5.0.dev10.data}/purelib/sora_sdk/sora_sdk_ext.pyi

@@ -2,7 +2,8 @@ from collections.abc import Callable, Sequence
 import enum
 from typing import Annotated, overload
 
-from numpy.typing import ArrayLike
+import numpy
+from numpy.typing import NDArray
 
 
 class SoraSignalingErrorCode(enum.IntEnum):
@@ -92,20 +93,20 @@ class SoraAudioSource(SoraTrackInterface):
     def on_data(self, data: int, samples_per_channel: int) -> None: ...
 
     @overload
-    def on_data(self, ndarray: Annotated[ArrayLike, dict(dtype='int16', shape=(None, None), order='C', device='cpu')], timestamp: float) -> None: ...
+    def on_data(self, ndarray: Annotated[NDArray[numpy.int16], dict(shape=(None, None), order='C', device='cpu')], timestamp: float) -> None: ...
 
     @overload
-    def on_data(self, ndarray: Annotated[ArrayLike, dict(dtype='int16', shape=(None, None), order='C', device='cpu')]) -> None: ...
+    def on_data(self, ndarray: Annotated[NDArray[numpy.int16], dict(shape=(None, None), order='C', device='cpu')]) -> None: ...
 
 class SoraVideoSource(SoraTrackInterface):
     @overload
-    def on_captured(self, ndarray: Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3), order='C', device='cpu')]) -> None: ...
+    def on_captured(self, ndarray: Annotated[NDArray[numpy.uint8], dict(shape=(None, None, 3), order='C', device='cpu')]) -> None: ...
 
     @overload
-    def on_captured(self, ndarray: Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3), order='C', device='cpu')], timestamp: float) -> None: ...
+    def on_captured(self, ndarray: Annotated[NDArray[numpy.uint8], dict(shape=(None, None, 3), order='C', device='cpu')], timestamp: float) -> None: ...
 
     @overload
-    def on_captured(self, ndarray: Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3), order='C', device='cpu')], timestamp_us: int) -> None: ...
+    def on_captured(self, ndarray: Annotated[NDArray[numpy.uint8], dict(shape=(None, None, 3), order='C', device='cpu')], timestamp_us: int) -> None: ...
 
 class SoraAudioSinkImpl:
     def __init__(self, track: SoraTrackInterface, output_frequency: int = -1, output_channels: int = 0) -> None: ...
@@ -115,10 +116,10 @@ class SoraAudioSinkImpl:
     def read(self, frames: int = 0, timeout: float = 1) -> tuple: ...
 
     @property
-    def on_data(self) -> Callable[[Annotated[ArrayLike, dict(dtype='int16', shape=(None, None))]], None]: ...
+    def on_data(self) -> Callable[[Annotated[NDArray[numpy.int16], dict(shape=(None, None))]], None]: ...
 
     @on_data.setter
-    def on_data(self, arg: Callable[[Annotated[ArrayLike, dict(dtype='int16', shape=(None, None))]], None], /) -> None: ...
+    def on_data(self, arg: Callable[[Annotated[NDArray[numpy.int16], dict(shape=(None, None))]], None], /) -> None: ...
 
     @property
     def on_format(self) -> Callable[[int, int], None]: ...
@@ -143,7 +144,7 @@ class SoraAudioFrame:
     @property
     def absolute_capture_timestamp_ms(self) -> int | None: ...
 
-    def data(self) -> Annotated[ArrayLike, dict(dtype='int16', shape=(None, None))]: ...
+    def data(self) -> Annotated[NDArray[numpy.int16], dict(shape=(None, None))]: ...
 
 class SoraAudioStreamSinkImpl:
     def __init__(self, track: SoraTrackInterface, output_frequency: int = -1, output_channels: int = 0) -> None: ...
@@ -162,7 +163,7 @@ class SoraVAD:
     def analyze(self, frame: SoraAudioFrame) -> float: ...
 
 class SoraVideoFrame:
-    def data(self) -> Annotated[ArrayLike, dict(dtype='uint8', shape=(None, None, 3))]: ...
+    def data(self) -> Annotated[NDArray[numpy.uint8], dict(shape=(None, None, 3))]: ...
 
 class SoraVideoSinkImpl:
     def __init__(self, arg: SoraTrackInterface, /) -> None: ...
@@ -258,9 +259,9 @@ class SoraTransformableFrameDirection(enum.IntEnum):
     SENDER = 2
 
 class SoraTransformableFrame:
-    def get_data(self) -> Annotated[ArrayLike, dict(dtype='uint8', shape=(None), writable=False)]: ...
+    def get_data(self) -> Annotated[NDArray[numpy.uint8], dict(shape=(None,), writable=False)]: ...
 
-    def set_data(self, arg: Annotated[ArrayLike, dict(dtype='uint8', shape=(None), order='C', device='cpu', writable=False)], /) -> None: ...
+    def set_data(self, arg: Annotated[NDArray[numpy.uint8], dict(shape=(None,), order='C', device='cpu', writable=False)], /) -> None: ...
 
     @property
     def payload_type(self) -> int: ...
@@ -289,7 +290,7 @@ class SoraTransformableAudioFrameType(enum.IntEnum):
 
 class SoraTransformableAudioFrame(SoraTransformableFrame):
     @property
-    def contributing_sources(self) -> Annotated[ArrayLike, dict(dtype='uint32', shape=(None), writable=False)]: ...
+    def contributing_sources(self) -> Annotated[NDArray[numpy.uint32], dict(shape=(None,), writable=False)]: ...
 
     @property
     def sequence_number(self) -> int | None: ...
@@ -314,7 +315,7 @@ class SoraTransformableVideoFrame(SoraTransformableFrame):
     def frame_id(self) -> int | None: ...
 
     @property
-    def frame_dependencies(self) -> Annotated[ArrayLike, dict(dtype='int64', shape=(None), writable=False)]: ...
+    def frame_dependencies(self) -> Annotated[NDArray[numpy.int64], dict(shape=(None,), writable=False)]: ...
 
     @property
     def width(self) -> int: ...
@@ -329,7 +330,7 @@ class SoraTransformableVideoFrame(SoraTransformableFrame):
     def temporal_index(self) -> int: ...
 
     @property
-    def contributing_sources(self) -> Annotated[ArrayLike, dict(dtype='uint32', shape=(None), writable=False)]: ...
+    def contributing_sources(self) -> Annotated[NDArray[numpy.uint32], dict(shape=(None,), writable=False)]: ...
 
 class SoraFrameTransformer:
     def enqueue(self, arg: SoraTransformableFrame, /) -> None: ...
@@ -369,6 +370,8 @@ class SoraVideoCodecImplementation(enum.IntEnum):
 
     AMD_AMF = 4
 
+    RASPI_V4L2M2M = 5
+
 class SoraVideoCodecType(enum.IntEnum):
     VP8 = 1
 
@@ -489,10 +492,12 @@ class SoraVideoCodecPreference:
 def create_video_codec_preference_from_implementation(arg0: SoraVideoCodecCapability, arg1: SoraVideoCodecImplementation, /) -> SoraVideoCodecPreference: ...
 
 class Sora:
-    def __init__(self, openh264: str | None = None, video_codec_preference: SoraVideoCodecPreference | None = None) -> None: ...
+    def __init__(self, openh264: str | None = None, video_codec_preference: SoraVideoCodecPreference | None = None, force_i420_conversion: bool | 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, degradation_preference: Optional[SoraDegradationPreference] = None, user_agent: Optional[str] = None) -> SoraConnection: ...
 
     def create_audio_source(self, channels: int, sample_rate: int) -> SoraAudioSource: ...
 
     def create_video_source(self) -> SoraVideoSource: ...
+
+    def create_libcamera_source(self, width: int, height: int, fps: int, native_frame_output: bool, controls: Optional[list[tuple[str, str]]] = None) -> SoraTrackInterface: ...

{sora_sdk-2025.3.0.dev3.dist-info → sora_sdk-2025.5.0.dev10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sora_sdk
-Version: 2025.3.0.dev3
+Version: 2025.5.0.dev10
 Summary: WebRTC SFU Sora Python SDK
 Home-page: https://github.com/shiguredo/sora-python-sdk
 Author-email: "Shiguredo Inc." <contact+pypi@shiguredo.jp>
@@ -12,6 +12,11 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: C++
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -24,6 +29,7 @@ Dynamic: license-file
 [![image](https://img.shields.io/pypi/pyversions/sora_sdk.svg)](https://pypi.python.org/pypi/sora_sdk)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Actions status](https://github.com/shiguredo/sora-python-sdk/workflows/build/badge.svg)](https://github.com/shiguredo/sora-python-sdk/actions)
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://discord.gg/shiguredo)
 
 Sora Python SDK は [WebRTC SFU Sora](https://sora.shiguredo.jp/) の Python クライアントアプリケーションを開発するためのライブラリです。[Sora C++ SDK](https://github.com/shiguredo/sora-cpp-sdk) をベースにしています。
 
@@ -45,15 +51,19 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 
 ## 特徴
 
+- PyPI 経由で `uv add sora-sdk` や `pip install sora-sdk` でインストールできる
+- Raspberry Pi 向けパッケージ `sora-sdk-rpi` の提供
+  - `uv add sora-sdk-rpi` でインストールできる
+- Raspberry Pi 向けに libcamera 用の `create_libcamera_source` を提供
 - [Sora C++ SDK](https://github.com/shiguredo/sora-cpp-sdk) ベース
 - WebRTC 部分の機能は [libwebrtc](https://webrtc.googlesource.com/src/) を採用
-- Windows / macOS / Linux (Ubuntu) プラットフォームに対応
+- Windows / macOS / Linux (Ubuntu / Raspberry Pi OS) プラットフォームに対応
 - [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 が指定できる
+  - `MAINTAIN_FRAMERATE` / `MAINTAIN_RESOLUTION` / `BALANCED` が指定できる
 - 発話区間の検出が可能な VAD (Voice Activity Detection) に対応
-- Intel / Apple / NVIDIA のハードウェアデコーダー/エンコーダーに対応
+- Intel / Apple / NVIDIA / Raspberry Pi のハードウェアデコーダー/エンコーダーに対応
   - Apple Video Toolbox (H.264 / H.265)
     - macOS arm64 で利用できる
   - Intel VPL (AV1 / H.264 / H.265)
@@ -62,10 +72,13 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
     - Ubuntu x86_64 / Windows x86_64 で利用できる
     - AV1 エンコードは Windows x86_64 でのみ利用できる
     - VP9 はデコードのみ利用できる
-  - NVIDIA Video Codec SDK (VP8 / VP9 / AV1 / H.264 / H.265)
+  - NVIDIA Video Codec (VP8 / VP9 / AV1 / H.264 / H.265)
     - Ubuntu x86_64 / Windows x86_64 で利用できる
     - VP8 と VP9 はデコードのみ利用できる
   - NVIDIA Jetson JetPack SDK (AV1 / H.264 / H.265)
+  - Raspberry Pi (H.264)
+    - Raspberry Pi 4 / Raspberry Pi 3 / Raspberry Pi 2 Model B v1.2 / Raspberry Pi Zero 2 W で利用できる
+    - V4L2-M2M API を利用している
   - [各プラットフォームで利用可能な 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 で利用できる
@@ -73,7 +86,6 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 - 映像デバイス処理に [opencv-python](https://pypi.org/project/opencv-python/) などが利用できる
 - 音声認識などの入力に受信した音声を利用できる
 - 物体検出などの入力に受信した映像を利用できる
-- `uv add sora_sdk` や `pip install sora_sdk` でインストール可能
 - [NVIDIA Jetson JetPack SDK](https://developer.nvidia.com/embedded/jetpack) に対応
 
 ## 利用イメージ
@@ -93,18 +105,16 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 
 ## sora_sdk パッケージの追加
 
-### uv
-
-[uv](https://docs.astral.sh/uv/)
+[uv](https://docs.astral.sh/uv/) の利用を推奨します。
 
 ```bash
 uv add sora_sdk
 ```
 
-### pip
+### Raspberry Pi OS 向けパッケージ
 
 ```bash
-pip install sora_sdk
+uv add sora_sdk_rpi
 ```
 
 ### NVIDIA Jetson 向けパッケージ
@@ -116,7 +126,7 @@ PyPI 経由ではインストールできません。
 
 ## システム条件
 
-- WebRTC SFU Sora 2024.1.0 以降
+- WebRTC SFU Sora 2024.2.0 以降
 - Python 3.11 以上
 
 ## Python サポートポリシー
@@ -128,12 +138,31 @@ PyPI 経由ではインストールできません。
 - 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 からではなくパッケージファイルを利用してください
+- Ubuntu 22.04 LTS arm64
 - macOS Sequoia 15 arm64
 - macOS Ventura 14 arm64
 - Windows 11 x86_64
 - Windows Server 2025 x86_64
+- Raspberry Pi OS armv8
+
+### Raspberry Pi OS 向け
+
+- Raspberry Pi OS bookworm (64bit)
+  - Raspberry Pi 5
+  - Raspberry Pi 4
+  - Raspberry Pi 3
+  - Raspberry Pi 2 Model B v1.2
+  - Raspberry Pi Zero 2 W
+
+> [!CAUTION]
+>
+> - Raspberry Pi 5 は H.264 ハードウェアエンコーダーが搭載されていません
+> - Raspberry Pi 5 の H.265 ハードウェアデコーダーに対応していません
+
+### NVIDIA Jetson 向け
+
+- Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
+  - PyPI からではなくパッケージファイルを利用してください
 
 ### macOS の対応バージョン
 
@@ -157,7 +186,6 @@ PyPI 経由ではインストールできません。
 ### 優先実装が可能な機能一覧
 
 - Windows 11 arm64
-- Ubuntu 22.04 arm64
 - Ubuntu 22.04 arm64 (NVIDIA Jetson JetPack SDK 6.1)
 - Ubuntu 20.04 arm64 (NVIDIA Jetson JetPack SDK 5)
 

sora_sdk-2025.5.0.dev10.dist-info/RECORD

@@ -0,0 +1,9 @@
+sora_sdk-2025.5.0.dev10.data/purelib/sora_sdk/__init__.py,sha256=oIPJZylpxilyawkPEH8yjPEZ5wV-wdFnwL1DWH5Ksm0,2004
+sora_sdk-2025.5.0.dev10.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sora_sdk-2025.5.0.dev10.data/purelib/sora_sdk/sora_sdk_ext.cpython-313-darwin.so,sha256=JrWsIFO1gMoYe2BHzF3rDjMCYX2FHLk5IVo2pqziTdE,15562032
+sora_sdk-2025.5.0.dev10.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=_vSuS0PNtNbqGtVCtYEAPeAqziYMn0vWWJJ1RGISVL0,15785
+sora_sdk-2025.5.0.dev10.dist-info/licenses/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
+sora_sdk-2025.5.0.dev10.dist-info/METADATA,sha256=hgwpdxPAAVHtBH5ZUxuk56L-psQ-ueuogqs3aLbp7zU,10975
+sora_sdk-2025.5.0.dev10.dist-info/WHEEL,sha256=bYnk7s_74GtjsL7Cla9unXlhKW3fT-fE7drGEnXRPCU,109
+sora_sdk-2025.5.0.dev10.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
+sora_sdk-2025.5.0.dev10.dist-info/RECORD,,

{sora_sdk-2025.3.0.dev3.dist-info → sora_sdk-2025.5.0.dev10.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: false
 Tag: cp313-cp313-macosx_15_0_arm64
 

sora_sdk-2025.3.0.dev3.dist-info/RECORD

@@ -1,9 +0,0 @@
-sora_sdk-2025.3.0.dev3.data/purelib/sora_sdk/__init__.py,sha256=wmp56UEjNDhA8r3i98RVW_6oVTCskhSOd8qENIU6B5Q,1180
-sora_sdk-2025.3.0.dev3.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sora_sdk-2025.3.0.dev3.data/purelib/sora_sdk/sora_sdk_ext.cpython-313-darwin.so,sha256=4hAHJz-ZhIGcfTipxr47o6qygXRU0EHaf1mHMyJNGEw,15201472
-sora_sdk-2025.3.0.dev3.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=vmEPy2J0PDUz4LP378pQc1-Az6BnE-mqOCL5PhEQTnE,15581
-sora_sdk-2025.3.0.dev3.dist-info/licenses/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
-sora_sdk-2025.3.0.dev3.dist-info/METADATA,sha256=BHJWVs5nXg9dOUArlFxchco-IcrPVb5awazvPo1f9FY,9691
-sora_sdk-2025.3.0.dev3.dist-info/WHEEL,sha256=XOD3IGjOXBKDEGCNa05tDKLrC-aeYKucGA-MDK4M0L4,109
-sora_sdk-2025.3.0.dev3.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
-sora_sdk-2025.3.0.dev3.dist-info/RECORD,,