Video Playback License
Configuration
Before you call the APIs of the Player SDK, follow the steps below to configure the license:
iOS
Add the code below in [AppDelegate application:didFinishLaunchingWithOptions:]:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
NSString * const licenseURL = @"<The license URL obtained>";
NSString * const licenseKey = @"<The key obtained>";
//TXLiveBase can be found in the "TXLiveBase.h" header file
[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
Android
Add the code below in application:
public class MApplication extends Application {
public void onCreate() {
super.onCreate();
String licenseURL = ""; // The license URL obtained
String licenseKey = ""; // The license key obtained
TXLiveBase.getInstance().setLicence(this, licenseURL, licenseKey);
TXLiveBase.setListener(new TXLiveBaseListener() {
@Override
public void onLicenceLoaded(int result, String reason) {
Log.i(TAG, "onLicenceLoaded: result:" + result + ", reason:" + reason);
}
});
}
}
Note：
1. License is a strong online verification logic. When calling TXLiveBase#setLicence after the application is started for the first time, the network must be ensured. When the App is launched for the first time, the Internet access permission may not have been authorized. You need to wait for the Internet access permission to be granted before calling TXLiveBase#setLicence again.
2. Monitor the TXLiveBase#setLicence loading result: onLicenceLoaded interface. If it fails, retry and guide accordingly according to the actual situation. If it fails multiple times, the frequency can be limited, and the service can be supplemented with product pop-up windows and other guidance to allow users to check the network situation.
3. TXLiveBase#setLicence can be called multiple times. It is recommended to call TXLiveBase#setLicence when entering the main interface of the App to ensure successful loading.
4. For multi-process apps, ensure that TXLiveBase#setLicence is called when each process using the player starts. For example: For an Android app that uses an independent process to play videos, if the process is killed by the system and restarted during background playback, TXLiveBase#setLicence must also be called.
After the license is successfully configured, you can call the API below to view the license information. Please note that it may take a while for the configuration to take effect. The exact time needed depends on your network conditions.
iOS:
NSLog(@"%@", [TXLiveBase getLicenceInfo]);
Android:
TXLiveBase.getInstance().getLicenceInfo();