가상 배경
영상 통화에서 가상 배경(virtual background) 기능을 이용해 배경을 흐리게 하거나 이미지로 대체할 수 있습니다. 여기서는 가상 배경 기능을 사용하는 방법을 설명합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | 1대1 통화: 0.8 그룹 통화: 0.9 |
Note
iOS 앱의 경우, 가상 배경 기능은 다음과 같은 장치 및 운영 체제 버전과 호환됩니다.
- iPhone 12 및 이후 모델, iOS 15 이상
Warning
가상 배경 효과를 적용하면 CPU 사용량이 증가합니다.
개요
PlanetKitCamera 클래스에서 가상 배경 기능을 위한 API를 제공합니다. 싱글턴 객체인 PlanetKitCamera.instance로 API를 사용할 수 있습니다.
흐린 배경 설정하기
배경에 흐림(blur) 효과를 적용하려면 setVirtualBackgroundWithBlur() 메서드를 호출하세요.
int radius = 15;
PlanetKitCamera.instance.setVirtualBackgroundWithBlur(radius)
setVirtualBackgroundWithBlur() 메서드에는 가상 배경에 적용되는 가우시안 블러(Gaussian blur)의 반경을 결정하는 radius를 인자로 전달할 수 있습니다. radius는 1부터 25까지 값으로 설정할 수 있으며 기본값은 15입니다. radius가 클수록 결과는 더 흐릿해집니다.
이미지 배경 설정하기
배경을 이미지로 교체하려면 이미지 URI 문자열을 인자로 setVirtualBackgroundWithImage() 메서드를 호출하세요.
String fileUri = "URI_TO_IMAGE";
PlanetKitCamera.instance.setVirtualBackgroundWithImage(fileUri)
가상 배경 해제하기
가상 배경을 해제하려면 clearVirtualBackground() 메서드를 호출하세요.
PlanetKitCamera.instance.clearVirtualBackground()
관련 API
가상 배경 기능과 관련된 API는 다음과 같습니다.