애플리케이션 AEC 레퍼런스
상황에 따라 오디오를 스피커로 출력하기 전에 사운드 효과를 믹스하는 등 편집하고 싶을 수 있습니다. 이때 믹스한 사운드 효과가 로컬 마이크에 반향(echo)을 일으킬 수 있습니다. 믹스한 사운드 효과는 PlanetKit의 AEC(acoustic echo canceller) 모듈로 제거하지 못합니다.
애플리케이션 AEC 레퍼런스를 사용하여 이러한 믹스한 사운드 효과를 제거할 수 있습니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | PlanetKit 3.8 |
애플리케이션 AEC 레퍼런스 사용 방법
다음과 같은 절차로 애플리케이션 AEC 레퍼런스를 사용할 수 있습니다.
startUserAcousticEchoCancellerReference()를 호출합니다.- 레퍼런스 오디오 데이터를 제공하려면
AudioSink의 구현 코드에서putUserAcousticEchoCancellerReference()를 레퍼런스 오디오 데이터와 함께 호출합니다. - 레퍼런스 오디오 데이터 제공을 중지하려면
stopUserAcousticEchoCancellerReference()를 호출합니다.
인터페이스 변경
다음 표는 애플리케이션 AEC 레퍼런스와 관련된 API의 변경 사항을 보여줍니다.
| PlanetKit 버전 | 지원 메서드 | 비고 |
|---|---|---|
| 5.2 이상 | startUserAcousticEchoCancellerReference()putUserAcousticEchoCancellerReference()stopUserAcousticEchoCancellerReference() | API 네이밍이 변경되었습니다. |
| 3.8부터 5.1까지 | startAECReferenceData()putAECReferenceData()stopAECReferenceData() | useAECReference가 제거되었습니다. |
| 3.7 | putAECReferenceData() | 애플리케이션 AEC 레퍼런스를 사용하려면 1대1 통화 파라미터 또는 그룹 통화 파라미터에서 useAECReference를 true로 설정하세요. |
관련 API
애플리케이션 AEC 레퍼런스와 관련된 API는 다음과 같습니다.
1대1 통화
-
PlanetKitCall의startUserAcousticEchoCancellerReference() -
AudioSink의putUserAcousticEchoCancellerReference() -
PlanetKitCall의stopUserAcousticEchoCancellerReference()