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.
void UXCam.StopSessionAndUploadData()
Cancel Recording
Cancel the recording of the current session and discard the data.
void 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.
void UXCam.AllowShortBreakForAnotherApp(bool continueSession)
//Android only
void 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.
//Android only - use callback action for iOS.
UXCam.AddVerificationListener(OnVerificationListener listener)
//Example:
UXCam.AddVerificationListener(new IOnVerificationListener());
class IOnVerificationListener : Java.Lang.Object, Com.UXCam.IOnVerificationListener
{
public void OnVerificationFailed(string p0)
{
//Do Something here
}
public void OnVerificationSuccess()
{
//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.
void UXCam.SetMultiSessionRecord(bool recordMultipleSessions)
Get current multi session recording status (whether app is set to record multiple sessions or not).
bool UXCam.GetMultiSessionRecord()
Delete Pending Records
Delete sessions that are awaiting to upload.
void DeletePendingUploads()
//get pending uploads count
int PendingSessionCount()
Upload Pending Session
IOS only. Begin uploading pending sessions.
void UploadPendingSession(System.Action?.block)