# SetFilterEffectOptions (/zh-CN/api-reference/rtc/csharp-windows/api-irtcengine-setfiltereffectoptions)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="api_irtcengine_setfiltereffectoptions__prototype"></a>

```csharp
public abstract int SetFilterEffectOptions(bool enabled, FilterEffectOptions options, MEDIA_SOURCE_TYPE type = MEDIA_SOURCE_TYPE.PRIMARY_CAMERA_SOURCE);
```

<a id="api_irtcengine_setfiltereffectoptions__detailed_desc"></a>

<a id="api_irtcengine_setfiltereffectoptions__timing"></a>

## 调用时机 [#调用时机]

请在 [EnableVideo](/zh-CN/api-reference/rtc/csharp-windows/video/video-basic#api_irtcengine_enablevideo) 之后调用该方法。

<a id="api_irtcengine_setfiltereffectoptions__restriction"></a>

## 调用限制 [#调用限制]

- 该方法依赖于视频增强动态库 `libagora_clear_vision_extension.dll`，如果删除该动态库会导致无法正常开启该功能。
- 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。

<a id="api_irtcengine_setfiltereffectoptions__parameters"></a>

## 参数 [#参数]

<ParameterList>
<a id="enabled"></a>
<Parameter name="enabled">

是否开启滤镜效果：

- `true`: 开启滤镜功能。
- `false`:（默认）关闭滤镜功能。

</Parameter>
<a id="options"></a>
<Parameter name="options">

滤镜选项，详见 [FilterEffectOptions](/zh-CN/api-reference/rtc/csharp-windows/class-filtereffectoptions)。

</Parameter>
<a id="type"></a>
<Parameter name="type">

效果应用的媒体源类型。详见 [MEDIA_SOURCE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-mediasourcetype)。

:::caution
注意： 在该方法中，该参数仅支持以下两种设置：

- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
:::

</Parameter>
</ParameterList>

<a id="api_irtcengine_setfiltereffectoptions__return_values"></a>

## 返回值 [#返回值]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。