Camera Service

Description

Orchestrates dialogue camera behaviour during conversations. Manages the enter/exit dialogue camera lifecycle, applies automatic and beat-driven shots, and delegates to the active camera provider for framing.

Shot selection is a rule system and shot application is a provider, so the service itself holds no camera logic -- it decides when a shot is needed and hands the request on. See Camera and Camera Rules.

Interface

Type
IDialogueCameraService

Inherits

Type
N/A

Properties

Name	Type	Description
IsActive	bool	True while the dialogue camera is in control.

Public Methods

Name	Parameters	Return Type	Description
EnterDialogue	Transform speaker, Transform listener	void	Enters dialogue camera mode for a two-participant conversation.
EnterDialogue	Transform speaker, Transform listener, IReadOnlyList<Transform> additionalParticipants	void	Enters dialogue camera mode for a group conversation.
ExitDialogue	N/A	void	Exits dialogue camera mode and restores the previous camera.
ApplyBeatShot	CameraDialogueBeat beat, DialoguePresentationContext context	void	Applies a specific camera beat's shot configuration.
ApplyAutoShot	DialoguePresentationContext context, string moodId	void	Selects and applies a shot automatically using the rule system.
UpdateSpeakerContext	Transform speaker, Transform listener	void	Updates who is speaking without re-entering dialogue, so shots reframe correctly.

Mood reaches the camera as a string moodId rather than a MoodState, and is turned into a shot hint by IMoodCameraHintResolver.

---