终端极速高清

最近更新时间:2025-11-13 16:17:02

我的收藏

概述

腾讯云视立方·音视频终端引擎提供了终端极速高清插件,该插件可在终端实现视频播放的超分后处理,适用于以下场景:
成本优化 保证画质的前提下,降低视频传输成本。如在云端将 720p 视频降档为 540p 进行传输,在终端播放时利用超分技术将视频画质提升为 720p 效果进行播放。
画质提升 将原本低分辨率的视频转化为高分辨率视频,提升视频播放清晰度,实现画质优化。
注意:
目前仅腾讯云视立方 · 播放器 SDK(Player)移动端9.5.29009以上版本可使用该插件。

效果和功耗

可单击下方视频查看终端极速高清功能效果,视频左半部分为原视频,右半部分为开启终端极速高清功能后的效果:

开启终端极速高清后,近景处路面碎石、远方树叶等清晰度均得到提升。
说明:
运行终端极速高清插件后,电流提升小于100mA,额外耗电几乎可以忽略。

申请播放器 License

终端极速高清是播放器中视频播放器后处理的插件能力,使用终端极速高清需要播放器 License,请确保已申请播放器 License,如果没有请 点击播放器 License 进行申请。

获取终端极速高清相关 SDK

终端极速高清插件(下文简称“插件”)作为独立的 SDK 提供,目前支持 Android 和 iOS 端,单个端需要下载终端极速高清插件 SDK 和终端视频增强 SDK 进行集成。

终端极速高清插件 SDK

插件 SDK 可以通过下表的地址下载:
终端类别
插件 SDK 下载地址
Android 端
SDK
iOS 端
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-library
android:name="libOpenCL.so"
android:required="false" />

<uses-native-library
android:name="libOpenCL-car.so"
android:required="false" />

<uses-native-library
android:name="libOpenCL-pixel.so"
android:required="false" />
</application>

步骤3:设置混淆规则

在 proguard-rules.pro 文件中,将 SDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }

步骤4:初始化配置

4.1 插件加载配置

终端极速高清插件加入到工程后,默认不会自动加载,可以通过下面的方式开启加载插件:
Android
TXVodPlayConfig playConfig = new TXVodPlayConfig();
playConfig.mEnableRenderProcess = true;
mVodPlayer.setConfig(playConfig);

4.2 初始化播放器 License

使用终端极速高清插件需要用到播放器播放能力,需要申请播放器 License,当前提供免费的测试版 License,获取方式请参见 播放器 License
获取到 License 后,通过下面的接口进行初始化 License:
Android
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 下面的接口,进行开启和关闭终端极速高清:
@Override
public 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,获取方式请参见 播放器 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:authId
algorithmType: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"];

查看日志

终端极速高清插件加载成功日志:
Android
iOS
HostEngine-PluginManager: [createPluginInstance],pluginId|2|clazzName|com.tencent.liteav.monet.MonetPlugin
[PluginsSDK] plugin config : pluginId = 2, pluginName = Monet
终端极速高清功能开启成功日志:
Android
iOS
MonetPlugin-Process: [updateModule], moduleType=1
[MonetProcessor] update TSR processor algorithm , tsrProcessor: 0x1023432b algorithmType is 1