공간 음향

공간 음향은 몰입감 있는 오디오 경험으로 보다 실감 나는 콘텐츠를 만들 수 있습니다. 소리는 "공간화됨" 서라운드 사운드와 비슷한 멀티 스피커 효과를 낼 수 있습니다. 헤드폰으로 설정하는 것이 좋습니다.

예를 들어 영화에서 자동차 소리가 사용자 뒤에서 시작되어 먼 쪽으로 향합니다. 영상 채팅에서 음성 명령: 화자를 더 쉽게 식별할 수 있도록 사용자 주위에 배치하게 합니다.

콘텐츠가 지원되는 오디오 형식을 사용하는 경우 서라운드 오디오를 앱에 적용됩니다.

기능 쿼리

Spatializer 클래스를 사용하여 다음 작업을 할 수 있습니다. 기기의 공간화 기능 및 동작을 쿼리할 수 있습니다. 검색하여 시작 Spatializer의 인스턴스를 AudioManager:

Kotlin

val spatializer = audioManager.spatializer

자바

Spatializer spatializer = AudioManager.getSpatializer();

Spatializer를 받은 후 충족해야 하는 네 가지 조건 확인 true로 설정해야 합니다.

기준 확인
기기에서 공간화를 지원하나요? getImmersiveAudioLevel()이(가) SPATIALIZER_IMMERSIVE_LEVEL_NONE이(가) 아닙니다.
공간화를 사용할 수 있나요?
사용 가능 여부는 현재 오디오 출력 라우팅과의 호환성에 따라 다릅니다.		 현재 isAvailable(): true
공간화가 사용 설정되어 있나요? 현재 isEnabled(): true
특정 매개변수를 사용하여 오디오 트랙을 공간화할 수 있나요? 현재 canBeSpatialized(): true

이러한 조건이 충족되지 않을 수 있습니다(예: 공간화를 사용할 수 없는 경우). 오디오 출력 장치에서 아예 비활성화되도록 할 수 있습니다.

머리 추적

지원되는 헤드셋을 사용하면 플랫폼에서 오디오의 사용자의 머리 위치에 기반한 공간화입니다. 헤드 추적기가 현재 오디오 출력 라우팅에 사용할 수 있는 isHeadTrackerAvailable()

호환 콘텐츠

Spatializer.canBeSpatialized() 드림 는 지정된 속성이 있는 오디오가 출력 장치의 라우팅입니다. 이 메서드는 AudioAttributes를 사용합니다. AudioFormat, 둘 다 아래에 자세히 설명되어 있습니다.

AudioAttributes

AudioAttributes 객체 자세한 내용은 제품의 사용법 오디오 스트림 (예: 게임 오디오) 또는 표준 미디어) 동영상의 재생 동작 및 콘텐츠 유형을 파악할 수 있습니다.

canBeSpatialized()를 호출할 때는 동일하게 사용합니다. Player에 대해 설정된 AudioAttributes 인스턴스 예를 들어 Jetpack Media3 라이브러리를 사용하고 있고 AudioAttributes, AudioAttributes.DEFAULT를 사용합니다.

서라운드 오디오 사용 중지

콘텐츠가 이미 공간화되었음을 나타내려면 setIsContentSpatialized(true) 드림 오디오가 이중 처리되지 않도록 합니다. 또는 다음을 호출하여 공간화를 완전히 사용 중지하는 공간화 동작 setSpatializationBehavior(AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER)

AudioFormat

AudioFormat 객체는 오디오 트랙의 형식 및 채널 구성에 대한 세부정보입니다.

AudioFormat를 인스턴스화하여 canBeSpatialized()에 전달할 때 encoding 설정 디코더에서 예상되는 출력 형식과 동일하게 될 것입니다. 또한 채널 마스크 해야 합니다. 자세한 내용은 기본 공간화 동작 섹션을 참조하세요. 특정 값을 지정할 수 있습니다.

Spatializer 변경사항 수신 대기

Spatializer 상태의 변경사항을 수신 대기하려면 리스너를 추가하면 됩니다. Spatializer.addOnSpatializerStateChangedListener() 사용 마찬가지로, 헤드 추적기 사용 가능 여부의 변경사항을 수신 대기하려면 Spatializer.addOnHeadTrackerAvailableListener()를 호출합니다.

재생 중에 트랙 선택을 조정하려는 경우 이 메서드를 호출할 수 있습니다. 예를 들어 사용자가 헤드셋, onSpatializerAvailableChanged 콜백은 새 광고에 스페이셜라이저 효과를 사용할 수 있는지 여부를 나타냅니다. 오디오 출력 라우팅을 지원합니다. 이 시점에서 플레이어의 기기의 새로운 기능과 일치하도록 선택 로직을 추적합니다. 자세한 내용은 ExoPlayer의 트랙 선택 동작(ExoPlayer 및 서라운드 오디오 참고) 섹션으로 이동합니다.

ExoPlayer 및 서라운드 오디오

최신 버전의 ExoPlayer를 사용하면 서라운드 오디오를 더 쉽게 채택할 수 있습니다. 독립형 ExoPlayer 라이브러리 (패키지 이름 com.google.android.exoplayer2) 버전 2.17은 서라운드 오디오를 출력하도록 플랫폼을 구성합니다. 2.18에는 오디오 채널 수 제약 조건이 도입되었습니다. Media3 라이브러리의 ExoPlayer 모듈을 사용하는 경우(패키지 이름) androidx.media3), 버전 1.0.0-beta01 최신 버전에 동일한 업데이트가 포함됩니다.

ExoPlayer 종속 항목을 최신 버전으로 업데이트하면 앱이 공간화할 수 있는 콘텐츠를 포함해야 합니다.

오디오 채널 수 제약

서라운드 오디오의 네 가지 조건 모두 충족되면 ExoPlayer에서 다중 채널 오디오 트랙입니다. 그렇지 않으면 ExoPlayer에서 대신 스테레오 트랙을 선택합니다. Spatializer 속성이 변경되면 ExoPlayer는 는 새로운 트랙 선택을 트리거하여 현재 속성 새로 선택한 트랙으로 인해 리버퍼링 기간입니다.

오디오 채널 수 제한을 사용 중지하려면 트랙 선택 매개변수를 설정하세요. 할 수 있습니다.

Kotlin

exoPlayer.trackSelectionParameters = DefaultTrackSelector.Parameters.Builder(context)
  .setConstrainAudioChannelCountToDeviceCapabilities(false)
  .build()

자바

exoPlayer.setTrackSelectionParameters(
  new DefaultTrackSelector.Parameters.Builder(context)
    .setConstrainAudioChannelCountToDeviceCapabilities(false)
    .build()
);

마찬가지로 기존 트랙 선택기의 매개변수를 업데이트하여 오디오 채널 수 제약이 있습니다.

Kotlin

val trackSelector = DefaultTrackSelector(context)
...
trackSelector.parameters = trackSelector.buildUponParameters()
  .setConstrainAudioChannelCountToDeviceCapabilities(false)
  .build()

자바

DefaultTrackSelector trackSelector = new DefaultTrackSelector(context);
...
trackSelector.setParameters(
  trackSelector
    .buildUponParameters()
    .setConstrainAudioChannelCountToDeviceCapabilities(false)
    .build()
);

콘텐츠에 여러 오디오가 있는 경우 오디오 채널 수 제약이 사용 중지된 상태에서 트랙에서 ExoPlayer는 처음에 채널 수가 가장 많은 트랙을 선택하고 기기에서 재생할 수 있습니다. 예를 들어 콘텐츠에 다중 채널 오디오 트랙과 스테레오 오디오 트랙이 있고 둘 다 재생하면 ExoPlayer가 다중 채널 트랙을 선택합니다. 자세한 내용은 이 동작을 맞춤설정하는 방법을 자세히 알아보려면 오디오 트랙 선택을 참고하세요.

오디오 트랙 선택

ExoPlayer의 오디오 채널 수 제한이 발생한 경우 동작이 사용 중지되면 ExoPlayer가 오디오 트랙을 자동으로 선택하지 않음 기기 스페이셜라이저의 속성과 일치하는 대신 트랙 선택을 설정하여 ExoPlayer의 트랙 선택 로직을 맞춤설정합니다. 재생 전이나 재생 도중에 매개변수 값을 설정해야 합니다. 기본적으로 ExoPlayer는 오디오를 선택합니다. MIME 유형과 관련하여 초기 트랙과 동일한 트랙 채널 수, 샘플링 레이트 등이 있습니다.

트랙 선택 매개변수 변경

ExoPlayer의 트랙 선택 매개변수를 변경하려면 다음을 사용합니다. Player.setTrackSelectionParameters() 마찬가지로 다음 명령어로 ExoPlayer의 현재 매개변수를 가져올 수 있습니다. Player.getTrackSelectionParameters() 예를 들어 재생 중에 스테레오 오디오 트랙을 선택하는 방법은 다음과 같습니다.

Kotlin

exoPlayer.trackSelectionParameters = exoPlayer.trackSelectionParameters
  .buildUpon()
  .setMaxAudioChannelCount(2)
  .build()

자바

exoPlayer.setTrackSelectionParameters(
  exoPlayer.getTrackSelectionParameters()
    .buildUpon()
    .setMaxAudioChannelCount(2)
    .build()
);

재생 중에 트랙 선택 매개변수를 변경하면 재생이 중단될 수 있습니다. 플레이어 트랙 조정에 대한 추가 정보 선택 매개변수는 트랙 선택 ExoPlayer 문서의 섹션입니다.

기본 공간화 동작

Android의 기본 공간화 동작에는 다음 동작이 포함됩니다. 다음과 같습니다.

  • 스테레오 콘텐츠가 아닌 다중 채널 콘텐츠만 공간화됩니다. ExoPlayer를 사용하지 않는 경우 다중 채널 형식에 따라 오디오 콘텐츠의 경우 최대 채널 수를 출력될 수 있는 80비트 숫자입니다. 이렇게 하면 오디오 디코더는 플랫폼이 공간화할 수 있도록 다중 채널 PCM을 출력합니다.

    Kotlin

    val mediaFormat = MediaFormat()
mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99)

    자바

    MediaFormat mediaFormat = new MediaFormat();
mediaFormat.setInteger(MediaFormat.KEY_MAX_OUTPUT_CHANNEL_COUNT, 99);

    실제 예는 ExoPlayer의 MediaCodecAudioRenderer.java를 참고하세요. OEM에 관계없이 공간화를 직접 사용 중지하는 방법 맞춤설정에 관한 자세한 내용은 서라운드 오디오 사용 중지를 참고하세요.

  • AudioAttributes: 오디오가 공간화될 수 있음 usage가 다음 중 하나로 설정됩니다. USAGE_MEDIA 또는 USAGE_GAME.

  • AudioFormat: AudioFormat.CHANNEL_OUT_QUAD 오디오의 모든 채널 (앞-왼쪽, 전면 오른쪽, 후면-왼쪽, 오른쪽)을 사용할 수 있습니다. 아래 예에서는 AudioFormat.CHANNEL_OUT_5POINT1를 사용합니다. 5.1 오디오 트랙이 필요합니다. 스테레오 오디오 트랙의 경우 AudioFormat.CHANNEL_OUT_STEREO를 사용합니다.

    Media3을 사용하는 경우 Util.getAudioTrackChannelConfig(int channelCount)를 사용할 수 있습니다. 채널 마스크로 변환할 수 있습니다.

    또한 인코딩을 AudioFormat.ENCODING_PCM_16BIT로 설정합니다. 다중 채널 PCM을 출력하도록 디코더를 구성한 경우입니다.

    Kotlin

    val audioFormat = AudioFormat.Builder()
  .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
  .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
  .build()

    자바

    AudioFormat audioFormat = new AudioFormat.Builder()
  .setEncoding(AudioFormat.ENCODING_PCM_16BIT)
  .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
  .build();

서라운드 오디오 테스트

테스트 기기에서 서라운드 오디오가 사용 설정되어 있는지 확인합니다.

  • 유선 헤드셋의 경우 시스템 설정 > 소리 및 진동 > 공간 오디오를 사용합니다.
  • 무선 헤드셋의 경우 시스템 설정 > 연결된 기기 > 톱니바퀴 아이콘 > 공간 음향

현재 경로에 대한 공간 음향 사용 가능 여부를 확인하려면 다음을 실행합니다. adb shell dumpsys audio 명령어를 사용하세요. 다음과 같이 표시됩니다. 매개변수가 포함됩니다.

Spatial audio:
mHasSpatializerEffect:true (effect present)
isSpatializerEnabled:true (routing dependent)