Loading...

    虚拟背景及美颜滤镜

    功能说明 (支持版本:v3.3及以上)

    虚拟背景：小鱼SDK封装了成熟的头肩分割算法和切换视频画面背景的功能，共提供三种背景模式，无虚拟背景，背景虚化，自定义背景图片。

    只支持JPG格式背景图，且1280*720尺寸的背景图最佳。

    美颜：小鱼SDK封装了磨皮，美白，红润效果。

    滤镜：小鱼SDK封装了多种滤镜效果供使用，具体参考demo示例代码

    实现方法

    虚拟背景：OnGPUBlackInfo回调后，通过​​GetGPUInfo​​​获取GPU信息，将获取的信息与OnGPUBlackInfo回调数据进行对比，剔除不支持的GPU后，通过​​SetGpusEnable​​​设置可用的GPU信息。 入会前或入会后都可以通过 ​​SetVirtualBgMode ​​​来设置虚拟背景的样式, 其中虚拟背景模式分别有三种定义 0: 无、1: 背景模糊、 2: 自定义虚拟背景图片，当选择图片作为背景时， 通过​​SetVirtualBgImg​​设置图片路径。

    美颜：通过​​SetVideoEffect​​方法设置美颜类型及对应值，参数值详见demo示例的BeautyEffectType

    滤镜：通过​​SetVideoEffect​​方法设置美颜类型及对应值，参数值详见demo示例的FilterEffectType

    基础接口使用（详情请查阅Demo示例代码）：

    相关接口描述

    //设置能否获取多个本地视频窗口，alwaysShow true可显示多个本地视频窗口
    void SetDuplicateRenderAlwaysShow(bool alwaysShow)

    //获取本地视频窗口
    FrameworkElement GetVideoElement4LocalDuplicate();

    //获取本地视频预览窗口
     FrameworkElement GetVideoElement4LocalDuplicatePreview();

    //设置虚拟背景模式
    void SetVirtualBgMode(SDKVirtualBackgroundMode mode);

    //设置虚拟背景图片路径，path ：图片路径
    void SetVirtualBgImg(string path);

    //设置美颜或滤镜 effectType为美颜或滤镜类型
    void SetVideoEffect(string effectType, int effectLevel);

    //根据userid获取该用户之前设置的虚拟背景及美颜状态
    string GetUserVirBgBeautyFilterInfo(string userid);

    //根据userid添加或者更新该用户设置的虚拟背景及美颜状态
    bool UpdateOrAddUserVirBgBeautyFilterInfo(string userid, string info);

    //根据userid获取用户添加的自定义图片数据
    List<SDKUserUploadImgInfo> GetUserUploadVirBgImgs(string userid);

    //根据userid添加自定义图片信息
    bool AddVirBgImgInfo(string userid, string imgPath, string imgGuid);

    //根据userid删除自定义图片信息
    bool DelUserVirBgImgInfo(string userid, string imgGuid);

    //获取GPU信息，通过OnGPUInfoResult回调结果
    void GetGPUInfo();

    //设置可用的GPU信息
    void SetGpusEnable(string[] gpus);

    备注：SDk提供了虚拟背景状态的记录接口，状态存储在本地，具体使用可参考demo示例代码。

    回调方法

    //通过GetGPUInfo回调的GPU信息
    void OnGPUInfoResult(string[] gInfo);

    //暂不支持的虚拟背景的GPU信息集合
    void OnGPUBlackInfo(string[] gInfo);

    API参考

    更多接口，请查阅​​API概览​​-​​虚拟背景及美颜​​

    2023-07-14 18:07:59
    导出PDF文档
    意见反馈