Meta Developers

This class is the core component of the OVRCameraRig prefab, which provides the transform object to represent the Oculus tracking space and the trackable objects.

It contains a tracking space game object to fine-tune the relationship between the head tracking reference frame and your world. It also contains a center eye anchor, which is the main Unity camera, two anchor game objects for each eye, and left and right hand anchors for controllers.

For more information, see https://developer.oculus.com/documentation/unity/unity-add-camera-rig/.

Properties

Camera leftEyeCamera[Get]

The left eye camera.

Camera rightEyeCamera[Get]

The right eye camera.

Transform trackingSpace[Get]

Provides a root transform for all anchors in tracking space.

Transform leftEyeAnchor[Get]

Always coincides with the pose of the left eye.

Transform centerEyeAnchor[Get]

Always coincides with average of the left and right eye poses.

Transform rightEyeAnchor[Get]

Always coincides with the pose of the right eye.

Transform leftHandAnchor[Get]

Always coincides with the pose of the left active input device.

Transform rightHandAnchor[Get]

Always coincides with the pose of the right active input device.

Transform leftHandAnchorDetached[Get]

Coincides with the pose of the left input device if it is detached.

Transform rightHandAnchorDetached[Get]

Coincides with the pose of the left input device if it is detached.

Transform leftControllerInHandAnchor[Get]

Coincides with the pose of the left controller when it is in a hand.

Transform leftHandOnControllerAnchor[Get]

Coincides with the pose of the left hand when it is on a controller.

Transform rightControllerInHandAnchor[Get]

Coincides with the pose of the right controller when it is in a hand.

Transform rightHandOnControllerAnchor[Get]

Coincides with the pose of the right hand when it is on a controller.

Transform leftControllerAnchor[Get]

Anchors controller pose to fix offset issues for the left hand.

Transform rightControllerAnchor[Get]

Anchors controller pose to fix offset issues for the right hand.

Transform trackerAnchor[Get]

Always coincides with the pose of the sensor.

Events

System.Action< OVRCameraRig > UpdatedAnchors

Occurs when the eye pose anchors have been set.

Action< Transform > TrackingSpaceChanged

Occurs when the trackingSpace's transform changes.

This event provides a single argument: the Transform of the tracking space. This is the same as the trackingSpace property.

Fields

bool usePerEyeCameras[Get]

If true, separate cameras will be used for the left and right eyes.

bool useFixedUpdateForTracking[Get]

If true, all tracked anchors are updated in FixedUpdate instead of Update to favor physics fidelity.

Note:

: This will cause visible judder unless you tick exactly once per frame using a custom physics update, because you'll be sampling the position at different times into each frame.

bool disableEyeAnchorCameras[Get]

If true, the cameras on the eyeAnchors will be disabled.

Note:

: The main camera of the game will be used to provide VR rendering. And the tracking space anchors will still be updated to provide reference poses.

Protected Fields

bool _skipUpdate[Get]

readonly string trackingSpaceName[Get]

readonly string trackerAnchorName[Get]

readonly string leftEyeAnchorName[Get]

readonly string centerEyeAnchorName[Get]

readonly string rightEyeAnchorName[Get]

readonly string leftHandAnchorName[Get]

readonly string rightHandAnchorName[Get]

readonly string leftControllerAnchorName[Get]

readonly string rightControllerAnchorName[Get]

readonly string leftHandAnchorDetachedName[Get]

readonly string rightHandAnchorDetachedName[Get]

readonly string leftControllerInHandAnchorName[Get]

readonly string leftHandOnControllerAnchorName[Get]

readonly string rightControllerInHandAnchorName[Get]

readonly string rightHandOnControllerAnchorName[Get]

Camera _centerEyeCamera[Get]

Camera _leftEyeCamera[Get]

Camera _rightEyeCamera[Get]

Matrix4x4 _previousTrackingSpaceTransform[Get]

Protected Functions

virtual void Awake ( )

virtual void Start ( )

virtual void FixedUpdate ( )

virtual void Update ( )

virtual void OnDestroy ( )

virtual void UpdateAnchors

( bool updateEyeAnchors,

bool updateHandAnchors )

virtual void OnBeforeRenderCallback ( )

virtual void CheckForTrackingSpaceChangesAndRaiseEvent ( )

Checks for changes to trackingSpace's transform and, if it has changed, raises the TrackingSpaceChanged event.

This method compares the trackingSpace transform's localToWorldMatrix matrix against its value during the last invocation of this method.If trackingSpace is null, this method has no effect.

virtual void RaiseUpdatedAnchorsEvent ( )

virtual Transform ConfigureAnchor

( Transform root,

string name )

void CheckForAnchorsInParent ( )

Member Functions

virtual void EnsureGameObjectIntegrity ( )

virtual Matrix4x4 ComputeTrackReferenceMatrix ( )

Did you find this page helpful?