sora-sdk 2025.4.0.dev5__cp313-cp313-macosx_15_0_arm64.whl → 2025.5.0.dev1__cp313-cp313-macosx_15_0_arm64.whl

{sora_sdk-2025.4.0.dev5.data → sora_sdk-2025.5.0.dev1.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.4.0.dev5.dist-info → sora_sdk-2025.5.0.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sora_sdk
-Version: 2025.4.0.dev5
+Version: 2025.5.0.dev1
 Summary: WebRTC SFU Sora Python SDK
 Home-page: https://github.com/shiguredo/sora-python-sdk
 Author-email: "Shiguredo Inc." <contact+pypi@shiguredo.jp>
@@ -47,13 +47,13 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 
 - [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 が指定できる
 - 発話区間の検出が可能な 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 +62,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 +76,9 @@ 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` でインストール可能
+- `uv add sora_sdk` や `pip install sora_sdk` でインストールできる
+  - Raspberry Pi 向けのパッケージも `uv add sora_sdk_rpi` でインストールできる
+- Raspberry Pi 向けに libcamera 用の `create_libcamera_source` を提供
 - [NVIDIA Jetson JetPack SDK](https://developer.nvidia.com/embedded/jetpack) に対応
 
 ## 利用イメージ
@@ -99,6 +104,12 @@ Please read <https://github.com/shiguredo/oss/blob/master/README.en.md> before u
 uv add sora_sdk
 ```
 
+### Raspberry Pi OS 向けパッケージ
+
+```bash
+uv add sora_sdk_rpi
+```
+
 ### NVIDIA Jetson 向けパッケージ
 
 PyPI 経由ではインストールできません。
@@ -125,8 +136,23 @@ PyPI 経由ではインストールできません。
 - 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 ハードウェアデコーダーに対応していません
 
-### Jetson 向け
+### NVIDIA Jetson 向け
 
 - Ubuntu 22.04 LTS arm64 (NVIDIA Jetson JetPack SDK 6)
   - PyPI からではなくパッケージファイルを利用してください

sora_sdk-2025.5.0.dev1.dist-info/RECORD

@@ -0,0 +1,9 @@
+sora_sdk-2025.5.0.dev1.data/purelib/sora_sdk/__init__.py,sha256=oIPJZylpxilyawkPEH8yjPEZ5wV-wdFnwL1DWH5Ksm0,2004
+sora_sdk-2025.5.0.dev1.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sora_sdk-2025.5.0.dev1.data/purelib/sora_sdk/sora_sdk_ext.cpython-313-darwin.so,sha256=kzHmqp5ICH54wQCt_rTSVElAP9VYZKRcgqRXEfC5vU0,15438544
+sora_sdk-2025.5.0.dev1.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=_vSuS0PNtNbqGtVCtYEAPeAqziYMn0vWWJJ1RGISVL0,15785
+sora_sdk-2025.5.0.dev1.dist-info/licenses/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
+sora_sdk-2025.5.0.dev1.dist-info/METADATA,sha256=hUQnH8IeMhs96DyGjPc5oM2rZ7TVEx1r-7-jJ5uts6E,10568
+sora_sdk-2025.5.0.dev1.dist-info/WHEEL,sha256=bYnk7s_74GtjsL7Cla9unXlhKW3fT-fE7drGEnXRPCU,109
+sora_sdk-2025.5.0.dev1.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
+sora_sdk-2025.5.0.dev1.dist-info/RECORD,,

sora_sdk-2025.4.0.dev5.dist-info/RECORD

@@ -1,9 +0,0 @@
-sora_sdk-2025.4.0.dev5.data/purelib/sora_sdk/__init__.py,sha256=oIPJZylpxilyawkPEH8yjPEZ5wV-wdFnwL1DWH5Ksm0,2004
-sora_sdk-2025.4.0.dev5.data/purelib/sora_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sora_sdk-2025.4.0.dev5.data/purelib/sora_sdk/sora_sdk_ext.cpython-313-darwin.so,sha256=8ceIJKocW3GekzsQpcC4HNVcc_lq4Lm1ToAWwQc867Y,14841296
-sora_sdk-2025.4.0.dev5.data/purelib/sora_sdk/sora_sdk_ext.pyi,sha256=vmEPy2J0PDUz4LP378pQc1-Az6BnE-mqOCL5PhEQTnE,15581
-sora_sdk-2025.4.0.dev5.dist-info/licenses/LICENSE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
-sora_sdk-2025.4.0.dev5.dist-info/METADATA,sha256=pJ1sPPdmMWpqUx1vktWB6CqTrfhS_xhDGESKIEt-Ddo,9695
-sora_sdk-2025.4.0.dev5.dist-info/WHEEL,sha256=bYnk7s_74GtjsL7Cla9unXlhKW3fT-fE7drGEnXRPCU,109
-sora_sdk-2025.4.0.dev5.dist-info/top_level.txt,sha256=edTg20cFFAjWfRrB0APD_SXho5Qq24PwLESbyPoCVko,9
-sora_sdk-2025.4.0.dev5.dist-info/RECORD,,