Interface ICameraSystem
Camera System Gameplay 진입점 계약. Gameplay 코드는 이 인터페이스 하나만 주입받는다.
public interface ICameraSystem
Remarks
[규칙] Gameplay 코드에서 CameraBrain / ICameraBrain 직접 참조 금지. [규칙] RegisterBehavior / RegisterModifier 등 저수준 API는 이 인터페이스에 노출하지 않는다. 확장이 필요하면 CameraSystemSample 의 고급 확장 패턴을 참고한다.
Methods
DisableAim()
조준 모드 해제.
void DisableAim()
EnableAim()
조준 모드 진입. FOV 축소 및 오프셋 적용.
void EnableAim()
EnterCinematic()
연출 모드 진입. Authority 획득 → Gameplay 카메라 정지 → Cinemachine 활성화.
void EnterCinematic()
ExitCinematic()
연출 모드 종료. Cinemachine 비활성 → Authority 반납 → 이전 모드 복귀.
void ExitCinematic()
Initialize(SpectatorCameraProfile)
관전 프로파일 기반 초기화.
void Initialize(SpectatorCameraProfile profile)
Parameters
profileSpectatorCameraProfile
Initialize(Transform, FirstPersonCameraProfile)
1인칭 프로파일 기반 초기화.
void Initialize(Transform followTarget, FirstPersonCameraProfile profile)
Parameters
followTargetTransformprofileFirstPersonCameraProfile
Initialize(Transform, QuarterViewCameraProfile)
QuarterView 프로파일 기반 초기화.
void Initialize(Transform followTarget, QuarterViewCameraProfile profile)
Parameters
followTargetTransformprofileQuarterViewCameraProfile
Initialize(Transform, ThirdPersonCameraProfile)
TPS 프로파일 기반 초기화.
Start() 에서 1회 호출. 이후 SetMode 로 모드를 지정한다.
void Initialize(Transform followTarget, ThirdPersonCameraProfile profile)
Parameters
followTargetTransformprofileThirdPersonCameraProfile
Initialize(Transform, TopDownCameraProfile)
TopDown 프로파일 기반 초기화.
void Initialize(Transform followTarget, TopDownCameraProfile profile)
Parameters
followTargetTransformprofileTopDownCameraProfile
LockOn()
자동 탐색으로 LockOn 활성화.
void LockOn()
LockOn(Transform)
지정 타겟으로 LockOn 활성화.
void LockOn(Transform target)
Parameters
targetTransform
Recoil(Vector3)
반동 추가. 누적 가능.
void Recoil(Vector3 recoil)
Parameters
recoilVector3
SetFollowTarget(Transform)
추적 대상 런타임 교체. 차량 탑승 / 빙의 등.
void SetFollowTarget(Transform target)
Parameters
targetTransform
SetMode(CameraModeType)
기본 블렌드로 모드 전환.
void SetMode(CameraModeType mode)
Parameters
modeCameraModeType
SetMode(CameraModeType, bool)
즉시 전환 (블렌드 없음) 또는 duration 오버라이드.
void SetMode(CameraModeType mode, bool instant)
Parameters
modeCameraModeTypeinstantbool
SetMode(CameraModeType, float)
블렌드 지속 시간을 지정해 모드 전환.
void SetMode(CameraModeType mode, float blendDuration)
Parameters
modeCameraModeTypeblendDurationfloat
Shake(ShakeConfig)
카메라 흔들림 트리거.
void Shake(ShakeConfig config)
Parameters
configShakeConfig
Unlock()
LockOn 해제.
void Unlock()