기술 자료

지원

Vivox Unity SDK

Vivox Unity SDK

In Game Control Audio Levels

Allow players to control voice and audio levels in-game.
읽는 시간 1분최근 업데이트: 14시간 전

Vivox SDK를 사용하면 게임 내에서 오디오 입력 및 출력 레벨을 제어할 수 있습니다. 다음은 게임 내 오디오 레벨 제어 기능 구현이 필요한 여러 시나리오 예제에 대한 설명입니다.
  • 사용자가 게임 음향 및 음성 출력의 음량 수준을 서로 다르게 설정하길 원합니다.
  • 사용자가 음성 입력의 음량을 조정하길 원합니다.
  • 사용자가 전체 채널의 음량을 조정하길 원합니다.
  • 사용자가 채널에 함께 있는 다른 사람의 음량을 조정하길 원합니다.
음량 설정으로 디바이스 또는 참가자의 소리 크기를 조정합니다. 모든 음량 설정은 -50~50 사이의 로그 스케일로 설정 가능한 범위를 가지며 0일 때 +0db(따로 변경하지 않는 경우)입니다. 로그 스케일이므로 사용 가능한 범위는 일반적으로 -10에서 25이며 25 이상은 캡처 디바이스 변조 범위를 넘어서므로 헤드셋 사용자의 불편을 초래할 수 있습니다. 기본값 이상으로 음량을 높이면 낮은 수준에서는 들리지 않던 소리 왜곡 현상이 발생할 수 있습니다.

로컬 사용자 입력 및 출력 디바이스 음량 조정

Vivox Unity SDK는 입력 및 출력 디바이스 오디오 레벨을 설정하기 위해 다음 메서드를 사용합니다.
  • VivoxService.Instance.SetInputDeviceVolume(int value)
    • 입력 디바이스(마이크)의 클라이언트 측 음량을 설정합니다.
    • 음량은 -50부터 50까지 설정할 수 있으며 음수는 음량을 줄이는 것을, 양수는 음량을 높이는 것을 나타냅니다.
    • 이 값은 모든 채널에 영향을 미칩니다.
  • VivoxService.Instance.SetOutputDeviceVolume(int value)
    • 컴퓨터의 오디오 디바이스에서 재생되는 모든 Vivox 음성 오디오에 대한 클라이언트 측 음량을 설정합니다.
    • 음량은 -50부터 50까지 설정할 수 있으며 음수는 음량을 줄이는 것을, 양수는 음량을 높이는 것을 나타냅니다.
    • 이 값은 모든 채널에 영향을 미칩니다.

채널 참가자의 음량 조정

Vivox Unity SDK는 사용자가 속한 채널에서 개별 플레이어의 음량을 설정하기 위해 다음 메서드를 사용합니다.
  • VivoxParticipant.SetLocalVolume(int volume)
    • 채널의 개별 참가자의 Vivox 음성 오디오에 대한 클라이언트 측 음량을 설정합니다.
    • 음량은 -50부터 50까지 설정할 수 있으며 음수는 참가자의 음량을 줄이는 것을, 양수는 참가자의 음량을 높이는 것을 나타냅니다.
    • VivoxParticipant
      오브젝트에 대한 자세한 내용은 참가자 관리 기술 자료를 참고하시기 바랍니다.

채널의 음량 조정

Vivox Unity SDK는 채널의 음량을 설정하기 위해 다음 메서드를 사용합니다.
  • VivoxService.Instance.SetChannelVolumeAsync(string channelName, int value)
    • 특정 채널에서 재생되는 모든 Vivox 음성 오디오에 대한 클라이언트 측 음량을 설정합니다.
    • 음량은 -50부터 50까지 설정할 수 있으며 음수는 채널에서 들어오는 모든 오디오의 음량을 줄이는 것을, 양수는 음량을 높이는 것을 나타냅니다.