Please reach out to your Tencent Cloud business representative to activate TSR service. You will need to provide the following information regarding the app that will integrate the SDK: Tencent Cloud account APPID, APP Bundle Identifier.
Your APPID can be found within your Tencent Cloud "Account Center" -> "Account Information" -> "Basic Information".
The Bundle Identifier can be viewed within an Xcode project by navigating to "TARGETS" -> "General" -> "Identity" -> "Bundle Identifier".
Required Information
| Info | Value |
| APPID | 12345678 |
| Bundle Identifier | com.tencent.mps.ios-demo |
| SDK edition | Standard Edition/ Professional Edition |
The authorization scheme involves application and verification. Application happens once per validity period, allowing online authentication during TSRSDK initialization if the APP has internet access. The service must be renewed upon expiry.
To ensure that the service can be properly authorized, you also need to activate the Media Processing Service (MPS) Console on the Tencent Cloud official website. Activation link:：https://console.tencentcloud.com/mps
Download the source code of the Demo project here.
Alter the demo's Bundle Identifier and provide it to Tencent Cloud business services. Refer to the previous "SDK Authorization Application" steps to acquire the SDK and authorization files, then configure them within the Demo project. The procedure is as follows:
- Open the project in Xcode and drag the SDK into the project directory. Ensure "Copy items if needed" is selected and verify that "Link Binary With Libraries" includes the SDK.
-
Within the "TARGETS" -> "General" -> "Frameworks, Libraries, and Embedded Content" section, configure the SDK's "Embed" setting to "Embed & Sign".
-
Drag the certificate into the project directory under tsr-ios-demo, and ensure that "Target Membership" is selected.
-
Fill in the licenseName and appId in VideoPlayViewController.h
-
Execute the demo.
None
-
To initialize the TSRSdk for online authentication, you must provide the APPID and AUTH_ID for authentication purposes. The method
initWithAppId:authId:sdkLicenseVerifyResultCallback:tsrLogger:requires the input ofTSRSdkLicenseVerifyResultCallbackto retrieve the results of the online authentication. Additionally, aTSRLoggermust be supplied to obtain the SDK's logs. Below is the sample code:- (void)onTSRSdkLicenseVerifyResult:(TSRSdkLicenseStatus)status { if (status == TSRSdkLicenseStatusAvailable) { // Creating TSRPass for super-resolution rendering } else { // Do something when the verification of sdk's license failed. } } // Init TSRSdk and verify the online license [TSRSdk.getInstance initWithAppId:APPID authId:AUTH_ID sdkLicenseVerifyResultCallback:self tsrLogger:[[Logger alloc] init]]; -
When you no longer require the use of TSRSdk, it is necessary to invoke the deInit method of TSRSdk to release resources.
// Release resources when the TSRSdk object is no longer needed. [TSRSdk.getInstance deInit];
TSRPass is a class designed for executing super-resolution rendering, encompassing methods such as init, setParametersWithBrightness, and render. Upon creating a TSRPass instance, it is imperative to specify the super-resolution algorithm type by passing in TSRAlgorithmType.
Within the TSRAlgorithmType enumeration, there are three algorithm execution modes: TSRAlgorithmTypeStandard, TSRAlgorithmTypeProfessionalHighQuality, and TSRAlgorithmTypeProfessionalFast.
-
TSRAlgorithmTypeStandard (Standard) Mode: Offers rapid super-resolution processing speeds, making it suitable for scenarios that demand high real-time performance. In this mode, a notable enhancement in image quality can be achieved.
-
TSRAlgorithmTypeProfessionalHighQuality (Professional Edition - High Quality) Mode: The mode ensures superior image quality while requiring higher device performance. It is ideal for scenarios with stringent image quality demands and is recommended for use on mid to high-end smartphones.
-
TSRAlgorithmTypeProfessionalFast (Professional Edition - Fast) Mode: The mode guarantees quicker processing speeds at the expense of some image quality. It is well-suited for scenarios that demand high real-time performance and is recommended for use on mid-range smartphones. It encompasses the init, render, and deInit methods. Before utilizing TSRPass, you must invoke the init method to initialize it. Upon completion of its use, you must call the deInit method to release resources.
Please note:
-
TSRPass employs the Metal framework for super-resolution rendering, necessitating devices that support Metal.
-
TSRPass is not thread-safe and must be invoked within the same thread.
-
The Professional version algorithm, TSRAlgorithmTypeProfessionalFast, requires an iOS system version of 15.0 or higher to be effective.
-
The Professional version algorithm, TSRAlgorithmTypeProfessionalHighQuality, necessitates an iOS system version of 16.0 or higher to function properly.
Prior to utilizing TSRPass, it is imperative to initialize the system by invoking the method.initWithDevice:inputWidth:inputHeight:srRatio:
# TSRAlgorithmTypeStandard
_tsr_pass_standard = [[TSRPass alloc] initWithTSRAlgorithmType:TSRAlgorithmTypeStandard device:_device inputWidth:_videoSize.width inputHeight:_videoSize.height srRatio:_srRatio];
# TSRAlgorithmTypeProfessionalFast
_tsr_pass_professional_fast = [[TSRPass alloc] initWithTSRAlgorithmType:TSRAlgorithmTypeProfessionalFast device:_device inputWidth:_videoSize.width inputHeight:_videoSize.height srRatio:_srRatio];
# TSRAlgorithmTypeProfessionalHighQuality
_tsr_pass_professional_high_quality = [[TSRPass alloc] initWithTSRAlgorithmType:TSRAlgorithmTypeProfessionalHighQuality device:_device inputWidth:_videoSize.width inputHeight:_videoSize.height srRatio:_srRatio];
Upon initializing TSRPass, you may optionally adjust the rendering parameters by invoking the method setParametersWithBrightness:saturation:contrast:.
// Optional. Sets the brightness, saturation and contrast level of the TSRPass. The default value is set to (50, 50, 50).
// Here we set these parameters to slightly enhance the image.
[_tsr_pass setParametersWithBrightness:52 saturation:55 contrast:60];
The render:commandBuffer: method applies a super-resolution rendering process to the input image, enhancing its quality. The processed image is rendered onto an MTLTexture within the TSRPass object. The method returns an MTLTexture that has undergone super-resolution rendering.
_sr_texture = [_tsr_pass render:_in_texture commandBuffer:commandBuffer];
When you no longer require the use of TSRPass, it is necessary to invoke the deInit method of TSRPass to release resources.
// Release resources when the TSRPass object is no longer needed.
[_tsr_pass deInit];
TIEPass is a class designed for image enhancement rendering, available exclusively in the Professional Edition SDK. It encompasses the methods init, render, and renderWithPixelBuffer. Prior to utilizing TIEPass, it is imperative to invoke the init method for initialization. When creating TIEPass, it is necessary to input TIEAlgorithmType to set the algorithm type for super-resolution:
Within the TIEAlgorithmType enumeration, there exist two algorithm execution modes: TIEAlgorithmTypeProfessionalHighQuality and TIEAlgorithmTypeProfessionalFast.
-
TIEAlgorithmTypeProfessionalHighQuality mode ensures superior image quality while demanding higher device performance. It is ideal for scenarios requiring high-quality images and is recommended for use on mid-to-high-end smartphones.
-
TIEAlgorithmTypeProfessionalFast mode offers faster processing with some image quality reduction, ideal for real-time needs on mid-range smartphones. It includes init, render, and deInit methods. Use init before TSRPass and deInit after to free resources.
Please be advised:
-
TIEPass is not thread-safe and must be invoked within the same thread.
-
The Professional Edition algorithm, TIEAlgorithmTypeProfessionalFast, requires an iOS system version of 15.0 or higher to function effectively.
-
The Professional Edition algorithm, TIEAlgorithmTypeProfessionalHighQuality, necessitates an iOS system version of 16.0 or higher to be operational.
Before utilizing TIEPass, it is imperative to initialize it by invoking the initWithDevice:inputWidth:inputHeight: method.
// FAST
_tie_pass_fast = [[TIEPass alloc] initWithDevice:_device inputWidth:_videoSize.width inputHeight:_videoSize.height algorithmType:TIEAlgorithmTypeProfessionalFast];
// HIGH_QUALITY
_tie_pass_high_quality = [[TIEPass alloc] initWithDevice:_device inputWidth:_videoSize.width inputHeight:_videoSize.height algorithmType:TIEAlgorithmTypeProfessionalHighQuality];
When you no longer require the use of TIEPass, it is necessary to invoke the deInit method of TIEPass to release resources.
// Release resources when the TIEPass object is no longer needed.
[_tie_pass deInit];
TSRLogger is designed to capture internal logs from the SDK. Please ensure these logs are written to a file to facilitate the troubleshooting of external network issues.
You may click the link to access the API documentation for TSRSDK, which includes annotations for the interfaces and examples of how to call them.