Cinemachine Camera Manager Events
When Cinemachine Cameras are activated, global events are sent via CinemachineCore. Scripts can add listeners to those events and take action based on them. Listeners will receive events for all cameras and all brains.
Sometimes it's desirable to have events sent only for a specific Cinemachine Camera Manager, so that scripts can be notified based on this specific objects's activity without having to provide code to filter the events. The Cinemachine Brain Events component fills this need.
It will expose events that will be fired based on the target objects's activity. Any listeners you add will be called when the events happen for that object. The target object can be specified explicitly in the Camera Manager field, or you can leave that null and add this script directly to the object with the CinemachineBrain component
If you are looking for events that fire for a specific CinemachineCamera, see Cinemachine Camera Events.
If you are looking for events that fire for a specific CinemachineBrain, see Cinemachine Brain Events.
Properties:
Property: | Function: |
---|---|
Camera Manager | This is the CinemachineCameraManager emitting the events. If null and the current GameObject has a CinemachineCameraManager component, that component will be used. |
Camera Activated Event | This is called at the beginning of a blend, when a camera becomes live. Parameters are: brain, incoming camera. A cut is considered to be a blend of length zero. |
Camera Deactivated Event | This event will fire whenever a Cinemachine Camera stops being live. If a blend is involved, then the event will fire after the last frame of the blend. |
Blend Created Event | This event will fire whenever a new Cinemachine blend is created. Handlers can modify the settings of the blend (but not the cameras). Note: BlendCreatedEvents are NOT sent for timeline blends, as those are expected to be controlled 100% by timeline. To modify the blend algorithm for timeline blends, you can install a handler for CinemachineCore.GetCustomBlender. |
Blend Finished Event | This event will fire whenever a Cinemachine Camera finishes blending in. It will not fire if the blend length is zero. |
Camera Cut Event | This is called when a zero-length blend happens. |