기술 자료

Unity 엔진

Unity 엔진

웹 오디오

웹의 오디오 기능에 대한 정보입니다.
읽는 시간 5분최근 업데이트: 9일 전

이 페이지는 웹 플랫폼의 오디오 기능에 대한 정보만 제공합니다. Unity 프로젝트에서 오디오를 사용하는 방법을 알아보려면 오디오 개요를 참고하십시오.
Unity는 플랫폼의 오디오를 관리하기 위해 FMOD를 사용하므로 웹 플랫폼은 기본 기능만 포함하는 제한된 오디오 기능을 지원합니다. FMOD는 WebGL API 지원하지 않는 스레드에 의존합니다. 이러한 이유로 Unity 브라우저가 오디오 재생 및 믹싱을 처리할 수 있도록 내부 Web Audio API 기반으로 구현을 사용합니다.
참고
Google Chrome의 새로운 자동 재생 정책은 특정 조건에서 오디오와 비디오의 자동 재생을 방지합니다. 예를 들어 게임이 로드된 직후 일부 배경 음악을 자동으로 재생하도록 설정할 수 있지만 웹사이트를 클릭 수 탭하지 않으면 자동으로 재생되지 않습니다. 이 정책을 활성화하거나 비활성화하는 방법에 대한 자세한 내용은 Google Chrome의 Chrome의 자동 재생 정책 문서를 참조하십시오.

지원되는 클래스

Unity Web은 다음 API 클래스를 지원합니다.

클래스

WebGL 지원 상태

AudioSourceWebGL은 일부 API를 지원합니다. 구체적인 지원 내용은 AudioSource를 참조하십시오.
AudioListener모든 API가 지원됩니다.
AudioClipWebGL은 일부 API를 지원합니다. 구체적인 지원 세부 사항은 AudioClip을 참조하십시오.
AudioMixerWebGL은 일부 API를 지원합니다. 구체적인 지원 내용은 오디오 믹서를 참조하십시오.
SystemInfo.supportsAudio브라우저가 WebGL에 대한 오디오 지원을 제공합니다. 이 때문에,
SystemInfo.supportsAudio
는 항상 true입니다.
마이크지원되지 않습니다.

AudioSource

AudioSource API는 다음을 포함하여 기본 포지션 오디오 재생을 지원합니다.
  • 일시 정지 및 재개
  • 롤오프(Rolloff)
  • 피치 설정
  • 도플러 효과 지원
Unity WebGL은 다음 AudioSource API를 지원합니다.

설정

설명

클립다음에 재생되는 오디오 클립을 결정합니다.
dopplerLevelAudioSource의 도플러 스케일을 설정합니다.
ignoreListenerPauseAudioSource가
AudioListener.pause
를 무시하고 계속해서 오디오를 재생하도록 허용합니다.
ignoreListenerVolume최종 사용자의 AudioSource 볼륨을 무시합니다.
isPlaying
AudioSource.clip
가 재생 중이면 true를 반환합니다.
loop애플리케이션이
AudioSource.clip
를 반복할 수 있습니다.
maxDistance
AudioSource.clip
가 감쇠를 멈추거나 들리지 않는 최대 거리를 설정합니다.
minDistanceAudioSource.clip이 더 이상 볼륨을 높이지 않는 최소 거리를 설정합니다. 사운드가 최소 거리 이상으로 감쇠되기 시작합니다.
muteAudioSource를 음소거합니다.
pitch
AudioSource.clip
의 피치를 설정합니다. WebGL은 양의 피치 값만 지원합니다.
playOnAwake활성 상태일 때 AudioSource를 재생합니다.
rolloffMode거리에 따른 AudioSource 감쇠를 설정합니다.
time재생 포지션을 초 단위로 설정합니다.
timeSamples펄스 코드 변조(PCM) 샘플의 재생 포지션을 설정합니다.
velocityUpdateModeAudioSource가 고정 업데이트 루프 또는 동적 업데이트 루프에서 업데이트되는지 여부를 설정합니다.
volumeAudioSource의 볼륨을 설정합니다(0.0~1.0).
일시 정지
AudioSource.clip
를 일시정지합니다.
플레이를 재생합니다
AudioSource.clip
.
PlayDelayed지정한 지연 시간으로
AudioSource.clip
를 초 단위로 재생합니다.
PlayOneShotAudioClip을 재생하고 volumeScale을 기준으로 AudioSource 볼륨을 스케일합니다.
PlayScheduled지정한 시간에 AudioSource를 재생합니다.
SetScheduledEndTime예약된
AudioSource.clip
가 종료되는 시간을 설정합니다.
SetScheduledStartTime예약된
AudioSource.clip
가 시작되는 시간을 설정합니다.
중지:
AudioSource.clip
재생을 멈춥니다.
UnPause일시 정지된
AudioSource.clip
를 해제합니다.
PlayClipAtPoint월드 공간에서 주어진 위치에서
AudioSource.clip
를 재생합니다.
참고
오디오 데이터는 브라우저에서
decodeAudioData
를 사용하여 디코딩되기 때문에 브라우저가 일반적으로 장치 오디오 드라이버 설정과 일치하는
BaseAudioContext
샘플링 속도와 일치하므로 오디오 파일의 런타임 샘플링 속도가 직렬화된 오디오 데이터(44100Hz)와 다를 수 있습니다. 이를 고려하여 런타임 시
AudioClip.frequency
값을 확인하거나 검색 작업을 수행할 때
AudioSource.time
값을 사용하는 것이 좋습니다.

AudioClip

Unity WebGL은 대부분의 브라우저에서 지원하는 고급 오디오 코딩(AAC) 포맷의 AudioClip 파일을 임포트합니다. Unity WebGL은 다음 AudioClip API를 지원합니다.

프로퍼티

설명

Frequency클립의 샘플 프리퀀시(단위: Hertz)입니다.
Length초 단위로 표시되는 AudioClip의 길이입니다.
loadStateAudioClip과 연결된 오디오 데이터의 현재 로드 상태를 반환합니다.
샘플샘플 단위의 AudioClip 길이입니다.
loadType클립의 로드 타입입니다. 인스펙터에서 AudioClip 로드 타입을 설정할 수 있습니다.

메서드

설명

추가 정보

AudioClip.Create지정한 이름과 길이로 AudioClip을 생성합니다.Unity WebGL은
AudioClip.Create
를 부분적으로 지원합니다. 브라우저는 동적 스트리밍을 지원하지 않으므로
AudioClip.Create
를 사용하려면 Stream을 false로 설정합니다.
AudioClip.SetDataAudioSource.clip의 샘플 데이터를 설정합니다.Unity WebGL은
AudioClip.SetData
를 부분적으로 지원합니다. 이 방법은 Load Type이 Decompress on Load로 설정된 압축된 오디오 파일에만 사용할 수 있습니다. 압축 오디오를 참조하십시오.
AudioClip.GetDataAudioSource.clip에서 샘플 데이터가 포함된 배열을 가져옵니다.Unity WebGL은
AudioClip.GetData
를 부분적으로 지원합니다. 이 방법은 Load Type이 Decompress on Load로 설정된 압축된 오디오 파일에만 사용할 수 있습니다. 압축 오디오를 참조하십시오.
참고
Linux에서 오디오 클립을 지원하려면 ffmpeg 패키지를 설치했는지 확인하십시오.

오디오 루핑 문제

WebGL 빌드에서 오디오 클립을 반복할 때 루프 포인트에서 오디오에 들리는 글리치가 있을 수 있습니다. AAC는 라이선스가 부여된 포맷이므로 Unity 호스트 플랫폼의 인코더를 사용하여 파일을 AAC로 전환합니다. 인코딩 중에 인코더는 첫 번째 1024개의 샘플을 변경할 수 있으므로 루프 시작 지점에 영향을 미치며 사운드 루프가 발생하면 들리는 글리치가 발생합니다. 이 문제를 해결하려면:
  1. WAV를 소스 파일 포맷으로 사용합니다.
  2. WAV 파일의 시작 부분에 최소 1024개의 음소거 샘플을 추가합니다.
  3. 추가된 음소거 후 루프가 시작되도록 WAV의
    smpl
    청크를 편집합니다.

오디오 믹서

Unity Web은 일부 오디오 믹서 자산 기능을 지원합니다.
웹의 오디오 믹서로 다음을 수행할 수 있습니다.
  • 오디오 믹서 에셋을 생성합니다.
  • 계층 구조에 AudioMixerGroups를 추가합니다.
  • 각 그룹의 음량을 조정합니다. 스크립팅으로 볼륨을 노출하거나 변경하려면 AudioMixer.SetFloat을 사용합니다.
참고
Volume은 웹에서 변경할 수 있는 유일한 프로퍼티입니다. 다른 프로퍼티와 음향 효과는 지원되지 않습니다.

압축된 오디오

Unity에서 WebGL과 함께 압축된 오디오를 사용하려면 AudioClip loadType을 다음 옵션 중 하나로 설정합니다.
Unity 에디터 이러한 설정을 변경할 수도 있습니다. 설정을 변경하려면 오디오 클립을 선택한 다음 인스펙터 창에서 로드 타입을 원하는 옵션(로드 시 압축 해제 또는 메모리 압축)으로 설정합니다.

압축 방법

설명

고려 사항

CompressedInMemory이를 사용하여 디스크의 오디오를 압축하고 애플리케이션 메모리에 로드된 후 압축 상태로 유지합니다.압축된 오디오는 지연을 일으킬 수 있으며 오디오 재생 시 더 정확하지 않습니다. 하지만 압축된 오디오는 압축 해제된 오디오보다 애플리케이션에서 메모리를 더 적게 사용합니다. 정밀도에 영향을 받지 않는 오디오에
CompressedInMemory
를 사용하는 것이 가장 좋습니다(예: 배경 음악).
DecompressOnLoadCompressedInMemory와 유사하게 디스크의 오디오를 압축하고, 애플리케이션 메모리에 로드될 때 압축을 해제할 때 사용합니다.압축 해제된 오디오는 압축된 오디오에 비해 상당한 양의 메모리를 사용하지만 지연 시간이 더 적고 오디오 유연성이 더 높습니다. 정밀도의 영향을 받는 오디오(예: 캐릭터 다이얼로그 또는 사운드 효과)에는
DecompressedOnLoad
를 사용합니다.

iOS 장치의 DecompressOnLoad 문제

오디오 클립의
loadType
를
DecompressOnLoad
로 설정하면 음소거 모드인 iOS 기기에서 클립이 들리지 않을 수 있습니다. 이 문제는 웹 빌드에서만 발생합니다.
웹 오디오 시스템은 브라우저의
AudioBufferSourceNode
노드를 사용하여
DecompressOnLoad
로드 타입의 오디오 클립을 로드합니다. WebKit에서는 이 노드 타입을
CompressedInMemory
사운드에 사용되는
MediaElementSourceNode
와 다르게 분류하기 때문에 소리가 iOS 기기에서 들리지 않습니다.
음소거 모드에 관계없이 오디오가 재생되도록 하려면 오디오 클립
loadType
를
CompressedInMemory
로 설정합니다. 씬이 시작될 때 사운드를 로드해야 하는 경우 임시 씬에서 사운드를 완전히 로드하고 타겟 씬을 추가로 로드하는 것이 좋습니다.

오디오 재생 및 브라우저 보안

보안상의 이유로 최종 사용자 마우스 클릭 수, 터치 이벤트 또는 키 누름을 통해 애플리케이션 웹페이지와 상호 작용할 때까지 브라우저에서 오디오 재생을 허용하지 않습니다. 로딩 화면을 사용하면 최종 사용자 애플리케이션과 상호 작용하고 메인 콘텐츠가 시작되기 전에 오디오 재생을 시작할 수 있습니다.