brunch

You can make anything
by writing

C.S.Lewis

by Lawn Apr 16. 2024

[HIG] App Shortcuts

자주 사용하는 작업 및 콘텐츠를 제공하는 앱 숏컷

ㅁ본 문서는 Apple의 Human Interface Guideline(이하 HIG) 문서를 한글로 번역한 것입니다. iOS 생태계 내에서 HIG를 읽으시는 분들이 번역본이 없어 불편함을 겪는 것을 알게 되었고, 이에 한글로 번역을 하게 되었습니다. iOS 커뮤니티 Async Swift에서 자율적으로 모인 9명이 함께 번역했으며, 일체의 상업적인 목적을 띄지 않습니다. 이 문서를 학습에 적극적으로 이용해 주시돼, 상업적인 용도로 이용하시는 것은 지양해 주시기 바랍니다. 감사합니다.

Introduction

앱 바로가기(app shorcut)는 사람들이 다양한 상황에서 사용할 수 있도록 앱이나 게임에서 자주 사용하는 작업이나 콘텐츠를 제공하는 것입니다.

앱 바로가기는 iPhone, iPad, Apple Watch, HomePod 및 AirPod에서 작동하므로 앱이나 게임을 설치하자마자 대부분의 플랫폼에서 사용할 수 있습니다. Siri, Spotlight 검색, 추천, 바로 가기 앱 등 다양한 방법으로 사람들이 빠르고 편리하게 사용할 수 있도록 기능을 제공합니다.

역자설명 : 하단의 예시는 우리가 iOS에서 사용하는 다양한 앱 바로가기(app shorcut)와 집합으로 구성된 스포트라이트(spotlight)의 예시입니다.

출처 : Apple Developer

앱 바로가기는 사람들이 사용자 지정 바로가기(custom shorcut)와 시스템에서 빠르게 사용할 수 있도록 설정한 앱 또는 게임으로 구성되어 있습니다.

액션(action)은 앱 바로가기와 사용자 지정 바로가기(custom shorcut)의 기본 구성 요소입니다. 사용자 지정 바로가기를 염두에 두고 액션을 디자인하는 방법에 대한 가이드라인은 액션(Actions)을 참고하세요.

개발자 가이드라인은 앱 인텐트(App Intents)를 참고하세요. Siri 관련 가이드라인은 Siri를 참고하세요.

Developer note : SiriKit 프레임워크는 사용자 지정 인텐트를 빌드할 필요 없이 다양한 일반적인 사용 사례(common use cases)를 지원합니다. 앱 인텐트 프레임워크로 앱 바로가기를 구축하기 전에 SiriKit에서 사용 가능한 사전 정의된 시스템 인텐트를 활용할 수 있는지 확인하는 것이 좋습니다.

Best practices

앱 바로가기(app shorcut)로 기능을 제공하기 가장 적합한 앱이 무엇인지 우선순위를 정하는 것이 좋습니다. 앱 바로가기는 최대 10개까지 만들 수 있으므로 사용자들이 사용하기에 가장 유용한 앱 위주로 우선순위를 정하는 것이 좋습니다.

앱 바로가기(app shorcut)로 제공하는 기능은 독립적이고 간단한 작업이 좋습니다. 독립된 작업은 앱을 실행하지 않고도 Siri 또는 전체 검색을 사용해 빠르게 사용할 있습니다. 많은 단계가 필요하거나 많은 입력이 필요한 작업은 앱 바로가기로 기능을 제공하는 것은 좋지 않습니다.

사람들이 기억하기 쉬운 앱 바로가기(app shorcut) 제목을 제공하세요. 사람들은 Siri를 사용할 때 구두로 제목을 말합니다. 따라서 명확한 기능에 따른 기억하기 쉬운 제목을 만드는 것이 중요합니다. 앱 이름(또는 사용자가 정의한 관련 동의어)을 포함해야 하지만 창의적으로 이름을 지을 수 있습니다. 예를 들어, 음성 메모 앱은 '음성 메모 녹음 시작'이 아닌 '음성 메모 녹음'이라는 바로가기를 사용합니다.

동적 매개변수(dynamic parameter)를 포함하는 것도 고려해 보세요. 바로가기에 사람들이 원하는 작업에 따라 변경할 수 있는 매개변수(parameter)를 설정할 수 있습니다. 예를 들어, 명상 앱에서는 동적 매개변수를 사용하여 "[아침, 매일, 수면] 명상 시작"이라고 말함으로써 특정 유형의 명상을 시작하도록 할 수 있습니다. 앱 바로 가기당 하나의 동적 매개변수를 제공할 수 있으며, 그 값은 사용자가 지정한 목록에서 가져옵니다. 사람들에게 익숙한 매개변수 값을 선택하는 것이 좋습니다. 개발자 가이드라인은 App entities를 참고하세요.

명확하지 않은 사용자 요청의 경우 자세한 정보를 추가적으로 제공하세요. 가능하면 합리적인 이유를 바탕으로 사람들이 고려할 수 있는 선택지를 제시하세요. 첫 번째 선택지를 원하지 않는 경우에는 대안을 제공하는 것이 좋습니다. Siri는 음성 시나리오에서 전체 목록을 소리로 읽어주기 때문에 짧게(대략 5개 항목 이하) 작성하는 것이 중요합니다.

사용자 지정 *스니펫(custom snippets)과 라이브 액티비티(live activitie) 기능을 통해 정보를 제시하고 추가적인 조치를 취하세요. 라이브 액티비티 기능을 사용하면 사람들이 지속적으로 정보를 확인할 수 있습니다. 따라서 이벤트가 완료될 때까지 표시되는 타이머 및 카운트다운에 사용하기 좋습니다. 사용자 지정 스니펫은 SiriKit 또는 앱 인텐트 프레임워크로 만들 수 있는 비대화형 사용자 지정 보기(custom view)로, 독립된 정보(예: 사용자의 현재 위치에서 날씨 표시)에 적합합니다. 라이브 액티비티 및 사용자 지정 스니펫은 앱에 고유한 시각적 요소를 추가할 수 있는 좋은 방법입니다. 라이브 액티비티(Live Activities)를 참고하세요.

역자설명 : *스니펫(snippet)은 쉽게 말해 자동완성 기능이라고 생각해 주시면 됩니다.

역자설명 : 라이브 액티비티의 예시들입니다.

출처 : Apple Developer

앱 바로가기(app shorcut)가 스포트라이트(spotlight)에 표시되는 방식을 고려하세요. 앱 바로가기는 앱에 대한 추천 및 검색과 함께 Spotlight에 표시될 수 있으므로 각 바로가기에 대해 SF 심벌 라이브러리에서 해당 의도를 정확하게 반영하는 SF 심벌을 선택하세요.

Language

단순한 구문과 하나의 명확한 매개 변수(parameter)를 사용하세요. 사람들이 하나의 기능을 실행시키는 매개 변수로 착각할 수 있는 여러 잠재적 변수가 포함된 복잡한 구문은 피하십시오. 예를 들어, “자연 소리와 함께 [수면] 명상 시작하기”는 두 개의 실행 가능한 매개 변수가 있는 것처럼 보일 수 있습니다. 말할 때 너무 복잡하게 느껴진다면 사람들이 일관되게 사용하기에도 복잡함을 느낄 수 있습니다. 추가 정보가 필요한 경우, 다음 단계에서 요청할 수 있습니다.

자연스러운 언어 변형(variation)들을 포함하는 것이 좋습니다. 사람들은 정확한 단어를 기억하지 못하는 경우 비슷한 문구로 바로가기를 실행할 수 있습니다. 가능한 한 많이 포함시켜서 제공하는 것이 좋습니다.(예를 들어 "음성 메모 시작"과 "새 음성 메모"를 포함) 음성 메모를 만드는 것이 목적이라면 "음성 메모 저장"은 적절하지 않을 수 있으므로 신중하게 판단하여 포함시키는 것이 좋습니다. 앱이 현지화(localized)된 모든 언어에 대한 자연어 변형을 포함하세요.

사용자에게 보이는 정보가 중복되는 경우 대화를 생략하는 것이 좋습니다. 기본적으로 시스템은 사용자 지정 스니펫(custom snippet)으로 시각적 요소와 함께 Siri가 사람들에게 읽어주는 대화를 보여줍니다. 제공하는 시각적 요소에 대화와 동일한 정보가 포함되어 있으면 대화가 표시되지 않도록 생략하는 것이 좋습니다.

모든 플랫폼에 대해 적절한 스니펫(snippet)을 제공하세요. 시각적인 것뿐만 아니라. 스니펫은 AirPods 및 HomePod과 같은 오디오 전용 플랫폼에서도 사람들이 앱 바로가기를 실행할 때 표시될 수 있습니다. 대화와 시각적 요소에 중요한 정보를 포함해서 보여주세요. 사용자 정의된 스니펫(custom snippet)이 나타나는 모든 플랫폼에서 적절하게 보이고 들리도록 하는 것이 좋습니다.

Presentation

바로가기를 스포트라이트(spotlight)에 표시할 순서대로 정렬합니다. 이 순서는 바로 가기 앱에 표시되는 순서와 동일합니다. 앱 업데이트를 통해 순서를 수동으로 변경할 수 있으며, 사람들의 선택에 따라 바로가기의 순서가 변경되도록 할 수도 있습니다. 사람들이 앱을 더 많이 사용하고 사용자 지정 매개변수(custom parameter)의 수가 증가함에 따라 바로가기를 순서대로 정렬하는 것이 더욱 중요해집니다. 최근 또는 사용 빈도와 같은 휴리스틱을 사용하여 순서를 지정하는 것이 좋습니다.

Siri 팁 보기를 사용하여 앱 바로가기를 강조해서 보여주세요. 사용자들이 반복하고 싶은 작업을 완료하기 직전이나 직후 등 가장 적합한 위치에 팁을 보여주는 것이 좋습니다. 하지만 정보를 원치 않는 사용자 의사를 항상 존중하는 것이 좋습니다. 개발자 가이드라인은 SiriTipUIView를 참고하세요.

Information collection

개방형 요청(open-ended request)을 사용하면 다양한 값을 가진 정보를 수집할 수 있습니다. 숫자, 장소 이름 또는 시간과 같은 값을 수집할 때 사용하는 것이 좋습니다. 사람들은 다양한 정보를 말할 수 있으므로 어떤 유형의 정보를 수집하는지 명확히 보여주세요. 기본적으로 제공되는 대화 및 시각적 패턴과 Siri의 자연어 이해 기능을 활용하려면 앱 인텐트 프레임워크(App Intents framework)에서 제공하는 개방형 요청(open-ended request)을 사용하세요.

중요한 응답을 수집하기 전에 사용자의 의도(intent)를 확인하는 것이 좋습니다. 사용자의 의도를 확인하는 것은 금융 거래, 콘텐츠 삭제와 같은 파괴적인 작업, 대규모 그룹에 캘린더 초대를 보내는 것과 같이 위험성이 높은 작업 등에서 정말 중요합니다. 하지만 사람들은 바로 가기를 빠르게 사용하기를 원하기 때문에 사용자의 의도를 확인하는 과정은 신중하게 제공하는 것이 좋습니다.

사용자의 의도(intent)를 확인할 때는 특정 동작을 반복하는 동사를 사용하세요. '주문'과 같은 구체적인 동사는 '확인'과 같은 동사보다 더 명확하게 전달됩니다. 앱 인텐드 프레임워크(App Intents framework)는 유용한 기본 동사와 그 동의어 목록을 제공하며, 이를 그대로 사용하거나 바로 가기의 요구 사항에 맞는 사용자 지정 동사를 사용할 수 있습니다. 사용자 지정 동사를 사용하는 경우 Siri가 가능한 한 많은 상황에서 의도를 이해할 수 있도록 관련 동의어를 모두 제공해야 합니다.

Actions

액션(action)은 Siri, Spotlight 및 바로 가기 앱을 통해 액세스 할 수 있는 특정 작업 또는 기능입니다. 앱에서 원하는 기능을 액션으로 지정하면 사람들이 만든 사용자 지정 바로 가기(custom shorcut)에서 해당 기능을 사용할 수 있으며, 사람들이 앱 사용 패턴을 설정할 때 몇몇 액션이 제안으로 표시될 수 있습니다.

NOTE : 유용하고 간결하며 독립적인 동작은 앱 바로가기에 적합합니다.

역자설명 : 하단의 예시는 시리를 사용했을 때 상단에 상단 스포트라이트 하단에 보이는 액션에 대한 제안을 보여줍니다.

출처 : Apple Developer

사람들이 가장 많이 사용하는 기능에 대한 액션(action)을 우선적으로 제공하세요. 앱에서 가장 널리 사용되는 기능부터 제공하면 사람들이 액션을 최대한 활용할 수 있습니다. 예를 들어 캘린더 앱에서는 사람들이 새 이벤트를 추가하고, 기존 이벤트를 가져오고, 이벤트를 편집하는 경우가 많으므로 이러한 기능을 액션으로 제공할 수 있습니다.

복잡한 작업은 가능하면 더 작고 간결한 작업으로 나누세요. 이렇게 하면 더욱 좋은 자동화 환경을 만들 수 있으며, 사람들이 각 작업이 무엇을 할 것인지 정확히 이해할 수 있습니다.

플랫폼에 구애받지 않는 액션(action)을 만드세요. 사람들은 자신이 사용하는 모든 플랫폼에서 동일한 작업을 사용하고 싶어 합니다. 앱의 컨텍스트에서 가능한 한 많은 플랫폼을 지원하세요. AirPod와 HomePod의 경우, 음성만으로 간단하고 편리하게 상호작용할 수 있는 액션(action)을 만드는 것을 말합니다.

액션(action)을 사용자 지정(custom)할 때 사람들이 겪게 될 경험과 작업순서를 고려하세요. 사람들은 바로가기 앱(app shorcut)에서 만든 사용자 지정 바로가기의 일부로 액션을 사용할 수 있습니다. 사람들이 작업 순서에 따라 액션이 무엇을 하고 다른 액션과 어떻게 구분되는지 쉽게 알 수 있도록 명확한 매개변수를 제시해야 합니다.

작업의 중요한 매개변수와 적합한 작업 제목을 작성하는 것이 좋습니다. 중요한 매개변수를 포함해서 작성하는 것이 좋습니다. 바로 가기 앱의 편집기에 표시되는 문구인 매개변수 요약들이 있습니다. 작업의 제목과 매개변수 요약은 모두 같은 동사로 시작하며, 그 사이에 가능한 한 많은 단어를 공유합니다. 예를 들어, 메시지는 "메시지 보내기"와 매개변수 ""메시지"를 수신자에게 보내기"와 짝을 이룹니다. 개발자 가이드라인은 시스템 서비스에 앱의 기능 제공하기(Providing your app’s capabilities to system services)를 참고하세요.

Parameters

매개변수는 액션(action)을 사용하기 위해 시스템에 추가 정보를 제공하는 요소들입니다. 예를 들어 메시지를 보내는 작업에는 받는 사람에 대한 매개변수와 메시지 문자열에 대한 매개변수가 포함될 수 있습니다. 액션에는 여러 개의 매개변수가 포함될 수 있지만 앱 바로가기(app shorcut)로 지정하는 액션에는 하나만 포함될 수 있습니다.

개발자 가이드는 Parameter resolution을 참조하세요.

역자설명 : 하단의 예시는 단축어 앱의 파라미터 요약을 보여줍니다.

출처 : Apple Developer

액션(action)에 적절한 위치에 파라미터를 포함하세요. 액션이 다양한 입력 값을 사용하거나 다양한 결과를 사용자에게 보여줄 수 있는 위치는 파라미터를 추가하기 좋습니다.

사람들은 매개변수를 사용해 바로가기를 직접 구성할 수 있다는 사실을 고려하세요. 사람들은 바로 가기 앱에서 사용자 지정 바로 가기(custom shorcut)를 구성할 때 여러분의 작업과 상호작용합니다. 작업에서 매개변수의 사용과 가능한 응답이 두 가지 상황에 모두에서 적합한지 고려하세요. 예를 들어, 작업을 저장하기 위한 설정을 바로 가기 앱에서 편집할 때와 Siri로 작업을 실행할 때 "저장" 매개변수에 대해 유사한 값을 포함시켜야 합니다.

필요에 따라 사용자 지정 매개변수를 정의하세요. 시스템에서는 유용한 기본 매개변수를 제공하지만, 기본적으로 포함되지 않은 매개변수를 설명해야 하는 경우에는 사용자 지정 매개변수를 구성할 수 있습니다. 동적 열거형(dynamic enumerations)을 사용하여 액션의 사용자 지정 매개변수에 대한 사용자 지정 UI를 정의할 수 있습니다. 개발자 가이드라인은 DynamicOptionsProvider를 참고하세요.

작업의 필수적인 매개변수의 기본값을 제공하는 것을 고려하세요. 특정 매개변수를 사용하기 좋은 시작 위치가 있다면, 사용자들이 여러 단계를 거치지 않게 기본값으로 제공하는 것을 고려하는 것이 좋습니다. 기본값을 제공하든 제공하지 않든, 사람들이 항상 바로 가기 앱(app shorcut)을 사용하여 "매번 물어보기"로 매개변수를 구성할 수 있으므로 작업에서 질문을 통해 또는 목록에서 매개변수에 대한 자신의 값을 입력하라는 메시지가 표시되도록 해야 합니다.

모든 선택적 매개변수를 옵션 UI에 배치하세요. 이렇게 하면 사람들이 필요할 때 볼 수 있으며, 작업 요약의 일부로 포함할 필요가 없습니다.