feature: change playing sound property

2026-04-23 19:32:06 +08:00
parent e0ab4e4f7e
commit 769f5f3d2e
5 changed files with 242 additions and 43 deletions
@@ -179,6 +179,92 @@ namespace OCES.Audio
            this.m_sfxSystem.Stop(audioId);
        }

+        /// <summary>
+        /// 设置指定音频ID的音量
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        /// <param name="targetVolume">目标音量 (0.0 - 1.0)</param>
+        public void SetVolume(uint audioId, float targetVolume)
+        {
+            if (targetVolume is < 0 or > 1)
+            {
+                Debug.LogWarning($"[AudioSystem] Volume '{targetVolume}' is out of range [0, 1].");
+                return;
+            }
+            this.m_sfxSystem.SetVolume(audioId, targetVolume);
+        }
+
+        /// <summary>
+        /// 设置指定音频ID的音量
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        /// <param name="targetVolume">目标音量 (0.0 - 1.0)</param>
+        public void SetVolume(int audioId, float targetVolume)
+        {
+            SetVolume((uint)audioId, targetVolume);
+        }
+
+        /// <summary>
+        /// 设置指定音频ID的音高
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        /// <param name="targetPitch">目标音高 (通常 1.0 为正常音高, -3 ~ 3)</param>
+        public void SetPitch(uint audioId, float targetPitch)
+        {
+            if (targetPitch is < -3 or > 3)
+            {
+                Debug.LogWarning($"[AudioSystem] Pitch '{targetPitch}' is out of range [-3, 3].");
+                return;
+            }
+            this.m_sfxSystem.SetPitch(audioId, targetPitch);
+        }
+
+        /// <summary>
+        /// 设置指定音频ID的音高
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        /// <param name="targetPitch">目标音高 (通常 1.0 为正常音高)</param>
+        public void SetPitch(int audioId, float targetPitch)
+        {
+            SetPitch((uint)audioId, targetPitch);
+        }
+
+        /// <summary>
+        /// 重置指定音频ID的音量为默认值
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        public void ResetVolume(uint audioId)
+        {
+            this.m_sfxSystem.ResetVolume(audioId);
+        }
+
+        /// <summary>
+        /// 重置指定音频ID的音量为默认值
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        public void ResetVolume(int audioId)
+        {
+            ResetVolume((uint)audioId);
+        }
+
+        /// <summary>
+        /// 重置指定音频ID的音高为默认值
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        public void ResetPitch(uint audioId)
+        {
+            this.m_sfxSystem.ResetPitch(audioId);
+        }
+
+        /// <summary>
+        /// 重置指定音频ID的音高为默认值
+        /// </summary>
+        /// <param name="audioId">音频ID</param>
+        public void ResetPitch(int audioId)
+        {
+            ResetPitch((uint)audioId);
+        }
+
        // ─────────────────────────────────────────────
        // 初始化
        // ─────────────────────────────────────────────