sora-sdk 2025.4.0.dev6__tar.gz → 2025.5.0.dev1__tar.gz

{sora_sdk-2025.4.0.dev6/src/sora_sdk.egg-info → sora_sdk-2025.5.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sora_sdk
-Version: 2025.4.0.dev6
+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.4.0.dev6 → sora_sdk-2025.5.0.dev1}/README.md

@@ -27,13 +27,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)
@@ -42,10 +42,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 で利用できる
@@ -53,7 +56,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) に対応
 
 ## 利用イメージ
@@ -79,6 +84,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 経由ではインストールできません。
@@ -105,8 +116,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/VERSION

@@ -0,0 +1 @@
+2025.5.0.dev1

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/buildbase.py

@@ -25,6 +25,7 @@
 # limitations under the License.
 import filecmp
 import glob
+import hashlib
 import logging
 import multiprocessing
 import os
@@ -143,7 +144,12 @@ def add_path(path: str, is_after=False):
         os.environ["PATH"] = path + PATH_SEPARATOR + os.environ["PATH"]
 
 
-def download(url: str, output_dir: Optional[str] = None, filename: Optional[str] = None) -> str:
+def download(
+    url: str,
+    output_dir: Optional[str] = None,
+    filename: Optional[str] = None,
+    expected_sha256: Optional[str] = None,
+) -> str:
     if filename is None:
         output_path = urllib.parse.urlparse(url).path.split("/")[-1]
     else:
@@ -153,22 +159,67 @@ def download(url: str, output_dir: Optional[str] = None, filename: Optional[str]
         output_path = os.path.join(output_dir, output_path)
 
     if os.path.exists(output_path):
-        return output_path
+        # ファイルが既に存在する場合でもハッシュチェックを行う
+        if expected_sha256 is not None:
+            try:
+                verify_sha256(output_path, expected_sha256)
+            except ValueError:
+                # ハッシュ不一致の場合はファイルを削除して再ダウンロードを試みる
+                logging.warning(f"Existing file has invalid hash, removing: {output_path}")
+                os.remove(output_path)
+                # 再ダウンロードを試みる
+                return download(url, output_dir, filename, expected_sha256)
+        else:
+            return output_path
 
     try:
+        logging.info(f"Downloading {url} to {output_path}")
         if shutil.which("curl") is not None:
             cmd(["curl", "-fLo", output_path, url])
         else:
             cmd(["wget", "-cO", output_path, url])
+
+        # ダウンロード後にハッシュチェック
+        if expected_sha256 is not None:
+            try:
+                verify_sha256(output_path, expected_sha256)
+            except ValueError as e:
+                logging.error(f"Hash verification failed. {e}")
+                raise
+
     except Exception:
         # ゴミを残さないようにする
         if os.path.exists(output_path):
+            logging.error(f"Removing incomplete/invalid file: {output_path}")
             os.remove(output_path)
         raise
 
     return output_path
 
 
+def verify_sha256(file_path: str, expected_sha256: str):
+    """ファイルの SHA256 ハッシュを検証する"""
+    logging.info(f"Verifying SHA256 hash for {file_path}")
+    sha256_hash = hashlib.sha256()
+    with open(file_path, "rb") as f:
+        # メモリ効率のため、チャンクごとに読み込む
+        for byte_block in iter(lambda: f.read(4096), b""):
+            sha256_hash.update(byte_block)
+
+    actual_sha256 = sha256_hash.hexdigest()
+    if actual_sha256 != expected_sha256.lower():
+        error_msg = (
+            f"SHA256 hash mismatch for {file_path}:\n"
+            f"  Expected: {expected_sha256.lower()}\n"
+            f"  Actual:   {actual_sha256}"
+        )
+        logging.error(error_msg)
+        logging.error("Aborting due to hash verification failure")
+        raise ValueError(error_msg)
+    else:
+        logging.info(f"SHA256 hash verified successfully for {file_path}")
+
+
 def read_version_file(path: str) -> Dict[str, str]:
     versions = {}
 
@@ -575,7 +626,14 @@ def get_webrtc_info(
 
 
 @versioned
-def install_boost(version, source_dir, install_dir, sora_version, platform: str):
+def install_boost(
+    version,
+    source_dir,
+    install_dir,
+    sora_version,
+    platform: str,
+    expected_sha256: Optional[str] = None,
+):
     win = platform.startswith("windows_")
     filename = (
         f"boost-{version}_sora-cpp-sdk-{sora_version}_{platform}.{'zip' if win else 'tar.gz'}"
@@ -584,6 +642,7 @@ def install_boost(version, source_dir, install_dir, sora_version, platform: str)
     archive = download(
         f"https://github.com/shiguredo/sora-cpp-sdk/releases/download/{sora_version}/{filename}",
         output_dir=source_dir,
+        expected_sha256=expected_sha256,
     )
     rm_rf(os.path.join(install_dir, "boost"))
     extract(archive, output_dir=install_dir, output_dirname="boost")
@@ -704,14 +763,17 @@ def build_and_install_boost(
     address_model="64",
     runtime_link=None,
     android_build_platform="linux-x86_64",
+    expected_sha256: Optional[str] = None,
 ):
     version_underscore = version.replace(".", "_")
+
     archive = download(
         # 公式サイトに負荷をかけないための時雨堂によるミラー
         f"https://oss-mirrors.shiguredo.jp/boost_{version_underscore}.tar.gz",
         # Boost 公式のミラー
         # f"https://archives.boost.io/release/{version}/source/boost_{version_underscore}.tar.gz",
         source_dir,
+        expected_sha256=expected_sha256,
     )
     extract(archive, output_dir=build_dir, output_dirname="boost")
     with cd(os.path.join(build_dir, "boost")):
@@ -738,7 +800,9 @@ def build_and_install_boost(
         if target_os == "iphone":
             IOS_BUILD_TARGETS = [("arm64", "iphoneos")]
             for arch, sdk in IOS_BUILD_TARGETS:
-                clangpp = cmdcap(["xcodebuild", "-find", "clang++"])
+                # xcode の clang++ を利用する
+                # ただし cxx が指定されてた場合はそちらを優先する
+                clangpp = cmdcap(["xcodebuild", "-find", "clang++"]) if len(cxx) == 0 else cxx
                 sysroot = cmdcap(["xcrun", "--sdk", sdk, "--show-sdk-path"])
                 boost_arch = "x86" if arch == "x86_64" else "arm"
                 with open("project-config.jam", "w", encoding="utf-8") as f:
@@ -1057,6 +1121,21 @@ def install_android_sdk_cmdline_tools(version, install_dir, source_dir):
     cmd(["/bin/bash", "-c", f"yes | {sdkmanager} --sdk_root={tools_dir} --licenses"])
 
 
+@versioned
+def install_android_sdk_platform_tools(version, install_dir, source_dir, platform):
+    if version not in ("latest",):
+        raise Exception(f"Supports only 'latest' version, but got: {version}")
+    if platform not in ("windows", "darwin", "linux"):
+        raise Exception(f"Not supported platform: {platform}")
+    archive = download(
+        f"https://dl.google.com/android/repository/platform-tools-{version}-{platform}.zip",
+        source_dir,
+    )
+    tools_dir = os.path.join(install_dir, "android-sdk-platform-tools")
+    rm_rf(tools_dir)
+    extract(archive, output_dir=tools_dir, output_dirname="platform-tools")
+
+
 @versioned
 def install_llvm(
     version,
@@ -1408,22 +1487,24 @@ def install_blend2d_official(
     source_dir,
     build_dir,
     install_dir,
-    ios,
     cmake_args,
+    expected_sha256: Optional[str] = None,
 ):
     rm_rf(os.path.join(source_dir, "blend2d"))
     rm_rf(os.path.join(build_dir, "blend2d"))
     rm_rf(os.path.join(install_dir, "blend2d"))
 
-    url = f"https://blend2d.com/download/blend2d-{version}.tar.gz"
-    path = download(url, source_dir)
+    # 公式サイトに負荷をかけないための時雨堂によるミラー
+    url = f"https://oss-mirrors.shiguredo.jp/blend2d-{version}.tar.gz"
+    # Blend2d 公式
+    # url = f"https://blend2d.com/download/blend2d-{version}.tar.gz"
+    path = download(url, source_dir, expected_sha256=expected_sha256)
     extract(path, source_dir, "blend2d")
     _build_blend2d(
         configuration=configuration,
         source_dir=source_dir,
         build_dir=build_dir,
         install_dir=install_dir,
-        ios=ios,
         cmake_args=cmake_args,
     )
 
@@ -1437,7 +1518,6 @@ def install_blend2d(
     install_dir,
     blend2d_version,
     asmjit_version,
-    ios,
     cmake_args,
 ):
     rm_rf(os.path.join(source_dir, "blend2d"))
@@ -1458,12 +1538,11 @@ def install_blend2d(
         source_dir=source_dir,
         build_dir=build_dir,
         install_dir=install_dir,
-        ios=ios,
         cmake_args=cmake_args,
     )
 
 
-def _build_blend2d(configuration, source_dir, build_dir, install_dir, ios, cmake_args):
+def _build_blend2d(configuration, source_dir, build_dir, install_dir, cmake_args):
     mkdir_p(os.path.join(build_dir, "blend2d"))
     with cd(os.path.join(build_dir, "blend2d")):
         cmd(
@@ -1481,37 +1560,17 @@ def _build_blend2d(configuration, source_dir, build_dir, install_dir, ios, cmake
         if os.path.exists(project_path):
             replace_vcproj_static_runtime(project_path)
 
-        if ios:
-            cmd(
-                [
-                    "cmake",
-                    "--build",
-                    ".",
-                    f"-j{multiprocessing.cpu_count()}",
-                    "--config",
-                    configuration,
-                    "--target",
-                    "blend2d",
-                    "--",
-                    "-arch",
-                    "arm64",
-                    "-sdk",
-                    "iphoneos",
-                ]
-            )
-            cmd(["cmake", "--build", ".", "--target", "install", "--config", configuration])
-        else:
-            cmd(
-                [
-                    "cmake",
-                    "--build",
-                    ".",
-                    f"-j{multiprocessing.cpu_count()}",
-                    "--config",
-                    configuration,
-                ]
-            )
-            cmd(["cmake", "--build", ".", "--target", "install", "--config", configuration])
+        cmd(
+            [
+                "cmake",
+                "--build",
+                ".",
+                f"-j{multiprocessing.cpu_count()}",
+                "--config",
+                configuration,
+            ]
+        )
+        cmd(["cmake", "--build", ".", "--target", "install", "--config", configuration])
 
 
 @versioned
@@ -2223,21 +2282,33 @@ def fix_clang_version(clang_dir, clang_version):
 
 
 class Platform(object):
-    def _check(self, flag):
+    def _check(self, flag, error_message):
         if not flag:
-            raise Exception("Not supported")
+            raise Exception(error_message)
 
     def _check_platform_target(self, p: PlatformTarget):
         if p.os == "raspberry-pi-os":
-            self._check(p.arch in ("armv6", "armv7", "armv8"))
+            self._check(
+                p.arch in ("armv6", "armv7", "armv8"),
+                f"Architecture {p.arch} is not supported for {p.os}. Supported: armv6, armv7, armv8",
+            )
         elif p.os == "jetson":
-            self._check(p.arch == "armv8")
+            self._check(
+                p.arch == "armv8",
+                f"Architecture {p.arch} is not supported for {p.os}. Only armv8 is supported",
+            )
         elif p.os in ("ios", "android"):
-            self._check(p.arch is None)
+            self._check(p.arch is None, f"Architecture should be None for {p.os}, but got {p.arch}")
         elif p.os == "ubuntu":
-            self._check(p.arch in ("x86_64", "armv8"))
+            self._check(
+                p.arch in ("x86_64", "armv8"),
+                f"Architecture {p.arch} is not supported for {p.os}. Supported: x86_64, armv8",
+            )
         else:
-            self._check(p.arch in ("x86_64", "arm64", "hololens2"))
+            self._check(
+                p.arch in ("x86_64", "arm64", "hololens2"),
+                f"Architecture {p.arch} is not supported for {p.os}. Supported: x86_64, arm64, hololens2",
+            )
 
     def __init__(self, target_os, target_osver, target_arch, target_extra=None):
         build = get_build_platform()
@@ -2247,32 +2318,83 @@ class Platform(object):
         self._check_platform_target(target)
 
         if target.os == "windows":
-            self._check(target.arch in ("x86_64", "arm64", "hololens2"))
-            self._check(build.os == "windows")
-            self._check(build.arch == "x86_64")
+            self._check(
+                target.arch in ("x86_64", "arm64", "hololens2"),
+                f"Target architecture {target.arch} is not supported for Windows",
+            )
+            self._check(
+                build.os == "windows",
+                f"Windows target requires Windows build platform, but got {build.os}",
+            )
+            self._check(
+                build.arch == "x86_64",
+                f"Windows build requires x86_64 architecture, but got {build.arch}",
+            )
         if target.os == "macos":
-            self._check(build.os == "macos")
-            self._check(build.arch in ("x86_64", "arm64"))
+            self._check(
+                build.os == "macos",
+                f"macOS target requires macOS build platform, but got {build.os}",
+            )
+            self._check(
+                build.arch in ("x86_64", "arm64"),
+                f"macOS build requires x86_64 or arm64, but got {build.arch}",
+            )
         if target.os == "ios":
-            self._check(build.os == "macos")
-            self._check(build.arch in ("x86_64", "arm64"))
+            self._check(
+                build.os == "macos", f"iOS target requires macOS build platform, but got {build.os}"
+            )
+            self._check(
+                build.arch in ("x86_64", "arm64"),
+                f"iOS build requires x86_64 or arm64, but got {build.arch}",
+            )
         if target.os == "android":
-            self._check(build.os in ("ubuntu", "macos"))
+            self._check(
+                build.os in ("ubuntu", "macos"),
+                f"Android target requires Ubuntu or macOS build platform, but got {build.os}",
+            )
             if build.os == "ubuntu":
-                self._check(build.arch == "x86_64")
+                self._check(
+                    build.arch == "x86_64",
+                    f"Android build on Ubuntu requires x86_64, but got {build.arch}",
+                )
             elif build.os == "macos":
-                self._check(build.arch in ("x86_64", "arm64"))
+                self._check(
+                    build.arch in ("x86_64", "arm64"),
+                    f"Android build on macOS requires x86_64 or arm64, but got {build.arch}",
+                )
         if target.os == "ubuntu":
-            self._check(build.os == "ubuntu")
-            self._check(build.arch in ("x86_64", "armv8"))
+            self._check(
+                build.os == "ubuntu",
+                f"Ubuntu target requires Ubuntu build platform, but got {build.os}",
+            )
+            self._check(
+                build.arch in ("x86_64", "armv8"),
+                f"Ubuntu build requires x86_64 or armv8, but got {build.arch}",
+            )
             if build.arch == target.arch:
-                self._check(build.osver == target.osver)
+                self._check(
+                    build.osver == target.osver,
+                    f"When building for the same architecture ({build.arch}), OS versions must match. "
+                    f"Build OS: Ubuntu {build.osver}, Target OS: Ubuntu {target.osver}. "
+                    f"This typically happens when GitHub Actions runner OS version doesn't match the target.",
+                )
         if target.os == "raspberry-pi-os":
-            self._check(build.os == "ubuntu")
-            self._check(build.arch == "x86_64")
+            self._check(
+                build.os == "ubuntu",
+                f"Raspberry Pi OS target requires Ubuntu build platform, but got {build.os}",
+            )
+            self._check(
+                build.arch == "x86_64",
+                f"Raspberry Pi OS build requires x86_64, but got {build.arch}",
+            )
         if target.os == "jetson":
-            self._check(build.os == "ubuntu")
-            self._check(build.arch == "x86_64")
+            self._check(
+                build.os == "ubuntu",
+                f"Jetson target requires Ubuntu build platform, but got {build.os}",
+            )
+            self._check(
+                build.arch == "x86_64", f"Jetson build requires x86_64, but got {build.arch}"
+            )
 
         self.build = build
         self.target = target

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/pyproject.toml

@@ -23,20 +23,14 @@ Discord = "https://discord.gg/shiguredo"
 requires = ["setuptools==80.9", "wheel==0.45.1"]
 build-backend = "setuptools.build_meta"
 
+[dependency-groups]
+dev = ["nanobind==2.9.2", "setuptools==80.9.0", "ruff", "ty"]
+test = ["pytest", "pytest-repeat", "pytest-xdist", "numpy", "httpx", "pyjwt"]
+lint = ["ruff", "ty"]
+
 [tool.uv]
 python-preference = "only-managed"
-dev-dependencies = [
-    "nanobind==2.9.2",
-    "setuptools==80.9.0",
-    "pytest",
-    "pytest-repeat",
-    "pytest-xdist",
-    "numpy",
-    "httpx",
-    "pyjwt",
-    "ruff",
-    "ty",
-]
+default-groups = ["dev", "test", "lint"]
 
 [tool.ruff]
 target-version = "py311"

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/run.py

@@ -51,10 +51,11 @@ def install_deps(
     version = read_version_file("DEPS")
 
     # multistrap を使った sysroot の構築
-    if (
-        platform.target.os == "jetson"
-        or platform.target.os == "ubuntu"
-        and platform.target.arch == "armv8"
+    if platform.target.package_name in (
+        "ubuntu-22.04_armv8_jetson",
+        "raspberry-pi-os_armv8",
+        "ubuntu-22.04_armv8",
+        "ubuntu-24.04_armv8",
     ):
         conf = os.path.join("multistrap", f"{platform.target.package_name}.conf")
         # conf ファイルのハッシュ値をバージョンとする
@@ -90,7 +91,9 @@ def install_deps(
     webrtc_info = get_webrtc_info(webrtc_platform, local_webrtc_build_dir, install_dir, debug)
     webrtc_version = read_version_file(webrtc_info.version_file)
 
-    if platform.build.os == "ubuntu" and local_webrtc_build_dir is None:
+    if (
+        platform.build.os == "macos" or platform.build.os == "ubuntu"
+    ) and local_webrtc_build_dir is None:
         # LLVM
         tools_url = webrtc_version["WEBRTC_SRC_TOOLS_URL"]
         tools_commit = webrtc_version["WEBRTC_SRC_TOOLS_COMMIT"]
@@ -178,6 +181,7 @@ AVAILABLE_TARGETS = [
     "ubuntu-22.04_armv8",
     "ubuntu-24.04_armv8",
     "ubuntu-22.04_armv8_jetson",
+    "raspberry-pi-os_armv8",
 ]
 
 
@@ -208,6 +212,8 @@ def _get_platform(target: str) -> Platform:
         platform = Platform("ubuntu", "24.04", "armv8")
     elif target == "ubuntu-22.04_armv8_jetson":
         platform = Platform("jetson", None, "armv8", "ubuntu-22.04")
+    elif target == "raspberry-pi-os_armv8":
+        platform = Platform("raspberry-pi-os", None, "armv8")
     else:
         raise Exception(f"Unknown target {target}")
     return platform
@@ -258,7 +264,11 @@ def _build(
         cmake_args = []
         cmake_args.append(f"-DCMAKE_BUILD_TYPE={configuration}")
         cmake_args.append(f"-DTARGET_OS={platform.target.os}")
-        cmake_args.append(f"-DSORA_PYTHON_SDK_VERSION={importlib.metadata.version('sora-sdk')}")
+        # Raspberry Pi OS の場合は sora-sdk-rpi パッケージからバージョンを取得する
+        if platform.target.os == "raspberry-pi-os":
+            cmake_args.append(f"-DSORA_PYTHON_SDK_VERSION={importlib.metadata.version('sora-sdk-rpi')}")
+        else:
+            cmake_args.append(f"-DSORA_PYTHON_SDK_VERSION={importlib.metadata.version('sora-sdk')}")
         cmake_args.append(f"-DBOOST_ROOT={cmake_path(sora_info.boost_install_dir)}")
         cmake_args.append(f"-DWEBRTC_INCLUDE_DIR={cmake_path(webrtc_info.webrtc_include_dir)}")
         cmake_args.append(f"-DWEBRTC_LIBRARY_DIR={cmake_path(webrtc_info.webrtc_library_dir)}")
@@ -310,11 +320,13 @@ def _build(
             cmake_args += [
                 "-DCMAKE_SYSTEM_PROCESSOR=arm64",
                 "-DCMAKE_OSX_ARCHITECTURES=arm64",
-                "-DCMAKE_C_COMPILER=clang",
+                f"-DCMAKE_C_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang')}",
                 "-DCMAKE_C_COMPILER_TARGET=aarch64-apple-darwin",
-                "-DCMAKE_CXX_COMPILER=clang++",
+                f"-DCMAKE_CXX_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang++')}",
                 "-DCMAKE_CXX_COMPILER_TARGET=aarch64-apple-darwin",
                 f"-DCMAKE_SYSROOT={sysroot}",
+                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'))}",
             ]
         elif platform.target.os == "jetson":
             sysroot = os.path.join(install_dir, "rootfs")
@@ -332,9 +344,30 @@ def _build(
                 "-DCMAKE_FIND_ROOT_PATH_MODE_PACKAGE=BOTH",
                 f"-DCMAKE_SYSROOT={sysroot}",
                 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'))}",
                 f"-DPython_ROOT_DIR={cmake_path(os.path.join(sysroot, 'usr', 'include', 'python3.10'))}",
                 "-DNB_SUFFIX=.cpython-310-aarch64-linux-gnu.so",
             ]
+        elif platform.target.os == "raspberry-pi-os":
+            sysroot = os.path.join(install_dir, "rootfs")
+            cmake_args += [
+                "-DCMAKE_SYSTEM_NAME=Linux",
+                "-DCMAKE_SYSTEM_PROCESSOR=aarch64",
+                f"-DCMAKE_C_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang')}",
+                "-DCMAKE_C_COMPILER_TARGET=aarch64-linux-gnu",
+                f"-DCMAKE_CXX_COMPILER={os.path.join(webrtc_info.clang_dir, 'bin', 'clang++')}",
+                "-DCMAKE_CXX_COMPILER_TARGET=aarch64-linux-gnu",
+                f"-DCMAKE_FIND_ROOT_PATH={sysroot}",
+                "-DCMAKE_FIND_ROOT_PATH_MODE_PROGRAM=NEVER",
+                "-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"-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'))}",
+                f"-DPython_ROOT_DIR={cmake_path(os.path.join(sysroot, 'usr', 'include', 'python3.11'))}",
+                "-DNB_SUFFIX=.cpython-311-aarch64-linux-gnu.so",
+            ]
 
         # Windows 以外の、クロスコンパイルでない環境では pyi ファイルを生成する
         if (
@@ -382,6 +415,11 @@ def _build(
                     os.path.join(sora_build_target_dir, file), os.path.join(sora_src_dir, file)
                 )
 
+        if platform.target.os == "raspberry-pi-os":
+            # libcamerac.so を sora_sdk_ext.*.so と同じディレクトリにコピーする
+            libcamerac_so = os.path.join(sora_info.sora_install_dir, "lib", "libcamerac.so")
+            shutil.copyfile(libcamerac_so, os.path.join(sora_src_dir, "libcamerac.so"))
+
 
 def _format(
     clang_format_path: Optional[str] = None,

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/setup.py

@@ -21,6 +21,7 @@ def run_setup(build_platform, target_platform):
         version += "+debug"
 
     plat = None
+    additional_files = []
     if target_platform.os == "jetson":
         plat = "manylinux_2_17_aarch64.manylinux2014_aarch64"
     elif target_platform.os == "ubuntu" and target_platform.arch == "armv8":
@@ -33,6 +34,9 @@ def run_setup(build_platform, target_platform):
             plat = "manylinux_2_31_x86_64"
         if target_platform.osver == "24.04":
             plat = "manylinux_2_35_x86_64"
+    elif target_platform.os == "raspberry-pi-os":
+        plat = "manylinux_2_35_aarch64"
+        additional_files += ["libcamerac.so"]
 
     class bdist_wheel(_bdist_wheel):
         def finalize_options(self):
@@ -50,7 +54,7 @@ def run_setup(build_platform, target_platform):
         packages=["sora_sdk"],
         package_dir={"": "src"},
         package_data={
-            "sora_sdk": ["sora_sdk_ext.*"],
+            "sora_sdk": ["sora_sdk_ext.*", *additional_files],
         },
         include_package_data=True,
         cmdclass={
@@ -71,6 +75,8 @@ def main():
         target_platform = PlatformTarget("ubuntu", "24.04", "armv8")
     elif target == "ubuntu-22.04_armv8_jetson":
         target_platform = PlatformTarget("jetson", None, "armv8", "ubuntu-22.04")
+    elif target == "raspberry-pi-os_armv8":
+        target_platform = PlatformTarget("raspberry-pi-os", None, "armv8")
     else:
         raise Exception(f"Unknown target {target}")
 

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/src/sora_sdk/sora_sdk_ext.pyi

@@ -370,6 +370,8 @@ class SoraVideoCodecImplementation(enum.IntEnum):
 
     AMD_AMF = 4
 
+    RASPI_V4L2M2M = 5
+
 class SoraVideoCodecType(enum.IntEnum):
     VP8 = 1
 
@@ -490,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.dev6 → sora_sdk-2025.5.0.dev1/src/sora_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sora_sdk
-Version: 2025.4.0.dev6
+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.4.0.dev6 → sora_sdk-2025.5.0.dev1}/src/sora_sdk.egg-info/SOURCES.txt

@@ -27,7 +27,7 @@ tests/test_intel_vpl.py
 tests/test_key_frame_request.py
 tests/test_messaging.py
 tests/test_messaging_header.py
-tests/test_nvidia_video_codec_sdk.py
+tests/test_nvidia_video_codec.py
 tests/test_openh264.py
 tests/test_openh264_simulcast.py
 tests/test_opus.py

{sora_sdk-2025.4.0.dev6 → sora_sdk-2025.5.0.dev1}/tests/test_intel_vpl.py

@@ -602,6 +602,6 @@ def test_intel_vpl_av1_rtp_hdr_ext(settings):
     sendonly.disconnect()
 
     # AV1 の RTP ヘッダー拡張が送られてきていることを確認
-    assert (
-        stats["rtp_hdrext"]["total_received_rtp_hdrext_av1_rtp_sepc"] > 0
-    ), "Dependency Descriptor RTP Header Extension が Python SDK から送られてきていません"
+    assert stats["rtp_hdrext"]["total_received_rtp_hdrext_av1_rtp_sepc"] > 0, (
+        "Dependency Descriptor RTP Header Extension が Python SDK から送られてきていません"
+    )

sora_sdk-2025.4.0.dev6/tests/test_nvidia_video_codec_sdk.py → sora_sdk-2025.5.0.dev1/tests/test_nvidia_video_codec.py

@@ -18,7 +18,7 @@ from sora_sdk import (
 )
 
 pytestmark = pytest.mark.skipif(
-    os.environ.get("NVIDIA_VIDEO_CODEC_SDK") is None, reason="NVIDIA Video Codec SDK でのみ実行する"
+    os.environ.get("NVIDIA_VIDEO_CODEC") is None, reason="NVIDIA Video Codec でのみ実行する"
 )
 
 

sora_sdk-2025.4.0.dev6/VERSION

@@ -1 +0,0 @@
-2025.4.0.dev6