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.
RNUxcam.startWithKey: (appKey: string) => void
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.
RNUxcam.stopSessionAndUploadData: () => void
Cancel Recording
Cancel the recording of the current session and discard the data.
RNUxcam.cancelCurrentSession: () => void
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.
RNUxcam.allowShortBreakForAnotherApp: (continueSession: number | boolean) => void
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.
import { NativeModules, NativeEventEmitter } from 'react-native';
const emitter = new NativeEventEmitter(NativeModules.RNUxcam)
this.uxcamListener = emitter.addListener('UXCam_Verification_Event', async (status) => {
if (status.success){
//Do Something here
}
})
//To remove
uxcamListener.remove()
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.
RNUxcam.setMultiSessionRecord: (recordMultipleSessions: boolean) => void
Get current multi session recording status (whether app is set to record multiple sessions or not).
RNUxcam.getMultiSessionRecord: () => boolean
Delete Pending Records
Delete sessions that are awaiting to upload.
RNUxcam.deletePendingUploads: () => void
//get pending uploads count
RNUxcam.pendingSessionCount: () => number
Upload Pending Session
IOS only. Begin uploading pending sessions.
RNUxcam.uploadPendingSession: () => void