구성 VideoFxProcessor 객체 - Amazon Chime SDK

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

  구성 VideoFxProcessor 객체

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

배경 흐림

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

속성

유형

설명

isEnabled

boolean

true인 경우 필터가 배경을 흐리게 합니다.

strength

string

흐림 정도를 결정합니다. 유효한 값: low | medium | high

.
배경 교체

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

속성

유형

설명

isEnabled

boolean

true인 경우 필터가 배경을 대체합니다.

backgroundImageURL

string

백그라운드 이미지URL의 . 이 필터는 현재 화면의 크기에 맞게 이미지 크기를 동적으로 조정합니다. 와 같은 문자열 https://... 또는 와 URL 같은 데이터를 사용할 수 있습니다data:image/jpeg;base64.

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())
}