웹 오디오
웹의 오디오 기능에 대한 정보입니다.
읽는 시간 5분최근 업데이트: 9일 전
이 페이지는 웹 플랫폼의 오디오 기능에 대한 정보만 제공합니다. Unity 프로젝트에서 오디오를 사용하는 방법을 알아보려면 오디오 개요를 참고하십시오.
Unity는 플랫폼의 오디오를 관리하기 위해 FMOD를 사용하므로 웹 플랫폼은 기본 기능만 포함하는 제한된 오디오 기능을 지원합니다. FMOD는 WebGL API 지원하지 않는 스레드에 의존합니다. 이러한 이유로 Unity 브라우저가 오디오 재생 및 믹싱을 처리할 수 있도록 내부 Web Audio API 기반으로 구현을 사용합니다.
지원되는 클래스
Unity Web은 다음 API 클래스를 지원합니다.
클래스 | WebGL 지원 상태 |
|---|---|
| AudioSource | WebGL은 일부 API를 지원합니다. 구체적인 지원 내용은 AudioSource를 참조하십시오. |
| AudioListener | 모든 API가 지원됩니다. |
| AudioClip | WebGL은 일부 API를 지원합니다. 구체적인 지원 세부 사항은 AudioClip을 참조하십시오. |
| AudioMixer | WebGL은 일부 API를 지원합니다. 구체적인 지원 내용은 오디오 믹서를 참조하십시오. |
| SystemInfo.supportsAudio | 브라우저가 WebGL에 대한 오디오 지원을 제공합니다. 이 때문에, |
| 마이크 | 지원되지 않습니다. |
AudioSource
AudioSource API는 다음을 포함하여 기본 포지션 오디오 재생을 지원합니다.
- 일시 정지 및 재개
- 롤오프(Rolloff)
- 피치 설정
- 도플러 효과 지원
Unity WebGL은 다음 AudioSource API를 지원합니다.
설정 | 설명 |
|---|---|
| 클립 | 다음에 재생되는 오디오 클립을 결정합니다. |
| dopplerLevel | AudioSource의 도플러 스케일을 설정합니다. |
| ignoreListenerPause | AudioSource가 |
| ignoreListenerVolume | 최종 사용자의 AudioSource 볼륨을 무시합니다. |
| isPlaying | |
| loop | 애플리케이션이 |
| maxDistance | |
| minDistance | AudioSource.clip이 더 이상 볼륨을 높이지 않는 최소 거리를 설정합니다. 사운드가 최소 거리 이상으로 감쇠되기 시작합니다. |
| mute | AudioSource를 음소거합니다. |
| pitch | |
| playOnAwake | 활성 상태일 때 AudioSource를 재생합니다. |
| rolloffMode | 거리에 따른 AudioSource 감쇠를 설정합니다. |
| time | 재생 포지션을 초 단위로 설정합니다. |
| timeSamples | 펄스 코드 변조(PCM) 샘플의 재생 포지션을 설정합니다. |
| velocityUpdateMode | AudioSource가 고정 업데이트 루프 또는 동적 업데이트 루프에서 업데이트되는지 여부를 설정합니다. |
| volume | AudioSource의 볼륨을 설정합니다(0.0~1.0). |
| 일시 정지 | |
| 플레이 | 를 재생합니다 |
| PlayDelayed | 지정한 지연 시간으로 |
| PlayOneShot | AudioClip을 재생하고 volumeScale을 기준으로 AudioSource 볼륨을 스케일합니다. |
| PlayScheduled | 지정한 시간에 AudioSource를 재생합니다. |
| SetScheduledEndTime | 예약된 |
| SetScheduledStartTime | 예약된 |
| 중지: | |
| UnPause | 일시 정지된 |
| PlayClipAtPoint | 월드 공간에서 주어진 위치에서 |
AudioClip
Unity WebGL은 대부분의 브라우저에서 지원하는 고급 오디오 코딩(AAC) 포맷의 AudioClip 파일을 임포트합니다. Unity WebGL은 다음 AudioClip API를 지원합니다.
프로퍼티 | 설명 |
|---|---|
| Frequency | 클립의 샘플 프리퀀시(단위: Hertz)입니다. |
| Length | 초 단위로 표시되는 AudioClip의 길이입니다. |
| loadState | AudioClip과 연결된 오디오 데이터의 현재 로드 상태를 반환합니다. |
| 샘플 | 샘플 단위의 AudioClip 길이입니다. |
| loadType | 클립의 로드 타입입니다. 인스펙터에서 AudioClip 로드 타입을 설정할 수 있습니다. |
메서드 | 설명 | 추가 정보 |
|---|---|---|
| AudioClip.Create | 지정한 이름과 길이로 AudioClip을 생성합니다. | Unity WebGL은 |
| AudioClip.SetData | AudioSource.clip의 샘플 데이터를 설정합니다. | Unity WebGL은 |
| AudioClip.GetData | AudioSource.clip에서 샘플 데이터가 포함된 배열을 가져옵니다. | Unity WebGL은 |
오디오 루핑 문제
WebGL 빌드에서 오디오 클립을 반복할 때 루프 포인트에서 오디오에 들리는 글리치가 있을 수 있습니다. AAC는 라이선스가 부여된 포맷이므로 Unity 호스트 플랫폼의 인코더를 사용하여 파일을 AAC로 전환합니다. 인코딩 중에 인코더는 첫 번째 1024개의 샘플을 변경할 수 있으므로 루프 시작 지점에 영향을 미치며 사운드 루프가 발생하면 들리는 글리치가 발생합니다. 이 문제를 해결하려면:
- WAV를 소스 파일 포맷으로 사용합니다.
- WAV 파일의 시작 부분에 최소 1024개의 음소거 샘플을 추가합니다.
- 추가된 음소거 후 루프가 시작되도록 WAV의 청크를 편집합니다.
smpl
오디오 믹서
Unity Web은 일부 오디오 믹서 자산 기능을 지원합니다.
웹의 오디오 믹서로 다음을 수행할 수 있습니다.
- 오디오 믹서 에셋을 생성합니다.
- 계층 구조에 AudioMixerGroups를 추가합니다.
- 각 그룹의 음량을 조정합니다. 스크립팅으로 볼륨을 노출하거나 변경하려면 AudioMixer.SetFloat을 사용합니다.
압축된 오디오
Unity에서 WebGL과 함께 압축된 오디오를 사용하려면 AudioClip loadType을 다음 옵션 중 하나로 설정합니다.
Unity 에디터 이러한 설정을 변경할 수도 있습니다. 설정을 변경하려면 오디오 클립을 선택한 다음 인스펙터 창에서 로드 타입을 원하는 옵션(로드 시 압축 해제 또는 메모리 압축)으로 설정합니다.
압축 방법 | 설명 | 고려 사항 |
|---|---|---|
| CompressedInMemory | 이를 사용하여 디스크의 오디오를 압축하고 애플리케이션 메모리에 로드된 후 압축 상태로 유지합니다. | 압축된 오디오는 지연을 일으킬 수 있으며 오디오 재생 시 더 정확하지 않습니다. 하지만 압축된 오디오는 압축 해제된 오디오보다 애플리케이션에서 메모리를 더 적게 사용합니다. 정밀도에 영향을 받지 않는 오디오에 |
| DecompressOnLoad | CompressedInMemory와 유사하게 디스크의 오디오를 압축하고, 애플리케이션 메모리에 로드될 때 압축을 해제할 때 사용합니다. | 압축 해제된 오디오는 압축된 오디오에 비해 상당한 양의 메모리를 사용하지만 지연 시간이 더 적고 오디오 유연성이 더 높습니다. 정밀도의 영향을 받는 오디오(예: 캐릭터 다이얼로그 또는 사운드 효과)에는 |
iOS 장치의 DecompressOnLoad 문제
오디오 클립의 를 로 설정하면 음소거 모드인 iOS 기기에서 클립이 들리지 않을 수 있습니다. 이 문제는 웹 빌드에서만 발생합니다.
loadTypeDecompressOnLoad웹 오디오 시스템은 브라우저의 노드를 사용하여 로드 타입의 오디오 클립을 로드합니다. WebKit에서는 이 노드 타입을 사운드에 사용되는 와 다르게 분류하기 때문에 소리가 iOS 기기에서 들리지 않습니다.
AudioBufferSourceNodeDecompressOnLoadCompressedInMemoryMediaElementSourceNode음소거 모드에 관계없이 오디오가 재생되도록 하려면 오디오 클립 를 로 설정합니다. 씬이 시작될 때 사운드를 로드해야 하는 경우 임시 씬에서 사운드를 완전히 로드하고 타겟 씬을 추가로 로드하는 것이 좋습니다.
loadTypeCompressedInMemory오디오 재생 및 브라우저 보안
보안상의 이유로 최종 사용자 마우스 클릭 수, 터치 이벤트 또는 키 누름을 통해 애플리케이션 웹페이지와 상호 작용할 때까지 브라우저에서 오디오 재생을 허용하지 않습니다. 로딩 화면을 사용하면 최종 사용자 애플리케이션과 상호 작용하고 메인 콘텐츠가 시작되기 전에 오디오 재생을 시작할 수 있습니다.