腾讯特效SDKuniapp_音视频解决方案_同尘科技
腾讯特效 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折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?