1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Cinemachine Cameraが屋根のある空間に入るとその屋根の上に乗ってしまう

1
Last updated at Posted at 2026-02-05

すこしハマったのでメモを残します。

バージョン

  • Unity 6.3 LST
  • Cinemachine 3.1.5

カメラの構成

  • Cinemachine Orbital Follow
  • Cinemachine Hard Look At
  • Cinemachine Decollider
  • Cinemachine Input Axis Controller

現象

Cinemachine DecolliderのついたCinemachine Cameraが、頭上のふさがったトンネルのような空間に入るとカメラが頭上の障害物のさらに上に乗ってしまいます。

画像のような状況で発生します
image.png

原因

公式ドキュメントに原因について記述されています。
https://docs.unity3d.com/Packages/com.unity.cinemachine@3.1/manual/CinemachineDecollider.html

ドキュメントによるとCinemachine DecolliderのTerrain Resolutionが有効だと、カメラの位置から真下をみて最初にヒットした位置に移動させようとします。つまり頭上がふさがった空間の時、そのふさいでいるオブジェクトの上にカメラが移動してしまいます。

image.png

対処

対処としてはTerrain Resolutionを無効にすることです。
しかし、Terrain Resolutionは地形にカメラがめり込まないようにするためのオプションだと思うので無効にしたらいろいろと問題ありそうな気がします が、ここでは気にしません。

こういうとき使用するExtensionがあります。

Cinemachine Deoccluder

このExtensionはCameraとTracking Targetの間にある障害物を回避するようカメラを動かします。

image.png

パラメータの意味は公式ドキュメントを当たってもらうとして、これを追加すると
カメラが屋根の上に乗ってしまう現象を改善できます。

Deoccluderの効果を動画でみる

Youtube Deoclluderデモ

Tips

Deoccluderはカメラの位置からTracking Targetの間の障害物を検出します。Third Person Viewのカメラの前にプレイヤーがくると、そのプレイヤーも障害物として回避しようとしてしまいます。ここではIgnore TagでPlayerを無視することで解消しています。

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?