- 引入 UnityGameFramework

- 使用 Luban 替代原来的 UGF 的数据表
2026-08-30 18:08:55 +08:00
parent 42ad134759
commit 92bf3e9097
1925 changed files with 362268 additions and 4859 deletions
@@ -0,0 +1,188 @@
+//------------------------------------------------------------
+// Game Framework
+// Copyright © 2013-2021 Jiang Yin. All rights reserved.
+// Homepage: https://gameframework.cn/
+// Feedback: mailto:ellan@gameframework.cn
+//------------------------------------------------------------
+
+using GameFramework.Sound;
+using System;
+using UnityEngine;
+using UnityEngine.Audio;
+
+namespace UnityGameFramework.Runtime
+{
+    /// <summary>
+    /// 声音代理辅助器基类。
+    /// </summary>
+    public abstract class SoundAgentHelperBase : MonoBehaviour, ISoundAgentHelper
+    {
+        /// <summary>
+        /// 获取当前是否正在播放。
+        /// </summary>
+        public abstract bool IsPlaying
+        {
+            get;
+        }
+
+        /// <summary>
+        /// 获取声音长度。
+        /// </summary>
+        public abstract float Length
+        {
+            get;
+        }
+
+        /// <summary>
+        /// 获取或设置播放位置。
+        /// </summary>
+        public abstract float Time
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置是否静音。
+        /// </summary>
+        public abstract bool Mute
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置是否循环播放。
+        /// </summary>
+        public abstract bool Loop
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音优先级。
+        /// </summary>
+        public abstract int Priority
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置音量大小。
+        /// </summary>
+        public abstract float Volume
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音音调。
+        /// </summary>
+        public abstract float Pitch
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音立体声声相。
+        /// </summary>
+        public abstract float PanStereo
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音空间混合量。
+        /// </summary>
+        public abstract float SpatialBlend
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音最大距离。
+        /// </summary>
+        public abstract float MaxDistance
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音多普勒等级。
+        /// </summary>
+        public abstract float DopplerLevel
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 获取或设置声音代理辅助器所在的混音组。
+        /// </summary>
+        public abstract AudioMixerGroup AudioMixerGroup
+        {
+            get;
+            set;
+        }
+
+        /// <summary>
+        /// 重置声音代理事件。
+        /// </summary>
+        public abstract event EventHandler<ResetSoundAgentEventArgs> ResetSoundAgent;
+
+        /// <summary>
+        /// 播放声音。
+        /// </summary>
+        /// <param name="fadeInSeconds">声音淡入时间，以秒为单位。</param>
+        public abstract void Play(float fadeInSeconds);
+
+        /// <summary>
+        /// 停止播放声音。
+        /// </summary>
+        /// <param name="fadeOutSeconds">声音淡出时间，以秒为单位。</param>
+        public abstract void Stop(float fadeOutSeconds);
+
+        /// <summary>
+        /// 暂停播放声音。
+        /// </summary>
+        /// <param name="fadeOutSeconds">声音淡出时间，以秒为单位。</param>
+        public abstract void Pause(float fadeOutSeconds);
+
+        /// <summary>
+        /// 恢复播放声音。
+        /// </summary>
+        /// <param name="fadeInSeconds">声音淡入时间，以秒为单位。</param>
+        public abstract void Resume(float fadeInSeconds);
+
+        /// <summary>
+        /// 重置声音代理辅助器。
+        /// </summary>
+        public abstract void Reset();
+
+        /// <summary>
+        /// 设置声音资源。
+        /// </summary>
+        /// <param name="soundAsset">声音资源。</param>
+        /// <returns>是否设置声音资源成功。</returns>
+        public abstract bool SetSoundAsset(object soundAsset);
+
+        /// <summary>
+        /// 设置声音绑定的实体。
+        /// </summary>
+        /// <param name="bindingEntity">声音绑定的实体。</param>
+        public abstract void SetBindingEntity(Entity bindingEntity);
+
+        /// <summary>
+        /// 设置声音所在的世界坐标。
+        /// </summary>
+        /// <param name="worldPosition">声音所在的世界坐标。</param>
+        public abstract void SetWorldPosition(Vector3 worldPosition);
+    }
+}