Version: 5.3 (switch to 5.4b)
ЯзыкEnglish
  • C#
  • JS

Язык программирования

Выберите подходящий для вас язык программирования. Все примеры кода будут представлены на выбранном языке.

AudioSource

class in UnityEngine

/

Наследует от:Behaviour

Предложить изменения

Успех!

Благодарим вас за то, что вы помогаете нам улучшить качество документации по Unity. Однако, мы не можем принять любой перевод. Мы проверяем каждый предложенный вами вариант перевода и принимаем его только если он соответствует оригиналу.

Закрыть

Ошибка внесения изменений

По определённым причинам предложенный вами перевод не может быть принят. Пожалуйста <a>попробуйте снова</a> через пару минут. И выражаем вам свою благодарность за то, что вы уделяете время, чтобы улучшить документацию по Unity.

Закрыть

Отменить

Руководство

Описание

Представление источников звука в 3D.

Источник звуков AudioSource привязывается к GameObject для воспроизведения звуков в трёхмерном окружении. Для проигрывания 3D звуков, вам также необходим AudioListener. Как правило слушатель audio listener привязывается к камере, которую вы собираетесь использовать. Играются ли звуки в 3D или в 2D определяется настройками AudioImporter.

Вы можете проигрывать выбранный одиночный аудио клип, используя Play, Pause и Stop. Вы также можете настраивать его громкость во время воспроизведения, используя свойство volume, или перематывать, используя time. При использовании PlayOneShot на одном AudioSource могут быть проиграны сразу несколько звуков. Вы можете проигрывать клип в статичной точке в трёхмерном пространстве, используя PlayClipAtPoint.

See Also: AudioListener, AudioClip, AudioSource component.

Переменные

bypassEffectsБайпас эффекты (Наложенные на компоненты фильтров или фильтры глобальных слушателей).
bypassListenerEffectsWhen 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.
bypassReverbZonesWhen set doesn't route the signal from an AudioSource into the global reverb associated with reverb zones.
clipВыбранный по умолчанию AudioClip для проигрывания.
dopplerLevelУстанавливает коэффициент Доплера для выбранного источника звука AudioSorce.
ignoreListenerPauseПозволяет источнику звука AudioSource продолжать проигрывание звука, даже если значение AudioListener.pause установлено true. Это может быть полезным для звуков элементов меню или фоновой музыки в меню паузы.
ignoreListenerVolumeЭто позволяет источнику аудио не принимать во внимание громкость слушателя звуков.
isPlayingИграет ли в данный момент clip (Read Only)?
loopАудио клип зациклен?
maxDistance(Логарифмическое затухание) MaxDistance это дистанция, на которой звук перестаёт ослабевать.
minDistanceВ пределах Min distance источник звука AudioSource прекратит увеличение громкости.
muteВключает/выключает звук источника звука AudioSource. Выключение делает громкость = 0. Включение возвращает оригинальную громкость.
outputAudioMixerGroupThe target group to which the AudioSource should route its signal.
panStereoPans 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.
reverbZoneMixThe amount by which the signal from the AudioSource will be mixed into the global reverb associated with the Reverb Zones.
rolloffModeУстанавливает/Возвращает для источника звука AudioSource способ затухания с расстоянием.
spatialBlendSets 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.
spatializeEnables or disables spatialization.
spreadУстанавливает для угла раскрытия режим 3d стерео или мультиканальный звук в пространстве динамиков.
timeПозиция воспроизведения, в секундах.
timeSamplesПозиция воспроизведения в PCM сэмпле.
velocityUpdateModeДолжен ли источник звука обновляться в фиксированном (fixed) или динамическом (dynamic) update.
volumeГромкость источника звука (от 0.0 до 1.0).

Открытые функции

GetCustomCurveУстанавливает коэффициент Доплера для выбранного источника звука AudioSorce.
GetSpatializerFloatReads a user-defined parameter of a custom spatializer effect that is attached to an AudioSource.
PauseПриостанавливает воспроизведение clip.
PlayПроигрывает clip с задержкой перед началом воспроизведения (опционально).
PlayDelayedПроигрывает clip с задержкой, заданной в секундах. Рекомендуется использовать эту функцию вместо старой Play(delay) , которая в качестве аргумента использует задержку в сэмплах, соответствующих частоте сэмплирования (дискретизации) 44.1 кГц.
PlayOnDualShock4Enable playing of audio source though a specfic DualShock4 controllerEnable playing of audio source though a specfic DualShock4 controller.
PlayOneShotПроигрывает AudioClip и масштабирует громкость AudioSource в соответствии с volumeScale.
PlayScheduledПроигрывает clip в заданное время на абсолютной временной шкале, считанной из AudioSettings.dspTime .
SetCustomCurveУстанавливает коэффициент Доплера для выбранного источника звука AudioSorce.
SetScheduledEndTimeИзменяет время, в которое звук, уже запланированный на воспроизведение, закончит воспроизведение. Обратите внимание, что в зависимости от времени, не каждый запрос на перепланирование может быть выполнен.
SetScheduledStartTimeИзменяет время, в которое уже запланированный звук начнёт играть.
SetSpatializerFloatSets a user-defined parameter of a custom spatializer effect that is attached to an AudioSource.
StopОстанавливает воспроизведение clip.
UnPauseУстанавливает коэффициент Доплера для выбранного источника звука AudioSorce.

Статические функции

PlayClipAtPointПроигрывает AudioClip в заданной точке мирового пространства.

Унаследованные члены

Переменные

enabledEnabled Behaviours are Updated, disabled Behaviours are not.
isActiveAndEnabledHas the Behaviour had enabled called.
gameObjectThe game object this component is attached to. A component is always attached to a game object.
tagТег данного игрового объекта.
transformThe Transform attached to this GameObject (null if there is none attached).
hideFlagsShould the object be hidden, saved with the scene or modifiable by the user?
nameThe name of the object.

Открытые функции

BroadcastMessageВызывает метод названный methodName на каждом MonoBehaviour этого game object-а или любого из его потомков.
CompareTagПомечен ли этот игровой объект тэгом tag?
GetComponentВозвращает компонент типа type, если он прикреплен к игровому объекту и null, если не прикреплен.
GetComponentInChildrenReturns the component of Type type in the GameObject or any of its children using depth first search.
GetComponentInParentReturns the component of Type type in the GameObject or any of its parents.
GetComponentsReturns all components of Type type in the GameObject.
GetComponentsInChildrenReturns all components of Type type in the GameObject or any of its children.
GetComponentsInParentReturns all components of Type type in the GameObject or any of its parents.
SendMessageВызывает метод с именем methodName в каждом MonoBehaviour на этом объекте.
SendMessageUpwardsВызывает на каждом MonoBehaviour в данном игровом объекте и на каждом предке скрипта метод с именем methodName.
GetInstanceIDReturns the instance id of the object.
ToStringReturns the name of the game object.

Статические функции

DestroyRemoves a gameobject, component or asset.
DestroyImmediateDestroys the object obj immediately. You are strongly recommended to use Destroy instead.
DontDestroyOnLoadMakes the object target not be destroyed automatically when loading a new scene.
FindObjectOfTypeReturns the first active loaded object of Type type.
FindObjectsOfTypeReturns a list of all active loaded objects of Type type.
InstantiateReturns a copy of the object original.

Операторы

boolDoes 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.