VideoFxProcessor오브젝트 구성

다음 표에는 구성할 수 있는 VideoFxProcessor 속성이 나열되어 있습니다. 아래 표의 예는 일반적인 런타임 구성을 보여줍니다.

백그라운드 블러

백그라운드 블러에는 다음 속성이 있습니다.

속성	유형	설명
isEnabled	boolean	이 true 경우 필터가 배경을 흐리게 합니다.
strength	string	흐림 정도를 결정합니다. 유효한 값: low | medium | high .

백그라운드 교체

백그라운드 교체에는 다음 파라미터가 사용됩니다.

속성	유형	설명
isEnabled	boolean	이 true 경우 필터가 배경을 대체합니다.
backgroundImageURL	string	배경 이미지의 URL입니다. 필터는 이미지 크기를 현재 화면 크기에 맞게 동적으로 조정합니다. 와 같은 https://... 문자열이나 과 같은 데이터 URL을 사용할 수 data:image/jpeg;base64 있습니다.
defaultColor	string	or와 같은 000000 16진수 FFFFFF 색상 문자열 또는 or와 같은 black 문자열 white 이미지 URL을 지정하지 않으면 프로세서가 를 defaultColor 배경으로 사용합니다. 지정하지 않으면 defaultColor 프로세서의 기본값은 검은색입니다.

런타임 시 구성 변경

videoFxProcessor.setEffectConfig파라미터를 사용하여 런타임 시 VideoFxProcessor 구성을 변경할 수 있습니다. 다음은 백그라운드 교체를 활성화하고 백그라운드 블러를 비활성화하는 방법을 보여 주는 예제입니다.

참고

한 번에 한 가지 유형의 백그라운드 교체만 지정할 수 있습니다. backgroundImageURL또는 의 값을 defaultColor 지정하되 둘 다 지정하지는 마십시오.

videoFxConfig.backgroundBlur.isEnabled = false;
videoFxConfig.backgroundReplacement.isEnabled = true;
try {
  await videoFxProcessor.setEffectConfig(videoFxConfig);
} catch(error) {
  logger.error(error.toString())
}

setEffectConfig예외가 발생하면 이전 컨피그레이션이 그대로 적용됩니다. setEffectConfig예외를 VideoFxProcessor.create 발생시키는 것과 유사한 조건에서 예외가 발생합니다.

다음은 비디오가 실행되는 동안 백그라운드 이미지를 변경하는 방법을 보여 주는 예제입니다.

videoFxConfig.backgroundReplacement.backgroundImageURL = "https://my-domain.com/my-other-image.jpg";
try {
  await videoFxProcessor.setEffectConfig(videoFxConfig);
} catch(error) {
  logger.error(error.toString())
}