We have a series of VG onboarding tasks to show how to tackle different practical use cases in a VR application.

Task Description

Interaction behaviors wanted

  • Initially the plate and all other floating objects are physical object, i.e. react to physics in the environment.
  • After the user places the apple or other objects on the plate, we expect when the plate is moved, either by hand or through teleportation, the objects in the plate should follow stably along.

Tips for VR developers

  • How to let objects placed on plate to follow the plate stably without easily rolling and falling down due to physical reactions. Can we use ChangeObjectJoint?


In VirtualGrasp SDK, we packed the solution of this task in VirtualGrasp/Scenes/onboarding.


is the unity scene showing how plate and apple are setup with physical properties using Unity’s rigid body and collider components and ManageContainerObject.cs script is attached to plate as the container object.


using System.Collections.Generic;
using VirtualGrasp;
using UnityEngine;

public class ManageContainerObject : MonoBehaviour
    /// A set off objects that are actively colliding with this one.
    private HashSet<Transform> m_collisions = new HashSet<Transform>();
    /// A map of objects that are attached to this one to their original parents.
    private Dictionary<Transform, Transform> m_parentCache = new Dictionary<Transform, Transform>();
    /// If dot product between velocity and down is large enough (ie. vectors are aligned).
    public float m_dropAlignment = 0.8f;

    private void Start()
        // Register the some grasp event listeners

    private void OnCollisionEnter(Collision collision)
        // See if the object in collision is actually held by a hand (and is not a hand itself).
        bool valid_object = true;
        foreach (VG_HandStatus hand in VG_Controller.GetHands())
            if (hand.m_hand == collision.transform)
                valid_object &= false;
            if (hand.m_selectedObject == collision.transform && hand.IsHolding())
                valid_object &= false;

        if (valid_object && // If it's valid ...
            collision.rigidbody != null && // and has a rigid body ...
            Vector3.Dot(collision.relativeVelocity.normalized, Vector3.down) > m_dropAlignment) // .. and if the object is dropped from somewhat above.

    private void OnCollisionExit(Collision collision)

    private void OnObjectFullyReleased(Transform t)
        if (m_collisions.Contains(t)) Attach(t);

    private void OnObjectGrasped(VG_HandStatus hand)
        if (hand.m_selectedObject.parent == transform && VG_Controller.GetObjectJointType(hand.m_selectedObject) != VG_JointType.FLOATING)

    void Attach(Transform attachedObject)
        Rigidbody rigidBody = attachedObject.GetComponent<Rigidbody>();
        VG_Controller.ChangeObjectJoint(attachedObject, VG_JointType.FIXED);
        m_parentCache[attachedObject] = attachedObject.parent;

    void Unattach(Transform attachedObject)
        // If the object was floating before attaching it, recover this.
        if (VG_Controller.GetObjectJointType(attachedObject, true) == VG_JointType.FLOATING)
        else // Otherwise, we don't want the original state back.
            VG_Controller.ChangeObjectJoint(attachedObject, VG_JointType.FLOATING);
        Rigidbody rigidbody = attachedObject.gameObject.AddComponent<Rigidbody>();
        rigidbody.useGravity = true;

is the script showing how to use API function ChangeObjectJoint and RecoverObjectJoint to attach and unattach the object to the plate. Note that when an object is attached to the plate, its rigid body should be removed to avoid object being moved by physical forces.