AudioSource

描述

3D 中音频源的表示。

AudioSource 附加到 GameObject 上，用于在 3D 环境中播放声音。为了播放 3D 声音，您还需要一个 AudioListener。音频监听器通常附加到您要使用的相机。声音是在 3D 还是 2D 中播放由 AudioImporter 设置决定。

您可以使用 Play、Pause 和 Stop 播放单个音频剪辑。您也可以在播放时使用 volume 属性调整其音量，或者使用 time 进行搜索。多个声音可以使用 PlayOneShot 在一个 AudioSource 上播放。您可以使用 PlayClipAtPoint 在 3D 空间中的静态位置播放剪辑。

其他资源：AudioListener、AudioClip、AudioSource 组件。

//This script allows you to toggle music to play and stop.
//Assign an AudioSource to a GameObject and attach an Audio Clip in the Audio Source. Attach this script to the GameObject.

using UnityEngine;

public class Example : MonoBehaviour
{
    AudioSource m_MyAudioSource;

    //Play the music
    bool m_Play;
    //Detect when you use the toggle, ensures music isn’t played multiple times
    bool m_ToggleChange;

    void Start()
    {
        //Fetch the AudioSource from the GameObject
        m_MyAudioSource = GetComponent<AudioSource>();
        //Ensure the toggle is set to true for the music to play at start-up
        m_Play = true;
    }

    void Update()
    {
        //Check to see if you just set the toggle to positive
        if (m_Play == true && m_ToggleChange == true)
        {
            //Play the audio you attach to the AudioSource component
            m_MyAudioSource.Play();
            //Ensure audio doesn’t play more than once
            m_ToggleChange = false;
        }
        //Check if you just set the toggle to false
        if (m_Play == false && m_ToggleChange == true)
        {
            //Stop the audio
            m_MyAudioSource.Stop();
            //Ensure audio doesn’t play more than once
            m_ToggleChange = false;
        }
    }

    void OnGUI()
    {
        //Switch this toggle to activate and deactivate the parent GameObject
        m_Play = GUI.Toggle(new Rect(10, 10, 100, 30), m_Play, "Play Music");

        //Detect if there is a change with the toggle
        if (GUI.changed)
        {
            //Change to true to show that there was just a change in the toggle state
            m_ToggleChange = true;
        }
    }
}

属性

公共方法

静态方法

继承的成员