Version: 5.5

가상 배경

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

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

Note

PlanetKit 5.5.1부터 PlanetKitPluginProviderVirtualBackground 클래스는 별도의 플러그인(plugin-virtualbackground)으로 제공됩니다.

Warning

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

개요

PlanetKitPluginVirtualBackground 클래스에서 가상 배경 기능을 위한 API를 제공합니다. 가상 배경 기능을 위한 API를 사용하려면 사용하는 SDK 버전에 따라 아래 절차를 따르세요.

PlanetKit 5.5.1 이상

build.gradle 파일에 아래 종속성을 추가하세요.

implementation ('com.linecorp.planetkit:plugin-virtualbackground:1.0.0') {
  exclude group: 'com.linecorp.planetkit', module: 'planetkit'
}

가상 배경 플러그인을 적용하세요.

val plugin = PlanetKitPluginProviderVirtualBackground.getPlugin()
PlanetKit.getCameraManager().setVirtualBackgroundPlugin(plugin)

PlanetKit 5.5.0

가상 배경 플러그인을 적용하세요.

val plugin = PlanetKitPluginProviderVirtualBackground.getPlugin()
PlanetKit.getCameraManager().setVirtualBackgroundPlugin(plugin)

흐린 배경 설정하기

배경에 흐림(blur) 효과를 적용하려면 setVirtualBackgroundWithBlur() 메서드를 호출하세요.

plugin.setVirtualBackgroundWithBlur()

setVirtualBackgroundWithBlur() 메서드에는 가상 배경에 적용되는 가우시안 블러(Gaussian blur)의 반경을 결정하는 radius를 인자로 전달할 수 있습니다. radius는 1부터 25까지 값으로 설정할 수 있으며 기본값은 15입니다. radius가 클수록 결과는 더 흐릿해집니다.

이미지 배경 설정하기

배경을 이미지로 교체하려면 Bitmap 이미지를 인자로 하여 setVirtualBackgroundWithImage() 메서드를 호출하세요.

val backgroundImage: Bitmap
plugin.setVirtualBackgroundWithImage(backgroundImage)

가상 배경 유형 확인하기

현재 사용 중인 가상 배경의 유형을 확인하려면 getCurrentVirtualBackgroundType() 메서드를 호출하세요. 반환된 VirtualBackgroundType은 NONE, BLUR, IMAGE 중 하나입니다.

val backgroundType = plugin.getCurrentVirtualBackgroundType()

가상 배경 해제하기

가상 배경을 해제하려면 clearVirtualBackground() 메서드를 호출하세요.

plugin.clearVirtualBackground()

개요​

PlanetKit 5.5.1 이상​

PlanetKit 5.5.0​

흐린 배경 설정하기​

이미지 배경 설정하기​

가상 배경 유형 확인하기​

가상 배경 해제하기​

관련 API​

개요