EyeBlink

업데이트： 2020/01/30

개요

EyeBlink는 눈 깜빡임용 파라미터의 현재 값에 개폐 상태 값을 적용하는 기능입니다.
모델에 눈 깜빡임용 파라미터를 설정하는 방법은 여기를 참조하십시오.

눈 깜빡임용 파라미터 지정은 모델 자체에 설정하는 것 외에 Unity에서 사용자가 임의로 지정할 수 있습니다.

Cubism SDK for Unity의 EyeBlink는 세 가지 요소로 구성됩니다.

1. 파라미터 지정용 컴포넌트
2. 각 파라미터에 값을 적용하는 컴포넌트
3. 2에서 적용하는 값 조작

1. 파라미터 지정용 컴포넌트

EyeBlink에 사용할 파라미터를 지정하려면 CubismEyeBlinkParameter를 사용합니다.

CubismEyeBlinkParameter는 MonoBehaviour를 계승한 컴포넌트로,
[Prefab 루트]/Parameters/ 아래에 배치된 GameObject에 연결하여 사용합니다.
이것이 연결된 GameObject와 같은 ID의 파라미터를 눈 깜빡임용 파라미터로서 취급합니다.

모델 자체에 눈 깜빡임용 파라미터가 설정되어 있으면 가져올 때 해당 파라미터의 GameObject에 CubismEyeBlinkParameter가 연결됩니다.

CubismEyeBlinkParameter는 참조처를 취득하기 위한 마커로서 사용하므로, 내부에서는 아무것도 처리하지 않고 데이터도 가지고 있지 않습니다.

2. 각 파라미터에 값을 적용하는 컴포넌트

각 파라미터에 개폐 값을 적용하려면 CubismEyeBlinkController를 사용합니다.
이것은 MonoBehaviour를 상속받은 컴포넌트이며, 사용할 때 Cubism의 Prefab 루트에 연결됩니다.

초기화 시 Prefab에 연결된 모든 CubismEyeBlinkParameter의 참조를 취득합니다.
실행 중에 눈 깜빡임용 파라미터를 추가/삭제한 경우 CubismEyeBlinkController.Refresh()를 호출해 참조를 다시 취득합니다.

        /// <summary>
        /// Refreshes controller. Call this method after adding and/or removing <see cref="CubismEyeBlinkParameter"/>s.
        /// </summary>
        public void Refresh()
        {
            var model = this.FindCubismModel();
 
 
            // Fail silently...
            if (model == null)
            {
                return;
            }
 
 
            // Cache destinations.
            var tags = model
                .Parameters
                .GetComponentsMany<CubismEyeBlinkParameter>();
 
 
            Destinations = new CubismParameter[tags.Length];
 
 
            for (var i = 0; i < tags.Length; ++i)
            {
                Destinations[i] = tags[i].GetComponent<CubismParameter>();
            }
 
            // Get cubism update controller.
            HasUpdateController = (GetComponent<CubismUpdateController>() != null);
        }
        
        
        ...
        
        
        /// <summary>
        /// Called by Unity. Makes sure cache is initialized.
        /// </summary>
        private void Start()
        {
            // Initialize cache.
            Refresh();
        }

CubismEyeBlinkController는 매 프레임의 LateUpdate() 타이밍에 CubismEyeBlinkParameter로 마킹된 파라미터에 CubismEyeBlinkController.EyeOpening의 값을 적용합니다.

            // Apply value.
            Destinations.BlendToValue(BlendMode, EyeOpening);

EyeOpening에 설정하는 값은 0.0f~1.0f 범위입니다.
CubismEyeBlinkController는 이 값을 대상 파라미터에 CubismEyeBlinkController.BlendMode에서 설정된 계산 방식으로 적용합니다.

이 EyeOpening의 값을 밖에서 조작하면 모델의 눈을 열고 닫을 수 있습니다.

        /// <summary>
        /// Opening of the eyes.
        /// </summary>
        [SerializeField, Range(0f, 1f)]
        public float EyeOpening = 1f;

3. 2에서 적용하는 값의 조작

「2. 각 파라미터에 값을 적용하는 컴포넌트」에서 설명한 대로 CubismEyeBlinkController.EyeOpening의 값을 조작하여 눈 깜빡임용 파라미터에 값을 적용할 수 있습니다.
Cubism SDK for Unity는 다음 두 가지 방법으로 이 값을 조작할 수 있습니다.

• 모션으로 값 조작
• 컴포넌트로 값 조작

또 유저 측에서 이 값을 조작하는 처리를 구현하시면 눈 깜빡임 속도나 타이밍 등을 독자적으로 커스터마이즈 할 수 있습니다.

모션으로 값 조작

눈 깜빡임용 파라미터를 설정한 모델을 사용하여 Cubism의 Animator에서 모션을 만들 경우 눈 깜빡임용 커브를 설정할 수 있습니다.

눈 깜빡임용 커브가 설정된 .motion3.json을 Unity 프로젝트로 가져오면 AnimationClip은 CubismEyeBlinkController.EyeOpening의 값을 대상으로 커브를 생성합니다.
그 때문에, AnimationClip를 Animator 컴포넌트 등에서 재생하면 CubismEyeBlinkController.EyeOpening의 값이 조작됩니다.

컴포넌트로 값 조작

Cubism SDK for Unity에서는 CubismAutoEyeBlinkInput 컴포넌트를 사용하여 눈 깜빡임용 값을 조작할 수도 있습니다.

CubismAutoEyeBlinkInput은 Inspector에서 설정한 속도나 간격, 간격에 가하는 랜덤한 흔들림의 폭으로부터 눈 깜빡임용 값을 산출해 설정합니다.

       private void LateUpdate()
        {
            // Fail silently.
            if (Controller == null)
            {
                return;
            }
 
 
            // Wait for time until blink.
            if (CurrentPhase == Phase.Idling)
            {
                T -= Time.deltaTime;
 
 
                if (T < 0f)
                {
                    T = (Mathf.PI * -0.5f);
                    LastValue = 1f;
                    CurrentPhase = Phase.ClosingEyes;
                }
                else
                {
                    return;
                }
            }
 
 
            // Evaluate eye blinking.
            T += (Time.deltaTime * Timescale);
            var value = Mathf.Abs(Mathf.Sin(T));
 
 
            if (CurrentPhase == Phase.ClosingEyes && value > LastValue)
            {
                CurrentPhase = Phase.OpeningEyes;
            }
            else if (CurrentPhase == Phase.OpeningEyes && value < LastValue)
            {
                value = 1f;
                CurrentPhase = Phase.Idling;
                T = Mean + Random.Range(-MaximumDeviation, MaximumDeviation);
            }
 
 
            Controller.EyeOpening = value;
            LastValue = value;
        }

CubismAutoEyeBlinkInput에는 세 가지 설정 항목이 있습니다.

• Mean
• MaximumDeviation
• Timescale

        /// <summary>
        /// Mean time between eye blinks in seconds.
        /// </summary>
        [SerializeField, Range(1f, 10f)]
        public float Mean = 2.5f;
 
        /// <summary>
        /// Maximum deviation from <see cref="Mean"/> in seconds.
        /// </summary>
        [SerializeField, Range(0.5f, 5f)]
        public float MaximumDeviation = 2f;
 
        /// <summary>
        /// Timescale.
        /// </summary>
        [SerializeField, Range(1f, 20f)]
        public float Timescale = 10f;

• Mean

눈 깜빡임까지의 시간을 설정합니다.
단위는 초입니다.
실제로는 이 값에 Maximum Deviation에 의한 오차를 더한 시간이 사용됩니다.

• MaximumDeviation

Mean에 설정한 시간에 추가하는 임의의 흔들림 폭을 설정합니다.
이들은 다음과 같이 값을 계산합니다.

 Mean + Random.Range(-MaximumDeviation, MaximumDeviation)

• Timescale

눈 깜빡임 속도입니다.
이전 프레임으로부터의 경과 시간에 곱해집니다.