오디오 출력 변경 처리

사용자는 오디오 앱의 볼륨을 제어할 수 있을 것으로 기대합니다. 표준 동작에는 볼륨 컨트롤 (기기의 버튼이나 손잡이 또는 UI의 슬라이더)을 사용하고 헤드폰과 같은 주변기기가 사용 중에 연결 해제되어 갑자기 큰 소리가 나지 않게 하는 기능이 포함됩니다.

볼륨 컨트롤 사용

사용자가 게임이나 음악 앱에서 볼륨 키를 누르면 볼륨이 변경되어야 합니다. 플레이어가 노래 사이에 일시중지되거나 현재 게임 위치에 맞는 음악이 없는 경우에도 마찬가지입니다.

Android는 음악, 알람, 알림, 수신 전화 벨소리 장치, 시스템 사운드, 통화 중 볼륨, DTMF 신호음을 재생하는 데 별도의 오디오 스트림을 사용합니다. 이를 통해 사용자는 각 스트림의 볼륨을 독립적으로 제어할 수 있습니다.

기본적으로 볼륨 컨트롤을 누르면 활성 오디오 스트림의 볼륨이 변경됩니다. 앱에서 현재 재생 중인 항목이 없는 경우 볼륨 키를 누르면 음악 볼륨 (또는 Android 9 이전의 벨소리 장치 볼륨)이 조정됩니다.

앱이 알람 시계가 아니라면 AudioAttributes.USAGE_MEDIA를 사용하여 오디오를 재생해야 합니다.

볼륨 컨트롤이 올바른 스트림을 조정하도록 하려면 AudioAttributes.getVolumeControlStream에서 가져올 수 있는 속성과 일치하는 스트림 유형을 전달하는 setVolumeControlStream()를 호출해야 합니다.

Kotlin

setVolumeControlStream(AudioManager.STREAM_MUSIC)

Java

setVolumeControlStream(AudioManager.STREAM_MUSIC);

앱의 수명 주기에서 일반적으로 미디어를 제어하는 활동 또는 프래그먼트의 onResume() 메서드에서 이 호출을 실행합니다. 이렇게 하면 타겟 활동이나 프래그먼트가 표시될 때마다 볼륨 컨트롤이 STREAM_MUSIC에 연결됩니다.

프로그래밍 방식으로 스트림 볼륨 제어

드문 경우이지만 오디오 스트림의 볼륨을 프로그래밍 방식으로 설정할 수도 있습니다. 예를 들어 앱이 기존 UI를 대체하는 경우입니다. 이 방법은 권장되지 않습니다. Android AudioManager가 동일한 유형의 모든 오디오 스트림을 함께 혼합하기 때문입니다. 다음 메서드는 스트림을 사용하는 모든 앱의 볼륨을 변경하므로 사용하지 않는 것이 좋습니다.

고정 볼륨 기기 작업

Chromebook과 같은 일부 기기에는 볼륨 컨트롤이 있지만 앱이 위에서 설명한 AudioManager 메서드를 사용하여 오디오 스트림의 수준을 변경할 수 없습니다. 이를 고정 볼륨 기기라고 합니다. isVolumeFixed()를 호출하여 앱이 고정 볼륨 기기에서 실행 중인지 확인할 수 있습니다.

오디오 앱은 동일한 스트림에서 재생될 수 있는 다른 앱과 출력 볼륨의 균형을 맞출 수 있어야 합니다. 고정 볼륨 기기에서 앱은 자체 볼륨 컨트롤을 아래 표의 적절한 setVolume() 메서드에 연결해야 합니다.

선수 메서드
AudioTrack AudioTrack.setVolume()
MediaPlayer MediaPlayer.setVolume()
ExoPlayer 기본 AudioTrack의 볼륨을 설정하는 SimpleExoPlayer.setVolume()을 사용합니다.

큰 소리 차단

사용자는 여러 가지 방법으로 Android 기기에서 오디오를 즐길 수 있습니다. 대부분의 기기에는 스피커와 유선 헤드셋용 헤드폰 잭이 내장되어 있으며 블루투스 연결과 A2DP 오디오 지원도 제공됩니다.

헤드셋이 분리되거나 블루투스 기기가 연결 해제되면 오디오 스트림은 내장 스피커로 자동 라우팅됩니다. 높은 볼륨으로 음악을 듣는 경우 놀라울 정도로 시끄러울 수 있습니다.

이 경우 사용자는 일반적으로 화면 재생 컨트롤이 있는 음악 플레이어가 포함된 앱이 재생을 일시중지할 것으로 기대합니다. 컨트롤이 포함되지 않은 게임과 같은 다른 앱은 계속 재생됩니다. 사용자는 기기의 하드웨어 컨트롤을 사용하여 볼륨을 조정할 수 있습니다.

오디오 출력이 내장 스피커로 다시 전환되면 시스템은 ACTION_AUDIO_BECOMING_NOISY 인텐트를 브로드캐스트합니다. 오디오를 재생할 때마다 이 인텐트를 수신 대기하는 BroadcastReceiver를 만들어야 합니다. Receiver는 다음과 같습니다.

Kotlin

private class BecomingNoisyReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action == AudioManager.ACTION_AUDIO_BECOMING_NOISY) {
            // Pause the playback
        }
    }
}

Java

private class BecomingNoisyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
      if (AudioManager.ACTION_AUDIO_BECOMING_NOISY.equals(intent.getAction())) {
          // Pause the playback
      }
    }
}

재생을 시작할 때 Receiver를 등록하고 중지할 때 등록을 취소합니다. 이 가이드에 설명된 대로 앱을 설계하면 이러한 호출이 onPlay()onStop() 미디어 세션 콜백에 표시되어야 합니다.

Kotlin

private val intentFilter = IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY)
private val myNoisyAudioStreamReceiver = BecomingNoisyReceiver()

private val callback = object : MediaSessionCompat.Callback() {

    override fun onPlay() {
        registerReceiver(myNoisyAudioStreamReceiver, intentFilter)
    }

    override fun onStop() {
        unregisterReceiver(myNoisyAudioStreamReceiver)
    }
}

Java

private IntentFilter intentFilter = new IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
private BecomingNoisyReceiver myNoisyAudioStreamReceiver = new BecomingNoisyReceiver();

MediaSessionCompat.Callback callback = new
MediaSessionCompat.Callback() {
  @Override
  public void onPlay() {
    registerReceiver(myNoisyAudioStreamReceiver, intentFilter);
  }

  @Override
  public void onStop() {
    unregisterReceiver(myNoisyAudioStreamReceiver);
  }
}