設定 VideoFxProcessor object

下表列出您可以設定的VideoFxProcessor屬性。下表的範例顯示典型的執行期組態。

背景模糊

背景模糊具有下列屬性：

屬性	Type	描述
isEnabled	boolean	當 時true，篩選條件會模糊背景。
strength	string	決定模糊的程度。有效值：low | medium | high .

背景替換

背景替換採用下列參數：

屬性	Type	描述
isEnabled	boolean	當 時true，篩選條件會取代背景。
backgroundImageURL	string	背景映像URL的 。篩選條件會將影像動態調整為目前畫面的維度。您可以使用字串，例如 https://...或資料，URL例如 data:image/jpeg;base64。
defaultColor	string	十六進位顏色字串，例如 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())
}