Implement methods to mute audio track locally

Author: sierpinskid

Packages/StreamVideo/Runtime/Core/StatefulModels/Tracks/StreamAudioTrack.cs

@@ -13,6 +13,81 @@ public StreamAudioTrack(AudioStreamTrack track)
         {
 
         }
+        
+        /// <summary>
+        ///     Mutes this audio track locally without affecting other users.
+        /// </summary>
+        /// <remarks>
+        ///     `MuteLocally` mutes this audio track on the local device only. 
+        ///     Other users in the call will not be affected. This is useful for temporarily
+        ///     stopping playback of incoming audio without disconnecting the track.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         audioStreamTrack.MuteLocally();
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="UnmuteLocally"/>
+        /// <seealso cref="IsLocallyMuted"/>
+        public void MuteLocally()
+        {
+#if UNITY_ANDROID && !UNITY_EDITOR
+            Track.MuteLocally();
+#else
+            throw new NotSupportedException($"The {nameof(MuteLocally)} method is currently only supported on Android platform.");
+#endif
+        }
+
+        /// <summary>
+        ///     Unmutes this audio track locally.
+        /// </summary>
+        /// <remarks>
+        ///     `UnmuteLocally` unmutes a previously muted audio track on the local device.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         audioStreamTrack.UnmuteLocally();
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="MuteLocally"/>
+        /// <seealso cref="IsLocallyMuted"/>
+        public void UnmuteLocally()
+        {
+#if UNITY_ANDROID && !UNITY_EDITOR
+            Track.UnmuteLocally();
+#else
+            throw new NotSupportedException($"The {nameof(UnmuteLocally)} method is currently only supported on Android platform.");
+#endif
+        }
+
+        /// <summary>
+        ///     Checks if this audio track is locally muted.
+        /// </summary>
+        /// <remarks>
+        ///     `IsLocallyMuted` returns true if the track is currently muted on the local device.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <returns>True if the track is locally muted, false otherwise.</returns>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         if (audioStreamTrack.IsLocallyMuted())
+        ///         {
+        ///             Debug.Log("Track is muted locally");
+        ///         }
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="MuteLocally"/>
+        /// <seealso cref="UnmuteLocally"/>
+        public bool IsLocallyMuted()
+        {
+#if UNITY_ANDROID && !UNITY_EDITOR
+            return Track.IsLocallyMuted();
+#else
+            throw new NotSupportedException($"The {nameof(IsLocallyMuted)} method is currently only supported on Android platform.");
+#endif
+        }
 
         public void SetAudioSourceTarget(AudioSource audioSource)
         {

Packages/StreamVideo/Runtime/Libs/io.stream.unity.webrtc/Runtime/Scripts/AudioStreamTrack.cs

@@ -290,6 +290,80 @@ internal void RemoveSink(AudioStreamRenderer renderer)
                 GetSelfOrThrow(), renderer.self);
         }
 
+#if UNITY_ANDROID && !UNITY_EDITOR
+        /// <summary>
+        ///     Mutes this audio track locally without affecting other users.
+        /// </summary>
+        /// <remarks>
+        ///     `MuteLocally` mutes this audio track on the local device only. 
+        ///     Other users in the call will not be affected. This is useful for temporarily
+        ///     stopping playback of incoming audio without disconnecting the track.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         audioStreamTrack.MuteLocally();
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="UnmuteLocally"/>
+        /// <seealso cref="IsLocallyMuted"/>
+        public void MuteLocally()
+        {
+            if (_streamRenderer == null)
+                throw new InvalidOperationException("MuteLocally is only available for receiver side audio tracks.");
+            
+            NativeMethods.AudioTrackSinkMute(_streamRenderer.self);
+        }
+
+        /// <summary>
+        ///     Unmutes this audio track locally.
+        /// </summary>
+        /// <remarks>
+        ///     `UnmuteLocally` unmutes a previously muted audio track on the local device.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         audioStreamTrack.UnmuteLocally();
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="MuteLocally"/>
+        /// <seealso cref="IsLocallyMuted"/>
+        public void UnmuteLocally()
+        {
+            if (_streamRenderer == null)
+                throw new InvalidOperationException("UnmuteLocally is only available for receiver side audio tracks.");
+            
+            NativeMethods.AudioTrackSinkUnmute(_streamRenderer.self);
+        }
+
+        /// <summary>
+        ///     Checks if this audio track is locally muted.
+        /// </summary>
+        /// <remarks>
+        ///     `IsLocallyMuted` returns true if the track is currently muted on the local device.
+        ///     This method is only available on Android platform.
+        /// </remarks>
+        /// <returns>True if the track is locally muted, false otherwise.</returns>
+        /// <example>
+        ///     <code lang="cs"><![CDATA[
+        ///         if (audioStreamTrack.IsLocallyMuted())
+        ///         {
+        ///             Debug.Log("Track is muted locally");
+        ///         }
+        ///     ]]></code>
+        /// </example>
+        /// <seealso cref="MuteLocally"/>
+        /// <seealso cref="UnmuteLocally"/>
+        public bool IsLocallyMuted()
+        {
+            if (_streamRenderer == null)
+                throw new InvalidOperationException("IsLocallyMuted is only available for receiver side audio tracks.");
+            
+            return NativeMethods.AudioTrackSinkIsMuted(_streamRenderer.self);
+        }
+#endif
+
         /// <summary>
         ///     Disposes of AudioStreamTrack.
         /// </summary>

Packages/StreamVideo/Runtime/Libs/io.stream.unity.webrtc/Runtime/Scripts/WebRTC.cs

@@ -1736,6 +1736,15 @@ public static extern void RegisterDebugLog(DelegateDebugLog func, [MarshalAs(Unm
         [DllImport(WebRTC.Lib)]
         public static extern void AudioTrackSinkProcessAudio(
             IntPtr sink, float[] data, int length, int channels, int sampleRate);
+#if UNITY_ANDROID && !UNITY_EDITOR
+        [DllImport(WebRTC.Lib)]
+        public static extern void AudioTrackSinkMute(IntPtr sink);
+        [DllImport(WebRTC.Lib)]
+        public static extern void AudioTrackSinkUnmute(IntPtr sink);
+        [DllImport(WebRTC.Lib)]
+        [return: MarshalAs(UnmanagedType.U1)]
+        public static extern bool AudioTrackSinkIsMuted(IntPtr sink);
+#endif
         [DllImport(WebRTC.Lib)]
         [return: MarshalAs(UnmanagedType.U1)]
         public static extern bool MediaStreamAddTrack(IntPtr stream, IntPtr track);