Merge branch 'release/2025.3.0'

Author: zztkm

.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    allow:
+      - dependency-name: "actions/checkout"
+      - dependency-name: "actions/setup-java"
+      - dependency-name: "rtCamp/action-slack-notify"
+      - dependency-name: "anthropics/claude-code-action"
+      - dependency-name: "shiguredo/github-actions"

.github/workflows/build.yml

@@ -6,8 +6,16 @@ on:
     paths-ignore:
       - 'README.md'
       - 'CHANGES.md'
+      - 'CLAUDE.md'
       - 'LICENSE'
       - 'THANKS'
+      - '.github/workflows/claude.yml'
+      - '.github/copilot-instructions.md'
+      - 'sora-android-sdk/packages.md'
+      - 'docs/**'
+      - 'jitpack.yml'
+      - 'canary.py'
+      - '.gitignore'
 
 jobs:
   build:
@@ -17,7 +25,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
       - name: Set up JDK
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: 'temurin'
           # java-version を 17 にしている理由は以下です

.github/workflows/claude.yml

@@ -13,48 +13,17 @@ permissions:
   actions: read
 
 env:
-  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY_SORA_OSS_SONNET }}
+  CLAUDE_API_KEY: ${{ secrets.ANTHROPIC_API_KEY_SORA_OSS_SONNET }}
+  CLAUDE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN_VOLUNTAS }}
 
 jobs:
-  claude-opus-response-voluntas:
-    if: github.event.comment.user.login == 'voluntas'
+  claude-response:
     runs-on: ubuntu-24.04
-    timeout-minutes: 20
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@v5
-      - uses: anthropics/claude-code-action@beta
+      - uses: shiguredo/github-actions/.github/actions/claude-code-action@main
         with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN_VOLUNTAS }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          model: "claude-opus-4-20250514"
-          trigger_phrase: "!opus"
-          timeout_minutes: 15
-          disallowed_tools: "Bash(git:*)"
-
-  check-permission:
-    if: github.event.comment.user.login != 'voluntas'
-    runs-on: ubuntu-24.04
-    outputs:
-      has_permission: ${{ steps.check.outputs.has-permission }}
-    steps:
-      - uses: actions/checkout@v5
-      - id: check
-        uses: shiguredo/github-actions/.github/actions/check-write-permission@main
-        with:
-          username: ${{ github.event.comment.user.login }}
-
-  claude-sonnet-response-others:
-    needs: check-permission
-    if: needs.check-permission.outputs.has_permission == 'true'
-    runs-on: ubuntu-24.04
-    timeout-minutes: 20
-    steps:
-      - uses: actions/checkout@v5
-      - uses: anthropics/claude-code-action@beta
-        with:
-          anthropic_api_key: ${{ env.ANTHROPIC_API_KEY }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          model: "claude-sonnet-4-20250514"
-          trigger_phrase: "!sonnet"
-          timeout_minutes: 15
-          disallowed_tools: "Bash(git:*)"
+          api_key: ${{ env.CLAUDE_API_KEY }}
+          oauth_user: voluntas
+          oauth_token: ${{ env.CLAUDE_OAUTH_TOKEN }}

CHANGES.md

@@ -11,6 +11,66 @@
 
 ## develop
 
+## 2025.3.0
+
+**リリース日**: 2025-11-11
+
+- [UPDATE] libwebrtc を 142.7444.2.1 に上げる
+  - @t-miya @zztkm
+- [UPDATE] Kotlin バージョンを 2.0.20 に上げる
+  - @t-miya
+- [ADD] マイク録音の一時停止／再開機能を追加する
+  - 配信中に AudioDeviceModule の録音を停止することで、Android 実機のマイクインジケータを消灯させることを可能にする
+  - AudioDeviceModuleWrapper クラスを追加する
+    - JavaAudioDeviceModule を対象とした録音停止/再開のラッパークラス
+    - 専用の HandlerThread 上で suspend 関数として pauseRecording() / resumeRecording() を提供する
+    - アプリ側でカスタム ADM を差し込む場合は AudioDeviceModuleWrapper は利用されない
+  - SoraMediaChannel に以下のメソッドを追加する
+    - suspend fun setAudioRecordingPaused(paused: Boolean): Boolean
+      - 録音の一時停止/再開を非同期で実行する
+      - 内部では PeerChannel 経由で AudioDeviceModuleWrapper の pauseRecording()/resumeRecording() が呼ばれる
+      - AudioDeviceModule の制御に加え、ローカル AudioTrack の無効化/有効化も併せて行う
+    - fun isAudioRecordingPaused(): Boolean
+      - 現在の録音停止状態を返す
+  - @t-miya
+- [ADD] AudioTrack から音声データを受け取るためのコールバックインターフェースである AudioTrackSink を追加する
+  - この機能を利用すると AudioTrack ごとにコールバックから音声データを取得できる
+  - @zztkm
+- [ADD] AudioTrack に AudioTrackSink と関連付けるためのメソッドを追加する
+  - addSink
+    - AudioTrack と AudioTrackSink を関連付けるためのメソッド
+  - removeSink
+    - AudioTrack と AudioTrackSink の関連付けを解除するためのメソッド
+  - @zztkm
+
+### misc
+
+- [UPDATE] ktlint バージョンを上げる
+  - ktlint を 1.7.1 に上げる
+  - ktlint-gradle を 13.1.0 に上げる
+  - @t-miya
+- [UPDATE] Android Gradle Plugin バージョンを 8.11.1 に上げる
+  - @t-miya
+- [UPDATE] grgit が git worktree のディレクトリでは使えないことが判明したため、`BuildConfig.REVISION` を取得する方法を grgit から git コマンドに移行する
+  - Sora Android SDK ではコミットハッシュを取得するためだけに Grgit を利用しており、git コマンドの利用で十分であると判断した
+  - @zztkm
+- [UPDATE] build.yml の実行除外対象を追加する
+  - paths-ignore に以下を追加
+    - 'CLAUDE.md'
+    - '.github/workflows/claude.yml'
+    - '.github/copilot-instructions.md'
+    - 'sora-android-sdk/packages.md'
+    - 'docs/**'
+    - 'jitpack.yml'
+    - 'canary.py'
+    - '.gitignore'
+- [UPDATE] canary.py の SDKInfo.kt の `version` 変数名を `VERSION` に変更する
+  - ktlint バージョンアップにより命名規則のチェックが厳格になった
+  - @zztkm
+- [UPDATE] システム条件を更新する
+  - Android Studio 2025.2.1 以降
+  - @zztkm
+
 ## 2025.2.0
 
 **リリース日**: 2025-09-17
@@ -99,7 +159,7 @@
   - @zztkm
 - [ADD] `SoraMediaOption` に `DegradationPreference` を追加
   - クライアント側の状況により設定した解像度やフレームレートを維持できなくなった場合にどのように質を下げるか制御できるパラメータとして `SoraMediaOption.degradationPreference` を追加した
-  - `degradationPreference` の設定は必須ではなく、未指定の場合は libwebrtc デフォルトの挙動として `BALANCED` が適用される
+  - `degradationPreference` の設定は必須ではなく、未指定の場合は libwebrtc デフォルトの挙動として `MAINTAIN_FRAMERATE` が適用される
   - @t-miya
 - [ADD] サイマルキャストの映像のエンコーディングパラメーター `scaleResolutionDownTo` を追加する
   - @zztkm
@@ -109,14 +169,19 @@
   - サイマルキャスト有効時も SW のみ構成に切り替える
   - `videoEncoderFactory` を明示設定している場合は本オプションは無視される
   - @zztkm
-
 - [FIX] `SoraMediaChannel.internalDisconnect` での `SoraMediaChannel.Listener.onClose` の呼び出しタイミングを切断処理がすべて完了したあとに修正する
   - 切断処理が終了する前に `onClose` を呼び出していたため、切断処理が完了してから呼び出すように修正
   - `contactSignalingEndpoint` と `connectedSignalingEndpoint` は onClose で参照される可能性があるため、onClose 実行よりあとに null になるように onClose に合わせて処理順を変更
   - @zztkm
 
 ### misc
 
+- [CHANGE] Gradle を Kotlin DSL 移行する
+  - build.gradle、settings.gradle、sora-android-sdk/build.gradle それぞれを Kotlin DSL(.kts) に移行
+  - @t-miya
+- [CHANGE] 依存ライブラリバージョンの管理をバージョンカタログに移行する
+  - gradle/libs.versions.toml を追加
+  - @t-miya
 - [UPDATE] actions/checkout@v4 を actions/checkout@v5 に上げる
   - @torikizi
 

README.md

@@ -1,7 +1,7 @@
 # Sora Android SDK
 
 [![Release](https://jitpack.io/v/shiguredo/sora-android-sdk.svg)](https://jitpack.io/#shiguredo/sora-android-sdk)
-[![libwebrtc](https://img.shields.io/badge/libwebrtc-138.7204-blue.svg)](https://chromium.googlesource.com/external/webrtc/+/branch-heads/7204)
+[![libwebrtc](https://img.shields.io/badge/libwebrtc-142.7444-blue.svg)](https://chromium.googlesource.com/external/webrtc/+/branch-heads/7444)
 [![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/shiguredo/sora-android-sdk.svg)](https://github.com/shiguredo/sora-android-sdk.svg)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
@@ -21,7 +21,7 @@ Please read https://github.com/shiguredo/oss before use.
 ## システム条件
 
 - Android 5 以降 (エミュレーターでの動作は保証しません)
-- Android Studio 2025.1.1 以降
+- Android Studio 2025.2.1 以降
 - WebRTC SFU Sora 2025.1.0 以降
 
 ## サンプル

build.gradle

@@ -0,0 +1,41 @@
+plugins {
+    alias(libs.plugins.versions)
+    alias(libs.plugins.dokka)
+    alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.android.library) apply false
+    alias(libs.plugins.kotlin.android) apply false
+    alias(libs.plugins.android.maven) apply false
+    alias(libs.plugins.ktlint) apply false
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven("https://jitpack.io")
+    }
+}
+
+tasks.register<Delete>("clean") {
+    delete(rootProject.layout.buildDirectory)
+}
+
+// 不安定バージョンを除外する設定
+fun isNonStable(version: String): Boolean {
+    val qualifiers = listOf("alpha", "beta", "rc", "M")
+    return qualifiers.any { qualifier ->
+        version.matches(Regex("(?i).*[.-]$qualifier[.\\d-]*"))
+    }
+}
+
+tasks.withType<com.github.benmanes.gradle.versions.updates.DependencyUpdatesTask> {
+    resolutionStrategy {
+        componentSelection {
+            all {
+                if (isNonStable(candidate.version)) {
+                    reject("Release candidate")
+                }
+            }
+        }
+    }
+}

build.gradle.kts

@@ -25,10 +25,10 @@ def update_sdkinfo_version(packageinfo_content):
 
     for line in packageinfo_content:
         line = line.rstrip()  # 末尾の改行のみを削除
-        if "const val version" in line:
+        if "const val VERSION" in line:
             # バージョン行のパターンマッチング
             version_match = re.match(
-                r'\s*const\s+val\s+version\s*=\s*[\'"](\d+\.\d+\.\d+)(-canary\.(\d+))?[\'"]',
+                r'\s*const\s+val\s+VERSION\s*=\s*[\'"](\d+\.\d+\.\d+)(-canary\.(\d+))?[\'"]',
                 line,
             )
             if version_match:
@@ -43,7 +43,7 @@ def update_sdkinfo_version(packageinfo_content):
                     new_version = f"{major_minor_patch}-canary.{canary_number + 1}"
 
                 # SDKInfoのバージョン行を更新
-                updated_content.append(f'        const val version = "{new_version}"')
+                updated_content.append(f'        const val VERSION = "{new_version}"')
                 sdk_version_updated = True
             else:
                 updated_content.append(line)

canary.py

@@ -0,0 +1,52 @@
+# 録音一時停止／再開のロールバック設計
+
+この文書では、`PeerChannelImpl` に実装されている録音一時停止／再開機構の流れと、各段階でのロールバック方法をまとめます。主な対象は `AudioDeviceModuleWrapper` とローカル音声トラック周りの防御的な処理です。
+
+## 関係クラス
+
+- `PeerChannelImpl`
+  - `setAudioRecordingPaused`
+  - `pauseAudioRecording`
+  - `resumeAudioRecording`
+  - `resumeWithExistingAudioTrack`
+  - `resumeWithReinitializedAudioTrack`
+- `AudioDeviceModuleWrapper`
+  - `pauseRecording`
+  - `resumeRecording`
+
+`AudioDeviceModuleWrapper` は `JavaAudioDeviceModule` を想定したラッパーで、専用の `HandlerThread` 上で pause/resume を実行し、最大 3,000 ミリ秒まで結果を待機します。アプリがカスタム ADM を差し込む場合はラッパーが生成されないため、録音停止／再開は利用できません。(RTCComponentFactory.kt 内の `AudioDeviceModule` セット処理参照)。
+また、アクセサを internal としており、外部からは直接 pause/resume を実行できないようにしています。
+
+## 一時停止 (`pauseAudioRecording`)
+
+1. `componentFactory.hasControllableAdm()` で `AudioDeviceModuleWrapper` が生成済みか確認し、未生成なら `false` を返す。
+2. `componentFactory.pauseControllableAdm()` を呼び出す。失敗またはタイムアウトで `false` が返った場合はロールバック不要のまま終了。
+3. ローカル音声トラック (`localAudioManager.track`) が存在すれば `setLocalAudioTrackEnabled(track, false)` で無効化する。
+   - 失敗時（例外など）は ADM の `resumeRecording()` を呼び出してロールバックし、結果をログに残して `false` を返す。
+4. すべて成功した場合は `audioRecordingPaused = true` とし、`true` を返す。
+
+### 例外安全性
+
+- ADM の pause に失敗した場合は即座に処理を終了するため、後続の状態変更は発生しません。
+- トラックの無効化に失敗した場合のみ ADM の `resumeRecording()` を呼び出して元の状態に戻します。
+
+## 再開 (`resumeAudioRecording`)
+
+1. `componentFactory.hasControllableAdm()` が `false` の場合は録音再開を行わず `false` を返す。
+2. `componentFactory.resumeControllableAdm()` を呼び出す。失敗またはタイムアウト時は即終了。
+3. ローカル音声トラックの再開処理を `resumeWithExistingAudioTrack()` で試みる。
+   - トラックが存在し、`setEnabled(true)` と `audioSender.setTrack` / `updateAudioSenderTrack` が成功すれば `SUCCESS`。
+   - 失敗した場合は `FAILURE`、トラックが存在しなければ `NEEDS_REINITIALIZATION` を返す。
+4. `NEEDS_REINITIALIZATION` の場合は `resumeWithReinitializedAudioTrack()` でトラックを再生成し、再度 sender へアタッチする。
+   - ここでも失敗した場合は `FAILURE`。
+5. 再開処理の結果が `SUCCESS` 以外だった場合は `componentFactory.pauseControllableAdm()` で ADM をロールバックし、`false` を返す。
+6. 成功時は `audioRecordingPaused = false` として `true` を返す。
+
+### 例外安全性
+
+- トラック再開処理全体を `try/catch` で囲み、例外発生時には `FAILURE` として扱います。
+- 任意のフェーズで失敗した場合は必ず ADM を `pauseRecording()` してロールバックするため、録音が再開しない（=マイクインジケータが消灯したまま）状況を防ぎます。
+
+## ログとデバッグ
+
+すべてのフェーズで `SoraLogger` による詳細なログを出しており、`[audio_recording_pause]` プレフィックスで検索するとロールバックシーケンスを追跡できます。失敗理由は `Exception` のメッセージとともに記録されるため、実機デバッグ時にどの段階で復旧が行われたかを確認できます。