AudioSettings 클래스는 사운드 시스템과 관련된 다양한 글로벌 정보를 포함하는데 그중에서도 특히 API는 스피커 모드, 샘플 레이트(플랫폼이 지원하는 경우), DSP 버퍼 크기 및 실제/가상 음성 개수 등의 설정을 변경하기 위해 런타임 시 오디오 시스템 초기화가 가능합니다.
이러한 설정 중 다수는 프로젝트 설정의 Audio 섹션에서 설정할 수도 있습니다. 이러한 설정을 변경하면 에디터에도 적용이 되고 게임의 초기 상태를 정의할 수 있지만, AudioSettings API를 사용하여 변경하면 게임 런타임에만 적용되며 에디터에서 게임을 멈추게 되면 프로젝트 설정에서 정의된 상태로 다시 초기화됩니다.
게임은 사용자가 사운드 설정을 변경할 수 있는 사운드 옵션 메뉴를 제공할 수 있으며, 외부 오디오 입력/출력 기기를 연결하거나 오디오 기기로도 작동할 수 있는 HDMI 모니터 등 장치 변경에 대한 반응으로 외부에서 변경이 발생할 수 있습니다. AudioConfiguration AudioSettings.GetConfiguration() / bool AudioSettings.Reset(AudioConfiguration config) API는 현재 사운드 시스템 설정에 전역 변경을 읽고 적용할 수 있으며, 기본적으로는 프로퍼티가 수정되었을 때 전체 오디오 시스템을 다시 초기화하는 부작용이 있었던 AudioSettings.SetDSPBufferSize(…) 함수 및 AudioSettings.outputSampleRate, AudioSettings.speakerMode를 대체합니다.
API는 AudioSettings.OnAudioConfigurationChanged(부울 기기)를 정의하여 오디오 설정 변경을 스크립트가 알 수 있도록 콜백을 설정합니다. 이러한 변경 사항은 실제 기기 변경으로 인해 발생하거나 스크립트에서 시작된 설정으로 인해 발생할 수 있습니다.
전역 오디오 시스템 설정의 런타임을 수정할 때마다 모든 오디오 오브젝트를 다시 로드해야 한다는 점에 유의해야 합니다. 디스크 기반 AudioClip 에셋과 오디오 믹서에서는 동작하지만, 스크립트에서 생성하거나 수정한 AudioClip은 사라지고 다시 생성되어야 합니다. 마찬가지로 모든 재생 상태도 손실되므로 AudioSettings.OnAudioConfigurationChanged(…) 콜백에서 재생성해야 합니다.
세부 정보 및 예제를 보려면 스크립팅 API 레퍼런스를 참조하십시오.
AudioSettings