Unity 音效对象

最新推荐文章于 2025-06-04 19:40:59 发布

原创最新推荐文章于 2025-06-04 19:40:59 发布 · 471 阅读

1 ·

CC 4.0 BY-SA版权

Unity基础框架专栏收录该内容

14 篇文章

订阅专栏

本文介绍了一个Unity中的音效管理组件SoundObject。该组件提供了一系列音效控制方法，如播放、暂停、停止等，并能处理音效剪辑的循环播放及音量调整。SoundObject还支持在音效停止时触发事件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

using System;
using UnityEngine;

namespace Framework {
	/// <summary>
	/// 音效对象
	/// </summary>
	[RequireComponent (typeof (AudioSource))]
	public class SoundObject : MonoBehaviour {
		/// <summary>
		/// 停止事件
		/// </summary>
		public event Action<SoundObject> OnStopEvent;

		/// <summary>
		/// 音效资源
		/// </summary>
		private AudioSource m_AudioSource;

		private void Awake () {
			m_AudioSource = GetComponent<AudioSource> ();
			m_AudioSource.playOnAwake = false;
		}

		private void Update () {
			if (!m_AudioSource.isPlaying) {
				Stop ();
			}
		}

		/// <summary>
		/// 播放音效
		/// </summary>
		/// <param name="audioClip">音效剪辑</param>
		/// <param name="loop">是否循环</param>
		public void Play (AudioClip audioClip, bool loop = false) {
			gameObject.name = audioClip.name;
			gameObject.SetActive (true);

			m_AudioSource.enabled = true;
			m_AudioSource.clip = audioClip;
			m_AudioSource.loop = loop;
			m_AudioSource.Play ();
		}

		/// <summary>
		/// 重新播放
		/// </summary>
		public void Replay () {
			if (m_AudioSource.clip == null) {
				return;
			}

			gameObject.SetActive (true);
			m_AudioSource.enabled = true;
			m_AudioSource.time = 0;
			m_AudioSource.Play ();
		}

		/// <summary>
		/// 停止音效
		/// </summary>
		/// <param name="destroy">是否销毁</param>
		public void Stop (bool destroy = false) {
			gameObject.SetActive (false);

			m_AudioSource.Stop ();
			m_AudioSource.clip = null;
			m_AudioSource.enabled = false;

			if (OnStopEvent != null) {
				OnStopEvent.Invoke (this);
				OnStopEvent = null;
			}

			if (destroy) {
				Destroy (gameObject);
			}
		}

		/// <summary>
		/// 暂停音效
		/// </summary>
		public void Pause () {
			gameObject.SetActive (false);
			m_AudioSource.Pause ();
		}

		/// <summary>
		/// 取消暂停
		/// </summary>
		public void UnPause () {
			gameObject.SetActive (true);
			m_AudioSource.UnPause ();
		}

		/// <summary>
		/// 设置音乐音量
		/// </summary>
		/// <param name="val"></param>
		public void SetVolume (float val) {
			if (m_AudioSource != null) {
				m_AudioSource.volume = val;
			}
		}

		/// <summary>
		/// 获取音乐音量
		/// </summary>
		/// <param name="val"></param>
		/// <returns></returns>
		public float GetVolume (float val) {
			if (m_AudioSource != null) {
				return m_AudioSource.volume;
			}

			return 0;
		}
	}
}