[iOS] WWDC23: Meet ActivityKit / Live Activity 알아보기

WWDC23: Meet ActivityKit

https://developer.apple.com/documentation/ActivityKit
https://developer.apple.com/documentation/activitykit/displaying-live-data-with-live-activities

• Live Activity 에 대한 개요
• Live Activity 의 생명주기 (Life cycle)
• Live Activity UI 구축하기

Live Acitvity overview

Live Activity 는 이벤트나 작업 진행 상황을 한눈에 알아볼 수 있는 방법이다.

• 각각의 시작과 끝을 가지고 있고,
• 백그라운드 앱 런타임에서 실시간 업데이트를 제공하거나,
• 푸시 알림을 사용해서 원격으로 제공할 수도 있다.

iPhone 14 Pro, Pro Max 에서는 Dynamic Island 를 통해 Live Activity 가 표시된다.

• 앱이 백그라운드에 있을 때 시스템 전체에 Live Activity 를 표시하고,
• Live Activity 는 "compact" 프레젠테이션을 사용해서 렌더링되고, 한번에 최대 2개가 표시된다.
• "minimal" 사이즈로 표시되고, 길게 누르면 "expanded" 프레젠테이션으로 볼 수 있다.

Interactive Live Activities

iOS17 에서는 WidgetKit, SwiftUI 를 사용해서 버튼이나 토글을 추가하는 등 Live Acitvity 에 상호작용 기능을 추가할 수 있다.

• WWDC23: Bring widgets to life

overview

• Live Activity 는 ActivityKit 프레임워크을 사용해서 생명주기를 요청, 업데이트 관리할 수 있도록 지원된다.
• SwiftUI 와 WidgetKit 을 사용해서 선언적으로 배치된다.
• 앱이 포그라운드 상태에 있을 때 Live Activity 를 요청할 수 있고, 사용자의 액션이 있는 경우에만 요청해야 한다.
  • Live Activity 는 알림과 비슷하게 사용자가 조정하고, 앱에서 쉽게 끌 수 있다.
• 잠금 화면과 다이나믹 아일랜드의 세개의 프레젠테이션을 지원해야한다.
• 백그라운드 런타임 외에도 푸시 알림을 통해 원격으로 업데이트 할 수 있다.
  • 푸시 타입이 liveactivity 인 푸시를 보낼 수 있다.
  • WWDC23: Update Live Activities with push notifications

Lifecycle of Live Activities

• Request : activity 에 요청을 보내 시작하기
• Update : 최근 콘텐츠로 업데이트하기
• Observe activity state : 변화되는 상태를 관찰하기
• End : 작업 종료시 activity 도 종료하기

Request

포그라운드 상태의 앱에서 초기 콘텐츠와 필요한 activity request data 를 갖도록 구성한다.

https://developer.apple.com/documentation/activitykit/activityattributes
ContentState 라는 이너타입이 Live Activity 의 다이나믹 콘텐츠를 표시한다.

• hero 라는 정적 데이터 하나를 갖고 있는 AdventureAttributes
• 히어로의 HP 랑 이벤트 설명에 대한 ContentState 를 정의한다.
  • 해당 속성들이 변경되면 live activity UI 가 업데이트된다.

• Content State 의 초기값을 설정하고, ActivityContent 를 생성해준다.
  • staleDate 는 activity 콘텐츠가 보여주는 데이터가 out of date 으로 간주되는 시기를 시스템에 알릴 수 있는 값이다.
  • relevenceScore 는 live activity 간 우선순위를 설정하는 값이다. 두개 이상 activity 가 보여질때 우선되거나, 잠금 화면에서의 동작에 사용된다.
• ActivityAttributes, ActivityContent 와 push type 을 설정해서 request 를 보낸다.
  • push type 은 푸시를 통해 동적 콘텐츠에 대한 업데이트를 수신하는지 여부를 뜻한다.
  • nil 로 설정하게 되면 로컬 업데이트만 받을 수 있음을 뜻한다.

Update

• dynamic attirubtes 는 live activity 를 업데이트할 시기를 알려준다.
• 체력이 변경될 때 ContentState 를 새롭게 만들고, Alert 를 생성하고, live activity 에 업데이트 API 를 호출한다.

Observe activity state

• live activity 의 생명주기 내에서는 언제든지 Activity State 는 변경될 수 있다.
  • started, finished, dismissed, stale 4가지 상태
  • activityStateUpdates API 를 통해 위의 상태들을 관찰해서 업데이트를 비동기로 수신할 수 있다.

• activityState API 를 통해서도 동기적으로 상태를 체크할 수 있다.

End

• live activity 를 종료하기 위해서 그에 맞는 ContentState 를 생성하고, dismissalPolicy 를 지정해서 activity 를 종료한다.

Building Live Activity UI

• WidgetBundle 에 Live Activity 에 관한 설정을 추가해준다.

• 위젯과 동일하게 WidgetConfiguration 타입의 body 를 작성해준다.
• ActivityConfiguration 객체를 통해서 Live Activity 의 콘텐츠에 대해 설정할 수 있고,
• presentation 클로저마다 화면에 보여질 UI 를 구성할 수 있다.

Lock screen presentation

• 첫번째 클로저는 잠금 화면에 대한 UI 를 지정한다.

 

Compact presentation

• compact 타입에서는 leading 과 trailing 영역을 따로 설정할 수 있다.

 

Minimal presentation

• 여러 (최대 두개..) 앱이 Live Activity 에 띄워질 경우에는 minimal 형태로 띄워진다.
• 하나는 다이나믹 아일랜드의 왼쪽편에 live activity 가 나타나고, 다른 하나는 오른쪽에 분리된 영역으로 나타난다.

 

 

Expand presentation

• Live activity 를 꾹 누르면 expand 형태로 볼 수 있는데, 이 영역도 Leading, Trailing, Center, Bottom 으로 나뉘어져 있다.

  • 

• leading

  • 

• trailing

  • 

• bottom

  • 

Designing Live Activity UI

• 필수적인 콘텐츠를 담고, 심플하게 디자인하는 것이 중요하다 🙂
  • Design dynamic Live Activities