Starting and Stopping Recording#
Once enabled correctly, PVRCarbon will be loaded and start recording for all launched applications. PVRCarbon Recorder on Android may lose data if it does not stop recording correctly. The following explains the right ways to end recording.
To stop recording, you will need to be familiar with setting Android properties using the setprop
command, and/or editing the pvrcarbon.json
configuration file. There is more information on how to do this, along with how to use the properties mentioned, in the Configuration Options section.
To stop recording, use one of these methods:
Set a fixed number of frames to record using the Android property
pvrcbn.frames
viasetprop
.Set to exit after a specific frame, using the PVRCarbon property
pvrcbn.exitAfterFrame
via either thesetprop
or thepvrcarbon.json
configuration file. Unlike withpvrcbn.frames
, this will close the application. If PVRCarbon is recording at the time, it will finish and then finalise the file.Send a SIGINT from the terminal to the process ID (PID) of the application being recorded e.g. kill -2 <PID>.
Note
These methods can also be applied to rooted and unrooted setups with both OpenGL ES and Vulkan libraries. Before rebooting the device use setprop pvrcbn.enable 0
, otherwise the rooted device cannot be booted up.
This is an example of a configuration that enables and stops recording in the pvrcarbon.json
file:
{
"recording":
{
"enable": true,
"exitAfterFrame": 500
}
}
Note
For unrooted devices, setprop
may not work, so the pvrcarbon.json
configuration file will need to be used instead. Android does not report if the property has not been set, so use getprop
to verify whether it was set.