Built-In Components

These are additional Blueprint Script Macros to record common data. To use them, add them to your Level Blueprint or Player Actor Blueprint. These macros are intended for easy implementation and they try to make few assumptions about your project. You should review these macros to simplify and optimize in ways specific to your project's needs.

Analytics Tracker Components

Room Size

This will record the size of the participant's configured room in meters. This is supported in UE4.27 or later. On Oculus/Meta platforms, this is also supported in UE4.26+.

Arm Length

This requires Dynamic Objects to be configured correctly for your hands.

Measures the distance from the HMD to each hand to calculate an approximate length of the player's arm.

HMD Height

Measures the median HMD height from the floor to calculate an approximate player height in meters.

Battery Level

Records a sensor for the battery level over time in the experience. This component also records the current status of the battery, whether its charging, full, or draining.

Framerate

Records a sensor for the average, minimum 5%, and minimum 1% framerate over time.

Note

The following feature is only available in Cognitive3D Unreal SDK version 1.8.3 and above

If you are using the Oculus Github fork of Unreal Engine and have the Application SpaceWarp feature active, Meta SDK will cap the framerate to half of the device's refresh rate and inject synthetic frames for every frame rendered by the engine. This allows the user to experience the application with the expected refresh rate. For our SDK's data collection purposes and analytics, we double the value written to the framerate sensor. We also have a new sensor called c3d.app.meta.spaceWarp that is set to 1 on all frames with ASW enabled.

To identify sessions where ASW was active at any point during runtime, you can filter the sessions using the property c3d.app.meta.wasSpaceWarpUsed == true.

Hand Elevation

This requires Dynamic Objects to be configured correctly for your hands.

Records a sensor for the elevation of each hand relative to the HMD.

HMD Orientation

Records a sensor for the pitch and yaw of the user's HMD.

Controller Tracking Events

Records an event when the controllers lose tracking.

Input Tracker

This requires Dynamic Objects to be configured correctly for your hands and that additional Cognitive3D inputs are defined. See Controller Setup for details.

Records the button states of controllers over time.