Adding OnBlockBegin & OnBlockEnd UnityEvents

Author: ahmed-shariff

Assets/UXF/Scripts/Etc/Events.cs

@@ -15,6 +15,15 @@ public class SessionEvent : UnityEvent<Session>
 
     }
 
+    /// <summary>
+    /// Event containing a Block as a parameter
+    /// </summary>
+    [Serializable]
+    public class BlockEvent : UnityEvent<Block>
+    {
+
+    }
+
     /// <summary>
     /// Event containing a Trial as a parameter
     /// </summary>

Assets/UXF/Scripts/Etc/Trial.cs

@@ -119,6 +119,12 @@ public void Begin()
                     Utilities.UXFDebugLogWarning("An item in the Tracked Objects field of the UXF session if empty (null)!");
                 }
             }
+
+            if (this == block.firstTrial)
+            {
+                // call block on begin event
+            }
+
             session.onTrialBegin.Invoke(this);
         }
 
@@ -137,6 +143,11 @@ public void End()
             }
 
             session.onTrialEnd.Invoke(this);
+
+            if (this == block.lastTrial)
+            {
+                // call block on end event
+            }
         }
 
         public bool CheckDataTypeIsValid(string dataName, UXFDataType dataType)

Assets/UXF/Scripts/Session.cs

@@ -93,6 +93,13 @@ public class Session : MonoBehaviour, IExperimentUnit, IDataAssociatable
         [Tooltip("Items in this event will be triggered when the session begins. Useful generating your trials & blocks, setting up the scene, and triggering the first trial.")]
         public SessionEvent onSessionBegin = new SessionEvent();
 
+        /// <summary>
+        /// Event(s) to trigger when a block begins. Can pass the instance of the Block as a dynamic argument
+        /// </summary>
+        /// <returns></returns>
+        [Tooltip("Items in this event will be triggered each time a block begins.")]
+        public BlockEvent onBlockBegin = new BlockEvent();
+
         /// <summary>
         /// Event(s) to trigger when a trial begins. Can pass the instance of the Trial as a dynamic argument
         /// </summary>
@@ -107,6 +114,13 @@ public class Session : MonoBehaviour, IExperimentUnit, IDataAssociatable
         [Tooltip("Items in this event will be triggered each time a trial ends. Useful for collecting results from the trial as well as showing feedback.")]
         public TrialEvent onTrialEnd = new TrialEvent();
 
+        /// <summary>
+        /// Event(s) to trigger when a block ends. Can pass the instance of the Block as a dynamic argument
+        /// </summary>
+        /// <returns></returns>
+        [Tooltip("Items in this event will be triggered each time a block ends.")]
+        public BlockEvent onBlockEnd = new BlockEvent();
+
         /// <summary>
         /// Event(s) to trigger just before the session has ended. If you wish to perform any summary statistics or write any final session data this is the time to do it. Do not use this event to quit the application.
         /// </summary>