animateKeyframes(withDuration:delay:options:animations:completion:) 🍎

1️⃣ 정의

현재 뷰에 대한 키프레임 기반 애니메이션을 설정할 수 있는 애니메이션 블록 객체를 생성

class func animateKeyframes(
    withDuration duration: TimeInterval,
    delay: TimeInterval,
    options: UIView.KeyframeAnimationOptions = [],
    animations: @escaping () -> Void,
    completion: ((Bool) -> Void)? = nil
)

2️⃣ 설명

• 이 메서드는 키프레임 기반 애니메이션을 설정할 수 있는 애니메이션 블록을 생성함

  키프레임 기반 애니메이션

  • 애니메이션의 시작부터 끝까지 중요한 프레임(키프레임)을 명시적으로 정의하여 애니메이션을 제어하는 기술
  • 각 키프레임에서 뷰 또는 객체의 속성(위치, 크기, 회전 등)을 설정하고, 시스템은 이러한 키프레임 사이의 중간 프레임을 자동으로 계산하여 부드러운 애니메이션 효과를 생성함
  • 키프레임(Keyframes): 애니메이션의 시작과 끝을 나타내는 중요한 시점
  • 보간(Interpolation): 키프레임 사이의 중간 프레임은 시스템이 자동으로 계산하여 객체의 속성을 부드럽게 전환
  • 시간 제어(Time Control): 각 키프레임은 애니메이션의 진행 시간을 나타내는 시간값과 연결됨
  • 커브 및 이징(Easing): 키프레임 간의 보간에 사용되는 곡선을 조절하여 애니메이션의 속도와 효과를 조절함

• 그러나 키프레임 자체는 이 메서드를 사용하여 초기에 생성한 애니메이션 블록의 일부가 아님
• 애니메이션 블록 내부에서는 addKeyframe(withRelativeStartTime:relativeDuration:animations:) 메서드를 한 번 이상 호출하여 키프레임 시간과 애니메이션 데이터를 추가해야함
• 키프레임을 추가하면 시스템은 지정한 시간에 따라 현재 뷰 값에서 첫 번째 키프레임의 값으로, 다음 키프레임의 값으로, 그리고 지정한 시간에 따라 뷰를 애니메이션화함
• 만약 animations 블록 내에서 어떠한 키프레임도 추가하지 않으면, 애니메이션은 표준 애니메이션 블록처럼 시작에서 끝까지 진행됨
• 다시 말해, 시스템은 현재 뷰 값에서 새 값으로 지정된 기간 동안 애니메이션화함

📌 Concurrency

• 이 메서드는 다음과 같이 선언된 비동기 메서드로 호출할 수 있음

class func animateKeyframes(
    withDuration duration: TimeInterval, 
    delay: TimeInterval, 
    options: UIView.KeyframeAnimationOptions = [], 
    animations: @escaping () -> Void
) async -> Bool

• 물론 이 페이지에서 보여주는 대로 완료 핸들러를 사용하여 동기 코드에서도 호출할 수 있음

📌 Parameters

• duration: 전체 애니메이션의 지속 시간으로, 초 단위로 측정됨. 음수 값이나 0을 지정하면 변경 사항이 즉시 애니메이션 없이 적용됨.
• delay: 애니메이션 시작 전에 대기해야 하는 시간(초 단위)을 지정함
• options: 어떻게 애니메이션을 수행할지를 나타내는 옵션의 마스크

  마스크

  • 여러 옵션 또는 상태를 조합하거나 설정하기 위해 사용되는 비트 패턴

• animations: 뷰에 커밋할 변경 사항을 포함하는 블록 객체. 일반적으로 이 블록 내에서 addKeyframe(withRelativeStartTime:relativeDuration:animations:) 메서드를 한 번 이상 호출함. 또한, 변경 사항이 전체 기간 동안 애니메이션화되기를 원하는 경우 뷰 값 자체를 직접 변경할 수도 있음. 이 블록은 매개변수를 받지 않으며 반환 값을 갖지 않아야 함. 이 매개변수에는 nil 값을 사용하면 안됨
• completion: 애니메이션 시퀀스가 종료될 때 실행할 블록 객체. 이 블록은 반환 값을 갖지 않으며, 애니메이션이 완료되었는지 여부를 나타내는 단일 Bool 인수를 받음. 애니메이션의 지속 시간이 0인 경우, 이 블록은 다음 실행 루프 주기의 시작 시에 실행됨 이 매개변수에는 nil 값을 사용할 수 있음

📌 options

• UIView.KeyframeAnimationOptions
• 키프레임 기반 애니메이션을 구성하는 옵션들

---

출처📚

🍎Apple Docs: animateKeyframes(withDuration:delay:options:animations:completion:)
🍎Apple Docs: UIView.KeyframeAnimationOptions