概述
腾讯云视立方·音视频终端引擎提供了终端极速高清插件,该插件可在终端实现视频播放的超分后处理,适用于以下场景:
成本优化
保证画质的前提下,降低视频传输成本。如在云端将 720p 视频降档为 540p 进行传输,在终端播放时利用超分技术将视频画质提升为 720p 效果进行播放。
画质提升
将原本低分辨率的视频转化为高分辨率视频,提升视频播放清晰度,实现画质优化。
注意:
目前仅腾讯云视立方 · 播放器 SDK(Player)移动端9.5.29009以上版本可使用该插件。
效果和功耗
可单击下方视频查看终端极速高清功能效果,视频左半部分为原视频,右半部分为开启终端极速高清功能后的效果:
开启终端极速高清后,近景处路面碎石、远方树叶等清晰度均得到提升。
说明:
运行终端极速高清插件后,电流提升小于100mA,额外耗电几乎可以忽略。
申请播放器 License
获取终端极速高清相关 SDK
终端极速高清插件(下文简称“插件”)作为独立的 SDK 提供,目前支持 Android 和 iOS 端,单个端需要下载终端极速高清插件 SDK 和终端视频增强 SDK 进行集成。
终端极速高清插件 SDK
插件 SDK 可以通过下表的地址下载:
终端视频增强 SDK
获取到终端视频增强 SDK后,请参考下面的步骤进行 SDK 授权申请,授权申请成功后,您将获授权信息 appId 和 authId。
注意:
终端极速高清功能详情的套餐资费请联系您的商务。
集成指引
Android 端集成
步骤1:集成 SDK 到工程
将获取到的2个 SDK,如:plugin_monet-release-v.x.x.x.aar 和 TsrSdk-Release-v.x.x.x.aar 集成到工程,启动播放器实例后,宿主会根据配置加载插件。
步骤2:App 工程添加权限
<uses-permission android:name="android.permission.INTERNET"/>//如果 Android targetSdkVersion 大于等于 31,需要添加以下标签,否则功能可能无法使用<application><uses-native-libraryandroid:name="libOpenCL.so"android:required="false" /><uses-native-libraryandroid:name="libOpenCL-car.so"android:required="false" /><uses-native-libraryandroid:name="libOpenCL-pixel.so"android:required="false" /></application>
步骤3:设置混淆规则
在 proguard-rules.pro 文件中,将 SDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }
步骤4:初始化配置
4.1 插件加载配置
终端极速高清插件加入到工程后,默认不会自动加载,可以通过下面的方式开启加载插件:
TXVodPlayConfig playConfig = new TXVodPlayConfig();playConfig.mEnableRenderProcess = true;mVodPlayer.setConfig(playConfig);
4.2 初始化播放器 License
获取到 License 后,通过下面的接口进行初始化 License:
String licenceUrl = "填入您购买的 License 的 URL";String licenseKey = "填入您购买的 License 的 Key"TXLiveBase.getInstance().setLicence(context, licenceUrl, licenseKey);
4.3 初始化终端极速高清插件
// 其中 appId, authId 是腾讯云签发的授权信息// srAlgorithmType 为超分算法类型,有下面的 3 个值可以选择MonetPlugin.setAppInfo(${appId}, ${authId}, ${srAlgorithmType});
超分算法类型(srAlgorithmType)
类型 | 说明 |
TXMonetConstant#SR_ALGORITHM_TYPE_STANDARD | 标准模式:提供快速的超分辨率处理速度,适用于高实时性要求的场景。在这种模式下,可以实现显著的图像质量改善。 |
TXMonetConstant#SR_ALGORITHM_TYPE_STANDARD_COLOR_RETOUCHING_EXT | 标准-色彩调节模式:在标准版超分辨率的基础上优化色彩表现。 |
TXMonetConstant#SR_ALGORITHM_TYPE_PROFESSIONAL | 专业版-快速模式:在牺牲一些图像质量的同时,确保了更快的处理速度。它适合于有高实时性要求的场景,并推荐在中档智能手机上使用。 |
TXMonetConstant#SR_ALGORITHM_TYPE_PROFESSIONAL_COLOR_RETOUCHING_EXT | 专业-色彩调节模式:在专业版超分辨率的基础上优化色彩表现。 |
步骤 5:开启或关闭终端极速高清能力
启动播放之后(建议在收到 TXLiveConstants.PLAY_EVT_VOD_PLAY_PREPARED 事件之后调用),可以通过 TXVodPlayer 下面的接口,进行开启和关闭终端极速高清:
@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXLiveConstants.PLAY_EVT_VOD_PLAY_PREPARED) {YXY123,./mVodPlayer.setStringOption("PARAM_SUPER_RESOLUTION_TYPE", 1);}}//建议播放结束时关闭终端极速高清mVodPlayer.setStringOption("PARAM_SUPER_RESOLUTION_TYPE", 0);
通过以上步骤,您将看到开启终端极速高清后的效果。
iOS 端集成
步骤1:集成 SDK
将获取到的2个 SDK,如:TXCMonetPlugin-release-v.x.x.x.xcframework 和 tsr_client.framework 通过下面的步骤集成到项目工程。
1. 将下载的插件 SDK TXCMonetPlugin-release-v.x.x.x.xcframework(x.x.x. 为版本号)集成到工程,启动播放器实例后,会根据配置加载插件。
路径为:Build Phases > Link Binary With Libraries > '选择+号添加' 即可。

2. 将下载的终端视频增强 SDK tsr_client.framework 集成到工程,因 tsr_client.framework 为动态库,需要设置“tsr_client.framework”为“Embed & Sign”。
路径为:General > Frameworks, Libraries, and Embedded Content > 设置即可。

同时,为了适配苹果的隐私清单,请将 TXCMonetPlugin-Privacy.bundle 添加到项目工程中,或者将 bundle 里的“PrivacyInfo.xcprivacy”整合进待集成的项目工程内。添加 TXCMonetPlugin-Privacy.bundle 到项目工程中的方法为:"Build Phases > Copy Bundle Resources > '选择+号添加'"即可。

步骤2:初始化配置
2.1 插件加载配置
终端极速高清插件加入到工程后,默认不会自动加载,可以通过下面的方式开启加载插件:
// 配置播放器参数_config = [[TXVodPlayConfig alloc] init];// 设置帧数据格式(请设置为BGRA格式)_config.videoFrameFormatType = TX_VIDEO_PIXEL_FORMAT_BGRA;// 启动后处理,加载超分_config.enableRenderProcess = YES;[_txVodPlayer setConfig:_config];
2.2 初始化播放器 License
获取到 License 后,通过下面的接口进行初始化 License:
// 建议在 [AppDelegate application:didFinishLaunchingWithOptions:] 中添加- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {NSString * const licenseURL = @"<获取到的licenseUrl>";NSString * const licenseKey = @"<获取到的key>";// TXLiveBase 位于 "TXLiveBase.h" 头文件中[TXLiveBase setLicence:licenseURL key:licenseKey];[TXLiveBase sharedInstance].delegate = self;NSLog(@"SDK Version = %@", [TXLiveBase getSDKVersionStr]);return YES;}#pragma mark - TXLiveBaseDelegate- (void)onLicenceLoaded:(int)result Reason:(NSString *)reason {NSLog(@"onLicenceLoaded: result:%d reason:%@", result, reason);}@end
2.3 初始化终端极速高清插件
获取到终端技术高清授权信息后,可以通过下面接口进行初始化。相关接口详见 TXCMonetPlugin.xcframework 中 TXCMonetPluginManager.h 头文件。
// 引入头文件#import <TXCMonetPlugin/TXCMonetPluginInterface.h>#import <TXCMonetPlugin/TXCMonetPluginCommonDef.h>// 其中 appId, authId 是腾讯云签发的授权信息[[TXCMonetPluginManager sharedManager] setAppInfo:@"appId"authId:authIdalgorithmType:srAlgorithmType];
超分算法类型(srAlgorithmType)
类型 | 说明 |
TXCMPAlgorithmType_Standard | 标准模式:提供快速的超分辨率处理速度,适用于高实时性要求的场景。在这种模式下,可以实现显著的图像质量改善。 |
TXCMPAlgorithmType_Standard_Color_Retouching_Ext | 标准-色彩调节模式:在标准版超分辨率的基础上优化色彩表现。 |
TXCMPAlgorithmType_Professional | 专业版-快速模式:在牺牲一些图像质量的同时,确保了更快的处理速度。它适合于有高实时性要求的场景,并推荐在中档智能手机上使用。 |
TXCMPAlgorithmType_Professional_Color_Retouching_Ext | 专业-色彩调节模式:在专业版超分辨率的基础上优化色彩表现。 |
步骤3:参数配置
在启动高清能力之前,需要配置以下参数信息,便于播放器启动极速高清能力。以下参数建议在播放器启动播放前进行设置(通过 TXVodPlayConfig 模型进行配置)。
// 配置播放器参数_config = [[TXVodPlayConfig alloc] init];// 设置帧数据格式(请设置为BGRA格式)_config.videoFrameFormatType = TX_VIDEO_PIXEL_FORMAT_BGRA;// 启动后处理,加载超分_config.enableRenderProcess = YES;[_txVodPlayer setConfig:_config];
步骤4:开启或关闭终端极速高清能力
终端极速高清能力可以通过 TXVodPlayer 下面的接口,进行开启和关闭终端极速高清:
//开启终端极速高清//注意:终端极速高清的开启设置需要在播放器播放之前,或者如果在播放过程中进行设置,在设置以后需要重启一下//播放,建议这里可以做一个切换动画NSMutableDictionary *extInfoMap = [NSMutableDictionary dictionary];[extInfoMap setObject:@"1" forKey:@"PARAM_SUPER_RESOLUTION_TYPE"];[_txVodPlayer setExtentOptionInfo:extInfoMap];//建议播放结束时关闭终端极速高清[extInfoMap setObject:@"0" forKey:@"PARAM_SUPER_RESOLUTION_TYPE"];
查看日志
终端极速高清插件加载成功日志:
HostEngine-PluginManager: [createPluginInstance],pluginId|2|clazzName|com.tencent.liteav.monet.MonetPlugin
[PluginsSDK] plugin config : pluginId = 2, pluginName = Monet
终端极速高清功能开启成功日志:
MonetPlugin-Process: [updateModule], moduleType=1
[MonetProcessor] update TSR processor algorithm , tsrProcessor: 0x1023432b algorithmType is 1