지갑의 새로운 기능

안녕하세요, 지갑의 새로운 기능 세션에 잘 오셨습니다 저는 Pavel입니다 Wallet 팀의 엔지니어죠 오늘의 세션에서는 올해 지갑에 추가될 새로운 기능과 패스에 적용하는 방법을 알아보겠습니다 예정된 이벤트 정보를 티켓에 추가하는 방법부터 설명하겠습니다 티켓 소지자는 티켓에 포함된 이벤트에 쉽게 참석할 수 있죠 그런 다음 탑승권을 업그레이드하는 방법을 알려 드립니다 완전히 새로운 디자인으로 여행 내내 승객에게 필요한 모든 항공편 정보를 제공하죠 마무리하면서는 새 PKPassLibrary API 사용 방법을 설명하겠습니다 일회성 인증 프롬프트 후 iOS 앱을 사용하면 자동으로 지갑에 패스를 추가할 수 있습니다 다룰 내용이 많으니 곧 다가올 이벤트로 바로 넘어가 보죠 작년에 지갑은 포스터 이벤트 티켓을 도입했습니다 시맨틱 태그로 새로운 디자인을 구현했으며 이벤트에 대한 유용한 컨텍스트를 제공하고 장소까지 길 안내를 지도 링크, 이벤트에 대한 세부 정보와 앱의 추가 서비스를 보여주는 이벤트 안내서가 포함되어 있습니다 올해 포스터 이벤트 티켓은 예정된 이벤트를 지원하여 하나의 티켓으로 여러 이벤트에 쉽게 접근할 수 있습니다

예정된 이벤트를 탭하면 자세한 화면이 열리며 포스터 이벤트 티켓의 구조를 반영합니다 이 화면은 이벤트에 대한 새 아트워크, 장소 정보, 전체 이벤트 가이드와 이 이벤트에 특화된 기타 정보로 구성될 수 있습니다 예정된 이벤트는 iOS 18에 도입된 포스터 이벤트 티켓 시맨틱을 활용합니다 시맨틱 구조의 작동 방식에 대한 개요는 WWDC24의 '지갑 및 Apple Pay의 새로운 기능'을 시청하시길 바랍니다 이제 pass.json에서 예정된 이벤트를 구성하는 방법을 보죠 예정된 이벤트는 새 "upcomingPassInformation" 배열에 정의되어 있고 모든 이벤트를 포함하고 있죠 지갑은 예정된 이벤트 목록에 표시되어야 합니다 "upcomingPassInformation" 배열의 각 오브젝트에서 유형을 "event"로 설정하고 고유 식별자, 이벤트의 표시 이름, 이벤트 날짜를 포함해야 합니다

이러한 필드는 예정된 이벤트에 대한 세부 정보 화면에 눈에 띄게 표시됩니다

예정된 이벤트 객체는 포스터 이벤트 티켓을 빌드하는 데 사용된 동일한 구조를 따릅니다

이벤트에 대한 정보는 "semantics" 객체를 포함하고 시맨틱에 포함되지 않는 맞춤형 속성은 "additionalnfoFields" 또는 "backFields"를 포함하죠 새 "URL" 객체는 이 이벤트와 관련된 모든 작업을 그룹화하고 "images" 객체는 이벤트 관련 이미지를 구성합니다 이러한 객체가 예정된 이벤트의 UI를 구성하는 방법을 보여 드리죠 예정된 이벤트 화면의 상단에서 시작하여 지갑은 이벤트를 나타내는 헤더 이미지를 표시합니다 기본적으로 패스의 배경 이미지가 여기에 표시됩니다 이미지를 찾을 수 있는 URL을 지정하여 예정된 이벤트에 사용자 정의 "headerImage"를 추가할 수 있습니다

예정된 이벤트는 iOS 및 watchOS 기기에 표시되므로 디스플레이 비율에 맞게 별도의 이미지를 제공하는 것이 좋습니다 그러면 지갑이 표시되는 기기에 가장 적합한 이미지를 선택할 수 있습니다

헤더 아래에는 "venueName"이 표시되는 타일이 있고 티켓 소지자는 지도에서 장소를 볼 수 있습니다 이 기능은 패스에 사용되는 것과 동일한 시맨틱을 활용합니다 예정된 이벤트 시맨틱 객체에서 "venueName", "venuePlaceID" 및 "venueLocation" 시맨틱을 사용해 장소 정보를 추가했습니다 이 시맨틱 객체는

해당 이벤트를 설명하는 모든 시맨틱을 추가해야 하는 위치입니다 공연자나 좌석 정보와 같은 내용을 포함하여 지갑이 해당 정보를 적절한 위치에 표시되도록 합니다 예를 들어, 예정된 이벤트를 위해 좌석을 추가했으므로 지갑은 이러한 정보를 세부 정보 화면에 바로 표시합니다

장소 이름, 좌석 등 몇 가지 시맨틱은 이 화면에 눈에 띄게 표시됩니다 그 외 대부분의 정보는 예정된 정보를 채우며 iOS 18에서 도입된 패스 이벤트 가이드와 동일한 방식으로 작동합니다

예정된 이벤트 가이드는 예정된 이벤트 전용이며 예정된 이벤트 객체의 내용으로 채워집니다 이벤트 가이드는 일반 동작에 빠르게 접근할 수 있는 버튼을 구성할 수 있습니다 이벤트의 위치 시맨틱 정보를 사용한 날씨 타일, 장소 지도 기타 관련 시맨틱 정보입니다

여기에 표시되는 URL을 설정하려면 예정된 이벤트에 표시할 동작으로 해당 이벤트의 URL 객체를 채웁니다 이 경우 패스 이벤트 가이드에 표시하는 URL과는 다른 URL 세트를 제공했습니다 예정된 이벤트는 패스와 동일한 구조를 갖고 있지만 패스에 대해 정의한 속성은 재사용하지 않습니다 예정된 이벤트 가이드와 패스 이벤트 가이드에 동일한 URL을 표시하려면 예정된 이벤트 객체에 동일한 값을 포함해야 합니다

예정된 이벤트의 장소 지도는 앞의 헤더 이미지에서 표시한 것처럼 이미지를 가져올 URL을 지정하여 구성할 수 있습니다 지갑은 패스 이벤트 가이드의 장소 지도를 보통 재사용하지 않습니다 하지만 동일한 장소 지도는 "reuseExisting" 속성을 true로 설정하여 재사용할 수 있습니다 URL을 제공하지 않거나 "reuseExisting"을 true로 설정하면 지갑은 예정된 이벤트에 대한 장소 지도를 표시하지 않죠 예정된 이벤트는 티켓 소지자에게 티켓으로 참석할 수 있는 모든 이벤트를 알려 주는 정말 유용한 기능입니다 티켓에 예정된 이벤트를 추가하면 예정된 이벤트가 이벤트 티켓과 동일한 구조를 사용한다는 점에 유의해야 합니다 따라서 패스에 제공하는 각 시맨틱과 URL이 예정된 이벤트에 맞게 어떻게 변경되어야 할지 생각해보는 것이 좋습니다 지갑의 문서는 티켓과 예정된 이벤트를 어떻게 다양하게 맞춤화할 수 있는지 알아볼 수 있는 매우 유용한 자료입니다 처음 패스를 만들 때 예정된 모든 이벤트를 정의할 필요는 없습니다 시간이 지나면서 차츰 예정된 이벤트를 추가하려는 경우 새로 예정된 이벤트를 포함해 패스 업데이트를 전송합니다 예정된 이벤트의 "isActive" 속성은 지갑에게 이벤트가 적용되는 시점을 알려 주므로 이벤트 시작과 종료 시 업데이트하는 것이 중요합니다 이벤트가 취소되거나 티켓 소지자와 더 이상 관련이 없으면 pass.json에서 삭제할 것을 고려합니다

그러면 예정된 이벤트 목록에는 관련된 최신 정보만 표시됩니다 이제 올해 출시되는 업그레이드된 탑승권과 새 기능의 활용 방법을 살펴보겠습니다 지갑 탑승권은 수백만 명의 승객들이 공항 보안 검색대를 통과하고 비행기에 탑승하는 데 도움을 줍니다 올해는 탑승권이 어느 때 보다 역동적이고 구성 가능한 새 디자인으로 크게 향상되었습니다 업그레이드된 탑승권은 Apple의 항공 서비스와 통합되고 자동으로 최신 상태를 유지하므로 게이트 변경이나 지연이 있을 때마다 탑승권을 업데이트할 필요가 없습니다 또한 주요 항공편 정보를 쉽게 확인할 수 있고 승객들이 여행 중에 최신 정보를 받을 수 있는 완전히 새로운 실시간 현황이 추가되었습니다 실시간 현황은 메시지가 공유되어 가족과 친구가 자신의 기기로 항공편을 추적할 수 있습니다 모든 업그레이드된 탑승권에는 항공편 추적 기능이 포함됩니다 승객이 업그레이드된 탑승권을 추가하면 지갑이 상태 업데이트를 실시간으로 받고 비행에 변경 사항이 생기면 승객에게 즉시 알려 줍니다 이 업데이트는 탑승권과 실시간 현황 모두에 반영되어서 승객은 두 곳에서 모두 최신 항공편 정보를 확인할 수 있습니다

항공편 추적 외에도 새 탑승권에는 공항까지 길 안내를 하는 지도 앱과 수하물 추적을 위한 나의 찾기처럼 더욱 긴밀한 시스템 통합도 제공됩니다 그리고 새 항공 서비스 및 업그레이드 섹션은 승객에게 여행에 대한 더 많은 정보를 제공합니다 이 섹션을 탭하면 승객이 여행 중에 할 수 있는 모든 작업과 관련 동작에 대한 정보의 요약을 확인할 수 있습니다 이러한 새 기능의 작동 방법과 업그레이드된 탑승권을 적용할 때 이 기능의 구성 방법도 알아보겠습니다 탑승권 상단부터 시작해서 헤더에는 항공편 번호와 출발 날짜가 표시됩니다 업그레이드된 탑승권은 항상 pass.json의 시맨틱을 사용해 항공편을 식별하는 필드를 여기에 표시합니다

지갑은 airlineCode flightNumber originalDepartureDate 시맨틱을 사용해 탑승권이 추가되는 즉시 Apple의 항공편 서비스를 통해 항공편 추적을 시작합니다 코드셰어 항공편인 경우 마케팅 항공사 코드와 항공편 번호를 제공하는 것이 가장 일반적입니다 승객에게 운항 중인 항공편 번호를 표시하려는 경우 대신 그걸 포함시켜도 됩니다 두 옵션 모두 Apple의 항공 서비스에서 올바른 항공편을 찾을 수 있도록 합니다 지갑은 Apple의 항공 서비스에서 데이터를 사용해 패스에 표시되는 시간을 자동으로 업데이트합니다 패스 업데이트도 전송하는 경우 currentDeparture Date, currentArrivalDate 시맨틱을 사용합니다 공식적으로 항공편 일정이 변경되지 않으면 원래 날짜는 변경되지 않습니다 패스로 다시 돌아와서 다음 섹션에는 도시 이름 공항 코드, 출발 및 도착 게이트 시간을 표시합니다 출발 및 도착 날짜 시맨틱은 게이트 시간을 지정해야 합니다 탑승 시간이 탑승권의 별도 영역으로 표시되어 있고 originalBoardingDate currentBoardingDate 시맨틱을 기초로 하기 때문이죠 지갑이 출발 및 도착 시간을 업데이트할 때 탑승 시간도 자동으로 업데이트되어 새 출발 시간을 반영합니다 패스가 추가되거나 업데이트되면 지갑이 탑승 시간과 출발 시간 시맨틱을 비교하여 탑승 소요 시간을 계산합니다 Apple의 항공편 서비스에서 출발 시간이 변경되면 패스에 표시된 탑승 시간이 자동으로 업데이트되어 시맨틱에서 계산된 탑승 소요 시간을 유지합니다 예를 들어, 비행기가 3시간 지연되면 탑승 시간도 3시간 늦춰집니다 패스를 새 currentBoarding Date로 업데이트하면 지갑은 탑승 시간을 다시 계산하고 필요한 경우 탑승권에 시간을 업데이트합니다 이 예는 시맨틱은 항공편에 대한 컨텍스트를 제공하지만 UI에 직접 연결되지 않음을 보여 줍니다 지갑은 승객에게 최신 정보 표시를 우선으로 하고 시맨틱을 사용해 패스에 표시되는 데이터가 시간에 따라 어떻게 업데이트되어야 하는지 알려 줍니다 이제 시맨틱이 업그레이드된 탑승권 UI의 다른 부분을 어떻게 구성하고 있는지 살펴보죠 배지는 승객과 게이트 직원이 패스에서 중요한 정보를 빠르게 확인할 수 있게 해 주는 새 기능입니다 pass.json에 포함하는 일부 시맨틱은 승객 이름 아래에 표시됩니다

업그레이드된 탑승권은 최대 2줄의 배지를 지원하고 승객의 티켓 좌석 등급, 휴대 수하물 자격, 특수 지원 서비스 요청 등의 정보를 표시합니다 지갑은 pass.json의 시맨틱을 고려하고 적절한 배지 세트를 자동으로 배치합니다 그리고 항공사 간 공통 배지를 표준화하는 데 도움이 되도록 업그레이드된 탑승권은 “passengerServiceSSRs” 시맨틱을 통해 IATA 특별 서비스 요청 코드를 지원합니다

대부분의 배지에 대한 텍스트는 지갑으로 정의됩니다 그러나 항공사의 고유한 정보를 위한 레이블을 전적으로 관리할 수 있도록 몇 가지 시맨틱을 추가했습니다 예를 들어 보겠습니다 시맨틱 객체에서 “passengerServiceSSRs” 시맨틱을 사용해 서비스 동물 및 기내 휠체어 요청 코드를 추가했습니다

맞춤형 시맨틱도 몇 가지 추가해 보겠습니다 예를 들면, 티켓 좌석 등급과 승객의 항공사 회원 등급입니다

다시 탑승권을 꺼내면 시맨틱을 기반으로 새로운 배지를 볼 수 있습니다 처음 두 개의 배지는 제가 제공한 문자열을 사용하지만 특별 서비스 요청 코드는 지갑이 제공한 문자열을 표시합니다 배지는 지갑이 시맨틱을 사용하는 좋은 예입니다 내 코드에서는 각 필드마다 명시적인 배지 객체가 있습니다 대신 승객에 대한 관련 컨텍스트를 제공하여 지갑이 가장 중요한 정보의 우선순위를 정하는 배지를 만들 수 있습니다 이런 방식으로 시맨틱을 사용하면 지갑이 사용성을 저해하지 않고 탑승권에 더 많은 정보를 포함할 수 있습니다 새로운 스키마는 모든 항공사에 동일한 스키마를 노출하여 승객이 비행할 때마다 일관된 경험을 할 수 있도록 보장합니다 업그레이드된 탑승권에 제공할 수 있는 다양한 시맨틱을 알아보려면 개발자 문서를 확인하시기 바랍니다

이제 항공사 서비스를 구성하는 방법과 사용자를 다시 앱으로 불러오는 동작이 포함된 업그레이드 화면 설정 방법을 보죠 티켓 관리, 기내 Wi-Fi 구매, 좌석 업그레이드와 같은 동작을 위한 URL을 pass.json에 포함할 때 지갑은 해당 동작에 대한 추가 정보를 제공하는 시맨틱과 함께 해당 동작을 위한 버튼으로 서비스 및 업그레이드 화면을 채웁니다

URL은 pass.json에 최고 레벨 특성으로 정의됩니다 업그레이드된 탑승권은 승객이 비행 전과 도중 그리고 이후에 할 수 있는 다양한 일반적인 동작을 지원합니다

승객이 탑승권에서 확인할 수 있기를 원하는 모든 동작에 대한 URL을 포함하고 각 동작을 완료할 수 있는 화면으로 열리도록 앱을 설정합니다

그리고 지갑이 각 동작에 대한 추가 정보를 표시하므로 이 화면에서 풍부하고 완전한 경험을 제공할 수 있도록 가능한 많은 시맨틱을 채워야 합니다 다른 예를 들어 설명해보겠습니다

"purchaseLoungeAccessURL"을 제공하여 라운지 패스를 구매하기 위한 버튼을 표시할 수 있습니다 그런데 저 버튼은 좀 허전해 보이니 추가 컨텍스트가 있으면 좋겠죠 "airlineLoungePlaceID" 시맨틱을 포함하면 지갑은 라운지 위치의 지도 미리보기를 표시합니다 추가 컨텍스트를 제공해 사용자 경험을 크게 개선하여 UI가 더 완성도 있게 느껴지도록 했습니다

서비스와 업그레이드 화면이 어떻게 구성되어 있는지 간단히 살펴보았습니다 핵심은 지갑이 pass.json에서 URL과 시맨틱 정보를 사용해 UI를 빌드한다는 거죠 개발자 문서에 사용할 수 있는 모든 시맨틱과 URL에 대한 자세한 정보가 있으므로 확인해 보고 확인하고 앱에서 지원하는 모든 동작을 추가해 보세요

마무리하기 전에 업그레이드된 탑승권의 기기 호환성을 말씀드리겠습니다 보여드린 모든 새로운 기능은 최신 버전의 iOS 및 watchOS를 실행하는 기기에서 지원됩니다 업그레이드된 탑승권 스키마는 기존 탑승권 스키마에 영향을 주지 않고 새 속성을 추가하죠 승객 중에는 이전 운영 체제를 사용하는 기기를 갖고 있기도 할 것입니다 이전 운영 체제에서는 지갑이 새 속성을 사용하지 않죠 업그레이드된 탑승권을 도입하는 가장 좋은 방법은 기존 탑승권에 시맨틱과 URL을 추가하여 승객이 사용하는 운영 체제에 관계 없이 일관되고 우수한 경험을 제공하는 것입니다 지금까지 지갑에서 이벤트 티켓과 탑승권을 더욱 동적으로 만드는 방법을 설명했습니다 이제 새 PKPassLibrary API로 이 패스를 완벽하게 지갑에 추가하는 방법을 소개하겠습니다 지갑에 패스를 추가할 때 항상 사용자 상호작용이 필요했습니다 지갑에 패스를 추가하려면 앱에서 패스 미리보기를 표시하는 AddPassesViewController를 보여주고 한 번 더 탭해서 추가해야 합니다 또는 PKPassLibrary에서 addPasses API를 호출할 수 있죠 이때 지갑에 패스를 추가하기 전에 알림이 표시됩니다

이 옵션은 지갑에 패스를 자주 추가하지 않을 때 유용합니다 사용자가 패스 추가 시점을 완전히 통제할 수 있기 때문입니다 앱에서 지갑에 패스를 정기적으로 추가하는 사람이 있기도 합니다 예를 들어 자주 비행하는 사람은 일주일에 여러 탑승권을 추가하고 각 패스를 하나씩 검토하는 것이 큰 의미가 없을 수 있죠 올해 새롭게 백그라운드 패스 추가 기능이 생겼습니다 사용자가 허용하면 앱이 지갑에 패스를 자동으로 추가합니다

addPasses API를 사용하면 추가 프롬프트 없이 백그라운드에서 자동으로 패스가 추가됩니다 지갑은 단순히 앱이 패스를 추가했다는 알림만 보냅니다 새 API를 도입하는 데 몇 줄의 코드만 필요합니다 푸시 알림을 보내기 위한 권한을 요청한 적이 있으면 익숙한 과정일 겁니다 여기 AddPassToWallet 버튼을 표시하는 SwiftUI 보기가 있죠 첫 번째 단계는 백그라운드 추가 패스 기능을 요청합니다 버튼의 완료 핸들러에서 수행하여 다음 패스를 추가한 후 사용자에게 메시지를 표시합니다

비동기 호출이므로 코드를 Task에 래핑하고 PKPassLibrary에서 requestAuthorization (for: .backgroundAddPasses)을 호출합니다

내 버튼에 대한 완료가 실행되면 시스템은 사용자에게 이 기능을 앱에 허용할 것인지

묻는 메시지를 표시합니다 한 번만 표시되는 메시지죠 따라서 사용자가 이미 선택을 완료한 후 호출해도 다시 메시지가 표시되지 않습니다 이제 승인을 확인하고 패스를 자동으로 추가하기 위해 몇 가지 코드를 추가합니다

내 보기가 로드되면 승인 상태를 확인할 수 있습니다 PKPassLibrary에서 permissionStatus (for capability:)를 사용합니다 권한이 부여되면 PKPassLibrary.addPasses를 호출하여 패스를 추가합니다

이 API는 패스 배열을 허용하므로 한 번에 여러 개의 패스를 추가할 수 있습니다 그러면 끝이죠 코드 몇 줄로 앱이 패스를 자동으로 추가할 수 있습니다 새 API가 어떻게 작동하는지 다시 살펴보겠습니다 백그라운드에서 패스 추가 기능을 요청하고 새 requestAuthorization (for capability:) API를 씁니다 승인은 한 번만 요청할 수 있으므로 사용자가 승인할 것이라는 확신이 있을 때 이 API를 사용하는 것이 좋습니다

API를 두 번 이상 호출하면 현재 상태만 반환됩니다 승인을 요청하면 설정 앱에 새 항목이 표시되어 언제든지 앱에 대한 이 기능을 전환할 수 있습니다 uthorizationStatus(for capability:)를 호출하여 메시지를 표시하지 않고도 현재 승인을 확인할 수 있습니다 그리고 백그라운드를 활용하려면 패스 기능을 추가하고 지갑에 패스를 추가할 때 addPasses API를 사용합니다 지금까지 지갑의 새로운 기능을 살펴보았습니다! 올해 출시되는 새 기능으로 이벤트 티켓과 탑승권이 어느 때보다 역동적이며 iOS 앱이 지갑과 완벽하게 통합됩니다 탑승권과 이벤트 티켓에서 새 속성을 채택하여 새 기능을 활용해 보세요 문서의 세부 사항을 꼭 확인해 보세요 새로운 기능이기 때문에 고객이 사용하는 운영 체제 버전에 관계 없이 훌륭한 경험을 제공하려면 이전 운영 체제 버전에 대한 지원도 유지하는 편이 좋습니다 뛰어난 API를 보유하고 있으므로 자주 지갑을 이용하는 사용자가 패스를 편리하게 추가할 수 있죠 새로 추가된 백그라운드 패스 자동 추가 기능은 가능하실 때 꼭 사용해 보시길 바랍니다

시청해 주셔서 감사합니다 멋진 WWDC가 되길 바랍니다