腾讯特效SDKuniapp_音视频解决方案_同尘科技

腾讯特效SDK 2年前 (2023-12-19) 浏览 270

腾讯特效 SDK uni-app 版本核心接口类 XmagicApi,用于更新美颜数值、调用动效等功能。

接口说明:

API 描述
setResPath 设置资源存放的路径,用于把美颜资源复制到此路径下,如果不设置此路径,SDK 内部会有一个默认路径
copyXmaigcRes 初始化美颜,用于复制美颜资源
setLicense 美颜鉴权
setLogLevel 设置日志级别
enableCustomVideoProcess 打开或关闭美颜
onResume 恢复美颜
onPause 暂停美颜
updateProperty 设置美颜属性效果
enableEnhancedMode 开启美颜增强模式(V2.5.1新增)。默认未开启。未开启时,应用层可以设置的各美颜项的强度范围为0到1或-1到1,如果超出此范围,SDK 会取边界值。例如应用层设置瘦脸为1.2,SDK 判断其超出了最大值1.0,则在内部把瘦脸值修正为1.0。开启增强模式后,应用层可以设置更大范围的数值。例如想要瘦脸程度更大,则可以把瘦脸值设置为1.2,SDK会接受并使用1.2这个数值,不会将其修正为1.0。说明:开启增强模式后,需要应用层自己管理每个美颜项可以设置的最大值,让用户在此范围内调整数值。我们提供了一份 参考值,您可以根据产品需求自由调整,但不建议超出我们的推荐值,否则美颜效果可能变差。
setDowngradePerformance 调用此方法开启高性能模式。高性能模式开启后,美颜占用的系统 CPU/GPU 资源更少,可减少手机的发热和卡顿现象,更适合低端机长时间使用。此方法需要在 enableCustomVideoProcess 方法之前调用
setAudioMute 设置静音
setFeatureEnableDisable 开启某些特性
addAiMode 添加 AI 模型文件,将下载好的AI模型文件复制到对应的文件夹下。如果 AI 模型放在工程中,则不需要调用此接口
setLibPathAndLoad 动态加载网络下载的 so 文件,这里只需要出入存放 so 的文件夹即可,仅支持 Android
on 订阅 SDK 的回调事件
off 取消订阅的事件

成员函数说明

setResPath

设置资源存放的路径,用于把美颜资源复制到此路径下,如果不设置此路径,SDK 内部会有一个默认路径。

 /**     * 设置存放美颜资源的路径,     * @param {String} resourceDir 用于存放美颜资源的路径文件夹(绝对路径),可参考demo     */    static setResPath(resourceDir)

参数

参数 含义
resourceDir 资源文件放置的目录

copyXmaigcRes

用于复制美颜资源。

/**     * 用于复制美颜资源     * @param {Function(result)} callback  result===true表示成功,false 表示失败     */    static copyXmaigcRes(callback)

参数

参数 含义
callback 由于资源复制是耗时任务,处理完成之后通过此接口回调结果

setLicense

进行美颜鉴权,app 启动之后,需要成功鉴权一次才能使用美颜功能。

 /**     * 鉴权     * @param {String} licenseUrl     * @param {String} licenseKey     * @param {Function(code,message)} callback code===0表示成功,其他错误码请参考     */    static setLicense(licenseUrl, licenseKey, callback)

参数

参数 含义
licenseUrl 官网申请的用于美颜鉴权的 licenseUrl
licenseKey 官网申请的用于美颜鉴权的 licenseKey
callback 鉴权结果回调方法,code==0表示鉴权成功

setLogLevel

设置 native SDK 的日志级别。

 /**     * 设置日志级别     * @param {number} logLevel 参见{@link LogLevel}     */    static setLogLevel(logLevel)
参数 含义
logLevel 日志级别,具体参考 SDK 中的 LogLevel

enableCustomVideoProcess

开启或关闭美颜。

   /**     * 打开或关闭美颜     * @param {boolean} enable     * @returns     */    static enableCustomVideoProcess(enable) 
参数 含义
enable 开启或关闭美颜,true 表示开启美颜,false 表示关闭美颜

onResume

恢复美颜处理。

   static onResume()

onPause

暂停美颜处理。

    static onPause()

updateProperty

设置美颜属性。

   /**     * 设置美颜属性     * @param {null} property     */    static updateProperty(property)
参数 含义
property 美颜参数信息,具体参数请参考 美颜参数说明 Android 和 美颜参数说明 iOS

enableEnhancedMode

开启美颜增强模式。默认未开启。未开启时,应用层可以设置的各美颜项的强度范围为0到1或-1到1,如果超出此范围,SDK 会取边界值。例如应用层设置瘦脸为1.2,SDK 判断其超出了最大值1.0,则在内部把瘦脸值修正为1.0。开启增强模式后,应用层可以设置更大范围的数值。例如想要瘦脸程度更大,则可以把瘦脸值设置为1.2,SDK 会接受并使用1.2这个数值,不会将其修正为1.0。开启增强模式后,需要应用层自己管理每个美颜项可以设置的最大值,让用户在此范围内调整数值。我们提供了一份参考值,您可以根据产品需求自由调整,但不建议超出我们的推荐值,否则美颜效果可能变差。参考值见下:

美颜项名称 增强模式下,建议的最大值(放大倍数)
美白,短脸,V脸,眼距,鼻子位置,祛法令纹,口红,立体 1.3
亮眼 1.5
腮红 1.8
其他 1.2
 /**     * 开启增强模式     */    static enableEnhancedMode() 

setDowngradePerformance

调用此方法开启高性能模式。高性能模式开启后,美颜占用的系统 CPU/GPU 资源更少,可减少手机的发热和卡顿现象,更适合低端机长时间使用。

      /**     * 开启性能模式,如果要使用此方法,此方法需要在 enableCustomVideoProcess 方法之前调用     */    static setDowngradePerformance()

setAudioMute

设置静音。

    /**     * 设置静音     */    static setAudioMute(isMute)
参数 含义
isMute true:静音

setFeatureEnableDisable

调用此方法开启高性能模式。高性能模式开启后,美颜占用的系统 CPU/GPU 资源更少,可减少手机的发热和卡顿现象,更适合低端机长时间使用。

      /**     * 开启性能模式,如果要使用此方法,此方法需要在 enableCustomVideoProcess 方法之前调用     */    static setDowngradePerformance(feature)
参数 含义
feature feature 为 object 对象,key 的值参考 SDK 中的 FeatureName 对象,value 设置为 true 开启,false 关闭

addAiMode

设置模型文件,入股模型文件是动态下载的,则需要在下载成功之后通过此接口将模型文件设置为 SDK,下次启动时不需要再设置。

  /**     *设置模型文件路径、     *     * @param {String} aiModePath 模型文件路径(绝对路径)     * @param callback     */    static addAiMode(aiModePath, callback) 
参数 含义
aiModePath 模型文件路径(绝对路径)
callback 结果回调方法

setLibPathAndLoad

设置网络下载的 so 文件,只支持 Android 平台。

   /**     * 动态加载网络下载的so文件,这里只需要出入存放so的文件夹即可     * @param {String} soDir 下载好的so文件的存放目录路径     */    static setLibPathAndLoad(soDir)
参数 含义
soDir soDir 下载好的 so 文件的存放目录路径

on

订阅 SDK 返回的事件。

  /**     * 订阅回调事件     *     * @param {String} event 事件名称     * @param {Function} callback 事件名称以及回到方法可参考  {@link EventName}     */    static on(event, callback)
参数 含义
event 事件名称,可以参考 EventName 类,订阅对应的事件
callback SDK 通过此方法将订阅的事件返回给 JS 侧

off

取消对应的事件。

   /**     * 取消回调事件     *     * @param {String} event 事件名称 可参考  {@link EventName}     */    static off(event)
参数 含义
event 事件名称,可以参考 EventName 类



对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?