Files
UmaViewer/Assets/Scripts/Audio/CRIMW/CriWare/Runtime/Scripts/CriAtom/CriAtomRegion.cs
T
2022-09-10 16:59:44 +08:00

111 lines
2.9 KiB
C#

/****************************************************************************
*
* Copyright (c) 2020 CRI Middleware Co., Ltd.
*
****************************************************************************/
using UnityEngine;
using System.Collections.Generic;
/**
* \addtogroup CRIATOM_UNITY_COMPONENT
* @{
*/
namespace CriWare {
/**
* <summary>3D region component</summary>
* <remarks>
* <para header='Description'>A component that groups 3D sound sources, 3D listeners and transceivers by space.<br/>
* Used by attaching to any GameObject.<br/>
* This can be used as an value of region3d in CriAtomSource, CriAtomListener and CriAtomTransceiver,<br/>
* or can be set as initial region setting.<br/>
* Only one of this component can be attached to a GameObject.</para>
* </remarks>
* <seealso cref='CriAtomSource'/>
* <seealso cref='CriAtomListener'/>
* <seealso cref='CriAtomTransceiver'/>
*/
[AddComponentMenu("CRIWARE/CRI Atom Region"), DisallowMultipleComponent]
public class CriAtomRegion : CriMonoBehaviour
{
#region Fields & Properties
/**
* <summary>The CriAtomEx3dRegion used internally.</summary>
* <remarks>
* <para header='Description'>If you want to control CriAtomEx3dRegion directly, get CriAtomEx3dRegion from this property.</para>
* </remarks>
*/
public CriAtomEx3dRegion region3dHn { get; protected set; }
#endregion
#region Private Fields & Properties
internal List<CriAtomSourceBase> referringSources = new List<CriAtomSourceBase>();
internal List<CriAtomListener> referringListeners = new List<CriAtomListener>();
internal List<CriAtomTransceiver> referringTransceivers = new List<CriAtomTransceiver>();
#endregion
#region Methods
private void Awake()
{
this.InternalInitialize();
}
protected override void OnEnable()
{
base.OnEnable();
this.InitializeParameters();
}
private void OnDestroy()
{
this.InternalFinalize();
}
protected virtual void InternalInitialize()
{
CriAtomPlugin.InitializeLibrary();
this.region3dHn = new CriAtomEx3dRegion();
}
protected virtual void InternalFinalize()
{
/* Clear references to this region */
while (referringSources.Count > 0) {
referringSources[0].region3d = null;
}
referringSources.Clear();
while (referringListeners.Count > 0) {
referringListeners[0].region3d = null;
}
referringListeners.Clear();
while(referringTransceivers.Count > 0) {
referringTransceivers[0].region3d = null;
}
referringTransceivers.Clear();
region3dHn.Dispose();
region3dHn = null;
CriAtomPlugin.FinalizeLibrary();
}
protected virtual void InitializeParameters()
{
if (this.region3dHn == null) {
Debug.LogError("[CRIWARE] Internal: CriAtomEx3dRegion is not created correctly.", this);
return;
}
}
public override void CriInternalUpdate() { }
public override void CriInternalLateUpdate() { }
#endregion
} // end of class
} //namespace CriWare
/** @} */
/* end of file */