The following API allows you to control when the session gets recorded.
Start Recording
Start the UXCam application to verify the API key with the server, get the settings configurations and start capturing the data according to the configuration.
UXCam.startWithKey(String appKey);
The API parameters are:
appKey: App-key (found on UXCam dashboard).
Stop Recording
UXCam automatically starts/stops sessions depending on application state. If you want to take control, use this API to stop UXCam session and upload it.
UXCam.stopSessionAndUploadData();
Cancel Recording
Cancel the recording of the current session and discard the data.
UXCam.cancelCurrentSession();
Allow a Short Break for Another App
Prevent a short trip to another app from causing a break in a session. This is useful when your user needs to leave the app for a short amount of time like log-in using google or when you open URL link using an external browser among other use cases.
UXCam.allowShortBreakForAnotherApp(boolean continueSession);
//With waiting time
UXCam.allowShortBreakForAnotherApp(int timeInMilliseconds);
The API parameters are:
continueSession: Set to TRUE to continue the current session after a short trip out to another app. Default is FALSE - stops the session as soon as the app enters the background.
timeInMilliseconds: Android only. Time to wait before closing current session. By default the method will wait 180000ms (3 min) to end the session.
Note: Set to TRUE to continue the current session before a short trip out to another app, and set to FALSE after coming back to the app.
Add Verification Listener
Get verification status when UXCam starts capturing sessions. Its is particularly useful in cases such as,
- When you want to log certain events as soon as the session starts.
- When you want to log current UXCam session or user URL to other 3rd party services.
UXCam.addVerificationListener(OnVerificationListener listener)
//Example:
UXCam.addVerificationListener(new OnVerificationListener() {
@Override
public void onVerificationSuccess() {
//Do Something here
}
@Override
public void onVerificationFailed(String errorMessage) {
//Do Something here
}
});
//To remove
UXCam.removeVerificationListener(OnVerificationListener listener);
Configure Multisession Recordings
Configure whether UXCam is set to automatically record a new session when the app resumes from the background.
Set whether to automatically record multiple sessions or not. Default is TRUE.
UXCam.setMultiSessionRecord(boolean recordMultipleSessions);
Get current multi session recording status (whether app is set to record multiple sessions or not).
boolean UXCam.getMultiSessionRecord()
Delete Pending Records
Delete sessions that are awaiting to upload.
void deletePendingUploads()
//get pending uploads count
int pendingSessionCount()
Upload Pending Session
Not supported