Представление источников звука в 3D.
An AudioSource is attached to a GameObject for playing back sounds in a 3D environment.
In order to play 3D sounds you also need to have a AudioListener.
The audio listener is normally attached to the camera you want to use.
Whether sounds are played in 3D or 2D is determined by AudioImporter settings.
You can play a single audio clip using Play, Pause and Stop.
You can also adjust its volume while playing using the volume property, or seek using time.
Multiple sounds can be played on one AudioSource using PlayOneShot.
You can play a clip at a static position in 3D space using PlayClipAtPoint.
See Also: AudioListener, AudioClip, AudioSource component.
//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; } } }
bypassEffects | Байпас эффекты (Наложенные на компоненты фильтров или фильтры глобальных слушателей). |
bypassListenerEffects | When set global effects on the AudioListener will not be applied to the audio signal generated by the AudioSource. Does not apply if the AudioSource is playing into a mixer group. |
bypassReverbZones | When set doesn't route the signal from an AudioSource into the global reverb associated with reverb zones. |
clip | Выбранный по умолчанию AudioClip для проигрывания. |
dopplerLevel | Устанавливает коэффициент Доплера для выбранного источника звука AudioSorce. |
gamepadSpeakerOutputType | Gets or sets the gamepad audio output type for this audio source. |
ignoreListenerPause | Позволяет источнику звука AudioSource продолжать проигрывание звука, даже если значение AudioListener.pause установлено true. Это может быть полезным для звуков элементов меню или фоновой музыки в меню паузы. |
ignoreListenerVolume | Это позволяет источнику аудио не принимать во внимание громкость слушателя звуков. |
isPlaying | Играет ли в данный момент clip (Read Only)? |
isVirtual | True if all sounds played by the AudioSource (main sound started by Play() or playOnAwake as well as one-shots) are culled by the audio system. |
loop | Аудио клип зациклен? |
maxDistance | (Логарифмическое затухание) MaxDistance это дистанция, на которой звук перестаёт ослабевать. |
minDistance | В пределах Min distance источник звука AudioSource прекратит увеличение громкости. |
mute | Включает/выключает звук источника звука AudioSource. Выключение делает громкость = 0. Включение возвращает оригинальную громкость. |
outputAudioMixerGroup | The target group to which the AudioSource should route its signal. |
panStereo | Pans a playing sound in a stereo way (left or right). This only applies to sounds that are Mono or Stereo. |
pitch | Высота звука источника звука. |
playOnAwake | Если установлено в значение true, источник звука автоматически начнёт проигрывание при пробуждении (awake). |
priority | Устанавливает приоритет для AudioSource. |
reverbZoneMix | The amount by which the signal from the AudioSource will be mixed into the global reverb associated with the Reverb Zones. |
rolloffMode | Устанавливает/Возвращает для источника звука AudioSource способ затухания с расстоянием. |
spatialBlend | Sets how much this AudioSource is affected by 3D spatialisation calculations (attenuation, doppler etc). 0.0 makes the sound full 2D, 1.0 makes it full 3D. |
spatialize | Enables or disables spatialization. |
spatializePostEffects | Determines if the spatializer effect is inserted before or after the effect filters. |
spread | Устанавливает для угла раскрытия режим 3d стерео или мультиканальный звук в пространстве динамиков. |
time | Позиция воспроизведения, в секундах. |
timeSamples | Позиция воспроизведения в PCM сэмпле. |
velocityUpdateMode | Должен ли источник звука обновляться в фиксированном (fixed) или динамическом (dynamic) update. |
volume | Громкость источника звука (от 0.0 до 1.0). |
DisableGamepadOutput | Disables audio output to a gamepad for this audio source. |
GetAmbisonicDecoderFloat | Reads a user-defined parameter of a custom ambisonic decoder effect that is attached to an AudioSource. |
GetCustomCurve | Устанавливает коэффициент Доплера для выбранного источника звука AudioSorce. |
GetOutputData | Возвращает блок из выходных данных текущего играющего источника. |
GetSpatializerFloat | Reads a user-defined parameter of a custom spatializer effect that is attached to an AudioSource. |
GetSpectrumData | Возвращает блок из данных спектра из текущего играющего источника. |
Pause | Приостанавливает воспроизведение clip. |
Play | Plays the clip. |
PlayDelayed | Проигрывает clip с задержкой, заданной в секундах. Рекомендуется использовать эту функцию вместо старой Play(delay) , которая в качестве аргумента использует задержку в сэмплах, соответствующих частоте сэмплирования (дискретизации) 44.1 кГц. |
PlayOneShot | Проигрывает AudioClip и масштабирует громкость AudioSource в соответствии с volumeScale. |
PlayOnGamepad | Enable playing of audio source though a specfic gamepad. |
PlayScheduled | Проигрывает clip в заданное время на абсолютной временной шкале, считанной из AudioSettings.dspTime . |
SetAmbisonicDecoderFloat | Sets a user-defined parameter of a custom ambisonic decoder effect that is attached to an AudioSource. |
SetCustomCurve | Устанавливает коэффициент Доплера для выбранного источника звука AudioSorce. |
SetScheduledEndTime | Изменяет время, в которое звук, уже запланированный на воспроизведение, закончит воспроизведение. Обратите внимание, что в зависимости от времени, не каждый запрос на перепланирование может быть выполнен. |
SetScheduledStartTime | Изменяет время, в которое уже запланированный звук начнёт играть. |
SetSpatializerFloat | Sets a user-defined parameter of a custom spatializer effect that is attached to an AudioSource. |
Stop | Останавливает воспроизведение clip. |
UnPause | Устанавливает коэффициент Доплера для выбранного источника звука AudioSorce. |
GamepadSpeakerSupportsOutputType | Check if the platform supports an audio output type on gamepads. |
PlayClipAtPoint | Проигрывает AudioClip в заданной точке мирового пространства. |
enabled | Включенное Поведение обновляется, выключенное Поведение не обновляется. |
isActiveAndEnabled | Has the Behaviour had active and enabled called? |
gameObject | Игровой объект к которому прикреплён данный компонент. Компонент всегда прикреплён к игровому объекту. |
tag | Тег данного игрового объекта. |
transform | The Transform attached to this GameObject. |
hideFlags | Should the object be hidden, saved with the Scene or modifiable by the user? |
name | The name of the object. |
BroadcastMessage | Вызывает метод названный methodName на каждом MonoBehaviour этого game object-а или любого из его потомков. |
CompareTag | Помечен ли данный игровой объект тегом tag? |
GetComponent | Возвращает компонент типа type, если он прикреплен к игровому объекту и null, если не прикреплен. |
GetComponentInChildren | Возвращает компонент типа type в GameObject или некоторого его потомка через поиск в глубину. |
GetComponentInParent | Возвращает все компоненты типа type из GameObject'а или из любого его родителя. |
GetComponents | Возвращает все компоненты типа type в GameObject. |
GetComponentsInChildren | Возвращает все компоненты типа type в GameObject или любому из его потомков. |
GetComponentsInParent | Возвращает все компоненты типа type в GameObject или любому из его родителей. |
SendMessage | Вызывает метод с названием methodName в каждом MonoBehaviour в этом игровом объекте. |
SendMessageUpwards | Вызывает метод с именем methodName в каждом MonoBehaviour в этом игровом объекте и в каждом предке поведения. |
TryGetComponent | Gets the component of the specified type, if it exists. |
GetInstanceID | Returns the instance id of the object. |
ToString | Returns the name of the object. |
Destroy | Removes a GameObject, component or asset. |
DestroyImmediate | Destroys the object obj immediately. You are strongly recommended to use Destroy instead. |
DontDestroyOnLoad | Do not destroy the target Object when loading a new Scene. |
FindObjectOfType | Returns the first active loaded object of Type type. |
FindObjectsOfType | Returns a list of all active loaded objects of Type type. |
Instantiate | Clones the object original and returns the clone. |
bool | Does the object exist? |
operator != | Compares if two objects refer to a different object. |
operator == | Compares two object references to see if they refer to the same object. |