Amazon Chime SDK용 VideoFxProcessor 객체 구성

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

배경 흐림

배경 흐림에는 다음 속성이 있습니다.

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

배경 교체

배경 교체에는 다음 파라미터가 사용됩니다.

속성	유형	설명
isEnabled	boolean	true인 경우 필터가 배경을 대체합니다.
backgroundImageURL	string	배경 이미지의 URL입니다. 이 필터는 현재 화면의 크기에 맞게 이미지 크기를 동적으로 조정합니다. https://...와 같은 문자열 또는 data:image/jpeg;base64와 같은 데이터 URL을 사용할 수 있습니다.
defaultColor	string	16진수 색상 문자열(예: 000000 또는 FFFFFF) 또는 문자열(예: 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())
}