Class InteractorUnregisteredEventArgs

Event data associated with the event when an Interactor is unregistered from an XRInteractionManager.

Inheritance
object
BaseRegistrationEventArgs
InteractorUnregisteredEventArgs
Inherited Members
Namespace: UnityEngine.XR.Interaction.Toolkit
Assembly: Unity.XR.Interaction.Toolkit.dll
Syntax
public class InteractorUnregisteredEventArgs : BaseRegistrationEventArgs
Remarks

When an IXRInteractor is unregistered with the XRInteractionManager, the unregistered event and interactorUnregistered events are invoked with InteractorUnregisteredEventArgs as parameters.

InteractorUnregisteredEventArgs provides the unregistering interactorObject and the XRInteractionManager associated with the unregistration event.

Examples

The following example subscribes to the interactorUnregistered event and implements custom callback functions that will be called when the interactorUnregistered is invoked. Enabling the "Example Interactor" game object will trigger the registered callback, while disabling it will trigger the unregistered callback.

using UnityEngine;
using UnityEngine.XR.Interaction.Toolkit;
using UnityEngine.XR.Interaction.Toolkit.Interactables;
using UnityEngine.XR.Interaction.Toolkit.Interactors;

/// <summary>
/// This class is an example script that registration events and demonstrates how to create callbacks for each event.
/// </summary>
class XRInteractionManagerRegistrationEventsSample : MonoBehaviour
{
[SerializeField]
XRInteractionManager m_InteractionManager;


XRInteractionGroup m_ExampleInteractionGroup;
NearFarInteractor m_ExampleInteractor;
XRGrabInteractable m_ExampleInteractable;
XRInteractableSnapVolume m_ExampleSnapVolume;

void Awake()
{
    // Try to find an interaction manager if necessary.
    // In Unity versions older than 2021.3.18f1, replace FindFirstObjectByType with FindObjectOfType.
    if (m_InteractionManager == null)
        m_InteractionManager = FindFirstObjectByType<XRInteractionManager>();

    // Note, the code below is creating the XRInteractionGroup, NearFarInteractor, XRGrabInteractable, and XRInteractableSnapVolume before subscribing
    // to the interaction manager register/unregister events. Therefore, the initial register callback will not be logged.
    // To demonstrate these callbacks, enable/disable each example game object in the hierarchy to receive the register/unregister callbacks.

    // XRInteractionGroup automatically registers with the interaction manager on Awake
    var interactionGroupGO = new GameObject("Example Interaction Group");
    m_ExampleInteractionGroup = interactionGroupGO.AddComponent<XRInteractionGroup>();

    // XRBaseInteractor automatically registers with the interaction manager on Enable
    var interactorGO = new GameObject("Example Interactor");
    m_ExampleInteractor = interactorGO.AddComponent<NearFarInteractor>();

    // XRBaseInteractable automatically registers with the interaction manager on Enable
    var interactableGO = new GameObject("Example Interactable");
    m_ExampleInteractable = interactableGO.AddComponent<XRGrabInteractable>();

    // XRInteractableSnapVolume automatically registers with the interaction manager on Enable
    var snapVolumeGO = new GameObject("Example Snap Volume");
    m_ExampleSnapVolume = snapVolumeGO.AddComponent<XRInteractableSnapVolume>();
}

void OnEnable()
{
    if (m_InteractionManager == null)
    {
        Debug.LogWarning("Interaction manager is null. No registration events will be executed in this example. Ensure there is an " + typeof(XRInteractionManager) + " in the scene.", this);
        return;
    }

    // Subscribe to the interaction manager registration events
    m_InteractionManager.interactionGroupRegistered += OnInteractionGroupRegistered;
    m_InteractionManager.interactorRegistered += OnInteractorRegistered;
    m_InteractionManager.interactableRegistered += OnInteractableRegistered;
    m_InteractionManager.snapVolumeRegistered += OnSnapVolumeRegistered;

    m_InteractionManager.interactionGroupUnregistered += OnInteractionGroupUnregistered;
    m_InteractionManager.interactorUnregistered += OnInteractorUnregistered;
    m_InteractionManager.interactableUnregistered += OnInteractableUnregistered;
    m_InteractionManager.snapVolumeUnregistered += OnSnapVolumeUnregistered;
}

void OnDisable()
{
    if (m_InteractionManager == null)
        return;

    // Unsubscribe to the interaction manager registration events
    m_InteractionManager.interactionGroupRegistered -= OnInteractionGroupRegistered;
    m_InteractionManager.interactorRegistered -= OnInteractorRegistered;
    m_InteractionManager.interactableRegistered -= OnInteractableRegistered;
    m_InteractionManager.snapVolumeRegistered -= OnSnapVolumeRegistered;

    m_InteractionManager.interactionGroupUnregistered -= OnInteractionGroupUnregistered;
    m_InteractionManager.interactorUnregistered -= OnInteractorUnregistered;
    m_InteractionManager.interactableUnregistered -= OnInteractableUnregistered;
    m_InteractionManager.snapVolumeUnregistered -= OnSnapVolumeUnregistered;
}

void OnInteractionGroupRegistered(InteractionGroupRegisteredEventArgs args)
{
    // Example of casting args object to interaction group base class
    var interactionGroup = args.interactionGroupObject as XRInteractionGroup;

    // Logic for interaction group registered event goes here
    if (interactionGroup != null && interactionGroup == m_ExampleInteractionGroup)
        Debug.Log(interactionGroup.transform.name + " is registered with " + args.manager.transform.name, this);
}

void OnInteractionGroupUnregistered(InteractionGroupUnregisteredEventArgs args)
{
    // Example of casting args object to interaction group base class
    var interactionGroup = args.interactionGroupObject as XRInteractionGroup;

    // Logic for interaction group unregistered event goes here
    if (interactionGroup != null && interactionGroup == m_ExampleInteractionGroup)
        Debug.Log(interactionGroup.transform.name + " is unregistered with " + args.manager.transform.name, this);
}

void OnInteractorRegistered(InteractorRegisteredEventArgs args)
{
    // Example of casting args objects to interactor base class
    var interactor = args.interactorObject as XRBaseInteractor;

    // Logic for interactor registered event goes here
    if (interactor != null && interactor == m_ExampleInteractor)
        Debug.Log(args.interactorObject.transform.name + " is registered with " + args.manager.transform.name, this);
}

void OnInteractorUnregistered(InteractorUnregisteredEventArgs args)
{
    // Example of casting args objects to interactor base class
    var interactor = args.interactorObject as XRBaseInteractor;

    // Logic for interactor unregistered event goes here
    if (interactor != null && interactor == m_ExampleInteractor)
        Debug.Log(args.interactorObject.transform.name + " is unregistered with " + args.manager.transform.name, this);
}

void OnInteractableRegistered(InteractableRegisteredEventArgs args)
{
    // Example of casting args objects to interactable base class
    var interactable = args.interactableObject as XRBaseInteractable;

    // Logic for interactable registered event goes here
    if (interactable != null && interactable == m_ExampleInteractable)
        Debug.Log(args.interactableObject.transform.name + " is registered with " + args.manager.transform.name, this);
}

void OnInteractableUnregistered(InteractableUnregisteredEventArgs args)
{
    // Example of casting args objects to interactable base class
    var interactable = args.interactableObject as XRBaseInteractable;

    // Logic for interactable unregistered event goes here
    if (interactable != null && interactable == m_ExampleInteractable)
        Debug.Log(args.interactableObject.transform.name + " is unregistered with " + args.manager.transform.name, this);
}

void OnSnapVolumeRegistered(InteractableSnapVolumeRegisteredEventArgs args)
{
    // Logic for snap volume registered event goes here
    if (args.snapVolume != null && args.snapVolume == m_ExampleSnapVolume)
        Debug.Log(args.snapVolume.transform.name + " is registered with " + args.manager.transform.name, this);
}

void OnSnapVolumeUnregistered(InteractableSnapVolumeUnregisteredEventArgs args)
{
    // Logic for snap volume unregistered event goes here
    if (args.snapVolume != null && args.snapVolume == m_ExampleSnapVolume)
        Debug.Log(args.snapVolume.transform.name + " is unregistered with " + args.manager.transform.name, this);
}



}

Properties

interactorObject

The Interactor that was unregistered.

Declaration
public IXRInteractor interactorObject { get; set; }
Property Value
Type Description
IXRInteractor
See Also

managerDestroyed

Whether the unregistration event was due to the manager being destroyed.

Declaration
public bool managerDestroyed { get; set; }
Property Value
Type Description
bool
See Also

See Also