Version: 5.5

가상 배경

영상 통화에서 가상 배경(virtual background) 기능을 이용해 배경을 흐리게 하거나 이미지로 대체할 수 있습니다. 여기서는 가상 배경 기능을 사용하는 방법을 설명합니다.

지원 통화 유형	최소 SDK 버전
1대1 통화, 그룹 통화(컨퍼런스)	PlanetKit 5.4

Note

가상 배경 기능은 다음과 같은 장치 및 운영 체제 버전과 호환됩니다.

iOS: iPhone 12 및 이후 모델, iOS 15 이상
macOS: Apple 실리콘 프로세서가 탑재된 Apple 데스크톱 및 노트북, macOS 12 이상

Warning

가상 배경 효과를 적용하면 CPU 사용량이 증가합니다.

개요

가상 배경 기능을 사용하려면 계산된 속성(computed property)인 PlanetKitCameraManager.shared.virtualBackground를 PlanetKitVirtualBackground 클래스와 함께 사용하세요.

흐린 배경 설정하기

배경에 흐림(blur) 효과를 적용하려면 PlanetKitVirtualBackground(blurRadius:) 메서드를 사용하여 PlanetKitCameraManager.shared.virtualBackground를 설정하세요.

let blurRadius: Float
PlanetKitCameraManager.shared.virtualBackground = PlanetKitVirtualBackground(blurRadius: blurRadius)

blurRadius 파라미터는 가상 배경에 적용되는 가우시안 블러(Gaussian blur)의 반경을 결정합니다. blurRadius의 권장 기본값은 15.0이며, blurRadius가 클수록 결과는 더 흐릿해집니다.

이미지 배경 설정하기

배경을 이미지로 교체하려면 PlanetKitVirtualBackground(image:) 메서드를 사용하여 PlanetKitCameraManager.shared.virtualBackground를 설정하세요.

let uiImage = UIImage(named: "BackgroundImage")
let image = CIImage(image: uiImage)
PlanetKitCameraManager.shared.virtualBackground = PlanetKitVirtualBackground(image: image)

가상 배경 유형 확인하기

현재 사용 중인 가상 배경의 유형은 PlanetKitCameraManager.shared.virtualBackground.type으로 확인할 수 있습니다. 반환된 PlanetKitVirtualBackgroundType은 none, blur, image 중 하나입니다.

let currentVirtualBackgroundType = PlanetKitCameraManager.shared.virtualBackground?.type ?? .none

가상 배경 해제하기

가상 배경을 해제하려면 PlanetKitCameraManager.shared.virtualBackground를 nil로 설정하세요.

PlanetKitCameraManager.shared.virtualBackground = nil

개요​

흐린 배경 설정하기​

이미지 배경 설정하기​

가상 배경 유형 확인하기​

가상 배경 해제하기​

관련 API​

개요

흐린 배경 설정하기

이미지 배경 설정하기

가상 배경 유형 확인하기

가상 배경 해제하기

관련 API