终端极速高清
下载
聚焦模式
字号
概述
腾讯云视立方·音视频终端引擎提供了终端极速高清插件，该插件可在终端实现视频播放的超分后处理，适用于以下场景：
成本优化
保证画质的前提下，降低视频传输成本。如在云端将 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_PROFESSIONAL_HIGH_QUALITY | 专业版-高质量模式：确保了高图像质量，同时需要更高的设备性能。它适合于有高图像质量要求的场景，并推荐在中高端智能手机上使用。 |
TXMonetConstant#SR_ALGORITHM_TYPE_PROFESSIONAL_FAST | 专业版-快速模式：在牺牲一些图像质量的同时，确保了更快的处理速度。它适合于有高实时性要求的场景，并推荐在中档智能手机上使用。 |
步骤 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) {//开启终端极速高清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_Professional_High_Quality | 专业版-高质量模式：确保了高图像质量，同时需要更高的设备性能。它适合于有高图像质量要求的场景，并推荐在中高端智能手机上使用。 |
TXCMPAlgorithmType_Professional_Fast | 专业版-快速模式：在牺牲一些图像质量的同时，确保了更快的处理速度。它适合于有高实时性要求的场景，并推荐在中档智能手机上使用。 |
步骤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
文档反馈