コメント修正

Author: t-miya

CHANGES.md

@@ -21,15 +21,16 @@
   - @zztkm
 - [ADD] MediaChannel に音声ソフトミュートを設定する `setAudioSoftMute(_:)` を追加する
   - 送信ストリームの AudioTrack を取得し、MediaStream.audioEnabled を切り替える
-  - AudioTrack の有無判定を行うため、 MediaStream に `hasAudioTrack` を追加する
+    - デジタルサイレンスパケットが送られる状態となり、マイクからの音声は送出されない
+  - MediaChannel から AudioTrack の有無判定を行うため、 MediaStream に `hasAudioTrack` を追加する
   - @t-miya
 - [ADD] MediaChannel に映像ソフトミュートを設定する `setVideoSoftMute(_:)` を追加する
   - 送信ストリームの VideoTrack を取得し、MediaStream.videoEnabled を切り替える
-  - VideoTrack の有無判定を行うため、 MediaStream に `hasVideoTrack` を追加する
+  - MediaChannel から VideoTrack の有無判定を行うため、 MediaStream に `hasVideoTrack` を追加する
   - @t-miya
 - [ADD] MediaChannel に映像ハードミュートを設定する `setVideoHardMute(_:)` を追加する
   - CameraVideoCapturer の `stop` と `restart` のラッパー
-    - ハードミュートの複数同時実行を防ぐためにシリアルキュー `VideoHardMuteSerialQueue` を追加する
+    - ハードミュートの複数同時実行を防ぐためのシリアルキュークラス `VideoHardMuteSerialQueue` を追加する
   - 映像ソフトミュートも併用し、黒塗りフレームの状態で停止させる
   - @t-miya
 - [ADD] 音声のハードミュート有効化/無効化機能を追加する

Sora/MediaChannel.swift

@@ -745,7 +745,7 @@ public final class MediaChannel {
       return SoraError.mediaChannelError(reason: "senderStream has no VideoTrack")
     }
 
-    // ローカル音声トラックの有効/無効を切り替えます
+    // ローカル映像トラックの有効/無効を切り替えます
     senderStream.videoEnabled = !mute
     Logger.debug(type: .mediaChannel, message: "setVideoSoftMute mute=\(mute)")
     return nil

Sora/VideoMute.swift

@@ -2,8 +2,6 @@ import Foundation
 
 // 映像ハードミュートの同時呼び出しを防ぐためのシリアルキュークラスです
 // MediaChannel.setVideoHardMute(_:) 内での使用を想定しています
-//
-// 既に処理が実行中または CameraVideoCapturer が無効な場合は `SoraError.mediaChannelError` がスローされます
 final class VideoHardMuteSerialQueue {
   private let queue = DispatchQueue(label: "jp.shiguredo.sora.video.hardmute")
 
@@ -13,10 +11,11 @@ final class VideoHardMuteSerialQueue {
 
   // queue 上で同時実行を防ぐ排他処理を行い、
   // libwebrtc のカメラ用キュー（SoraDispatcher）でカメラ操作を行います
+  //
+  // 既に処理中の状態で実行された、またはキャプチャラーが無効な場合は SoraError.mediaChannelError がスローされます
   func set(mute: Bool, senderStream: MediaStream) async throws {
     try await withCheckedThrowingContinuation { (continuation: CheckedContinuation<Void, Error>) in
       queue.async { [self] in
-        // 同時に呼び出された場合はエラーにします
         guard !isProcessing else {
           continuation.resume(
             throwing: SoraError.mediaChannelError(