App Shortcuts
An App Shortcut is an easily understood, frequently used task or piece of content from your app or game that you provide to the system for people to use in a variety of contexts.
앱 바로가기는 사람들이 다양한 맥락에서 사용할 수 있도록 시스템에 제공하는 앱이나 게임에서 쉽게 이해할 수 있고 자주 사용되는 작업 또는 콘텐츠입니다.
App Shortcuts work on iPhone, iPad, Apple Watch, HomePod, and AirPods, so people can use them almost everywhere, as soon as they install your app or game. The system presents App Shortcuts in a variety of ways to help people use them quickly and conveniently, including with Siri, in Spotlight search, Suggestions, and the Shortcuts app.
앱 바로가기는 아이폰, 아이패드, 애플워치, 홈팟, 에어팟에서 작동하므로 사람들은 앱이나 게임을 설치하자마자 거의 모든 곳에서 앱을 사용할 수 있다. 이 시스템은 사람들이 빠르고 편리하게 앱을 사용할 수 있도록 도와주는 다양한 방법으로 앱 바로가기를 제시하는데, 여기에는 스포트라이트 검색, 제안 및 바로가기 앱이 포함된다.
App Shortcuts exist within the broader context of custom shortcuts, which people define using the Shortcuts app, and actions, the set of all functions from your app or game that you make available to the system.
앱 바로가기는 사람들이 바로가기 앱을 사용하여 정의하는 사용자 지정 바로가기와 시스템에서 사용할 수 있게 해주는 앱 또는 게임의 모든 기능 집합인 actions의 넓은 맥락 내에 존재한다.
Actions are the building blocks of both App Shortcuts and custom shortcuts. For guidance on designing actions with custom shortcuts in mind, see Actions.
Developer note
The SiriKit framework supports a variety of common use cases without the need to build custom intents. Before you start building an App Shortcut with the App Intents framework, it’s a good idea to determine whether you can take advantage of the predefined system intents available in SiriKit.
Identify the subset of things your app can do that make the most sense as App Shortcuts.You can create up to 10 App Shortcuts, so prioritize the ones you think will be most helpful.
당신의 앱이 할 수 있는 가장 합리적인 것들의 하위 집합을 앱 바로가기로 식별하세요. 당신은 10개까지 앱 바로가기를 만들 수 있으므로, 당신이 가장 도움이 될 것이라고 생각하는 것들의 우선순위를 정하라.
Choose self-contained, straightforward features. Self-contained tasks can be completed via Siri or search in their entirety. They don’t require your app to be open at all. Straightforward tasks are uncomplicated ones that people can succeed at quickly. Tasks that require many steps or a lot of input are less helpful as App Shortcuts.
자체 기능을 선택하세요. 자체 기능은 Siri 또는 전체 검색을 통해 완료할 수 있습니다. 이들은 앱을 열 필요가 전혀 없습니다. 간단한 작업은 사람들이 빠르게 성공할 수 있는 복잡한 작업입니다. 많은 단계가 필요하거나 많은 입력이 필요한 작업은 앱 바로 가기만큼 도움이 되지 않습니다.
Write brief, memorable shortcut names. Because the shortcut name is what people see in the UI and what they say to run it with Siri, it’s important to clearly communicate its function and make it easy to remember. You’ll have to include your app name (or a related synonym that you define), but you can be creative with it. For example, the Voice Memos app uses the shortcut “Record Voice Memo” rather than “Start recording a Voice Memo”.
짧은, 기억에 남는 바로가기 이름을 작성하세요. 바로가기 이름은 사람들이 UI에서 보는 것과 시리와 함께 실행하기 위해 말하는 것이기 때문에, 그 기능을 명확하게 전달하고 기억하기 쉽게 만드는 것이 중요합니다. 앱 이름(또는 자신이 정의한 관련 동의어)을 포함해야 하지만, 그것을 가지고 창의적으로 만들 수 있습니다. 예를 들어, 보이스 메모 앱은 "보이스 메모 녹음 시작"이 아닌 "보이스 메모 녹음"이라는 바로가기를 사용합니다.
Consider including a dynamic parameter. You can set a parameter in your shortcut that people can change depending on what they’d like to do. For example, a meditation app could use a dynamic parameter to let someone start a specific type of meditation, by saying “Start [Morning, Daily, Sleep] Meditation.” You can supply one dynamic parameter per App Shortcut, and its value comes from a finite list that you specify. Choose predictable and familiar parameter values, since people won’t have the list in front of them for reference. For developer guidance, see App entities.
동적 매개변수를 포함하는 것을 고려해 보세요. 사람들이 무엇을 하고 싶은지에 따라 변경할 수 있는 매개변수를 바로가기에 설정할 수 있습니다. 예를 들어, 명상 앱은 동적 매개변수를 사용하여 누군가가 특정 유형의 명상을 시작할 수 있도록 "[아침, 매일, 잠] 명상 시작"이라고 말할 수 있습니다. 앱 바로가기마다 하나의 동적 매개변수를 제공할 수 있으며, 그 값은 지정한 유한 목록에서 나옵니다. 사람들은 참조를 위해 목록을 앞에 두지 않을 것이므로 예측 가능하고 친숙한 매개변수 값을 선택하세요. 개발자 지침은 앱 엔티티(App entity)를 참조하세요.
→ 앱 바로가기에는 사용자가 변경 가능한 동적 매개변수를 설정할 수 있으며, 이 값은 지정된 유한 목록에서 가져옵니다.
In the case of an ambiguous request, ask for more information. When possible, try to make a reasonable assumption and present it as an option for people to consider. If they don’t want the first option, direct them to a list of alternatives. It’s important for this list to be short (roughly five items or fewer), since Siri reads the entire list aloud in voice-only scenarios.
어떠한 요청이 있을 경우 더 많은 정보를 요청하세요. 가능한 경우 합리적 가정을 하고 사람들이 고려할 수 있는 옵션으로 제시합니다. 만약 그들이 첫 번째 옵션을 원하지 않는다면, 대안 목록으로 안내합니다. 시리는 음성 전용 시나리오에서 전체 목록을 큰 소리로 읽기 때문에, 이 목록은 짧게(약 5개 항목 이하) 하는 것이 중요합니다.
Use custom snippets and Live Activities to present information and request further action.Live Activities offer people continuous access to information, which is great for timers and countdowns that appear until an event is complete. Custom snippets are noninteractive custom views you can create with SiriKit or the App Intents framework, and are great for self-contained pieces of information (showing the weather at a person’s current location, for example). Live Activities and custom snippets are great ways to add visual elements that are unique to your app. See Live Activities.
사용자 지정 스니펫 및 라이브 활동을 사용하여 정보를 제시하고 추가 작업을 요청합니다. 라이브 활동은 사람들에게 지속적인 정보 접근을 제공하므로 이벤트가 완료될 때까지 나타나는 타이머 및 카운트다운에 적합합니다. 사용자 지정 스니펫은 SiriKit 또는 AppIntents 프레임워크를 사용하여 만들 수 있는 비대화형 사용자 지정 뷰이며, 자체적으로 정보를 contained하는 데 적합합니다(예: 개인의 현재 위치에서 날씨를 showing). 라이브 활동 및 사용자 지정 스니펫은 앱 고유의 시각적 요소를 추가하는 좋은 방법입니다. 라이브 활동 을 참조하세요.
→ 라이브 활동과 사용자 지정 스니펫을 이용하여 지속적인 정보 제공과 독특한 시각적 요소를 앱에 추가합니다.
Consider how your App Shortcuts will appear in Spotlight. Your App Shortcuts can appear in Spotlight along with suggestions and searches for your app, so for each of your shortcuts, choose an SF Symbol from the SF Symbols library that accurately reflects its intent.
당신의 앱 바로가기가 Spotlight에 어떻게 나타날지 생각해보세요. 당신의 앱 바로가기는 당신의 앱에 대한 제안과 검색과 함께 Spotlight에 나타날 수 있으므로, 당신의 각각의 바로가기에 대해 그 의도를 정확하게 반영하는 SF Symbol 라이브러리에서 SF Symbol을 선택하라.
Favor simple phrases with a single, obvious parameter. Avoid complex phrases with multiple potential variables that people could mistake for the single dynamic parameter available in your shortcut. For example, “Start [Sleep] Meditation with nature sounds” appears to have two possible parameters. If your phrase feels too complicated when you say it aloud, it’s probably too complicated for people to use consistently. If the additional information is absolutely required, you can ask for it in a subsequent step.
단일하고 명확한 파라미터를 가진 간단한 문구를 선호합니다. 사람들이 당신의 바로가기에서 사용할 수 있는 단일 동적 파라미터로 착각할 수 있는 여러 개의 잠재변수를 가진 복잡한 문구를 피하세요. 예를 들어, "자연의 소리로 명상을 시작하라"는 두 개의 가능한 파라미터를 가진 것으로 보입니다. 당신이 그것을 큰 소리로 말할 때 당신의 문구가 너무 복잡하게 느껴진다면, 그것은 아마도 사람들이 지속적으로 사용하기에는 너무 복잡할 것입니다. 만약 추가적인 정보가 반드시 필요하다면, 당신은 후속 단계에서 그것을 요청할 수 있습니다.
Include thoughtful natural language variations. People might try a similar phrase to run your shortcut if they don’t remember the exact words. Be sure to include as many of these as you can: “Start Voice Memo” and “New Voice Memo” as variations, for example. Be thorough, but use your judgement to determine the boundaries of the shortcut’s function; “Save a Voice Memo” might not be appropriate when the intent is to create one. Include natural language variations for all of the languages that your app is localized in.
사려 깊은 자연어 변형을 포함합니다. 사람들이 정확한 단어를 기억하지 못할 경우, 비슷한 문구를 사용하여 단축키를 실행하려고 할 수 있습니다. 예를 들어, "음성 메모 시작" 및 "새 음성 메모"와 같은 변형을 가능한 많이 포함하십시오. 철저해야 하지만 바로 가기 기능의 경계를 판단하여 결정하십시오. "음성 메모 저장"은 바로 가기 기능을 만들고자 하는 의도에는 적절하지 않을 수 있습니다. 앱이 현지화된 모든 언어에 대한 자연어 변형을 포함하세요.
→ 앱의 바로가기를 만들 때는 비슷한 문구를 사용할 수 있도록, 다양한 자연어 변형을 포함해야 합니다.
Omit supporting dialogue when a custom visual presentation makes it redundant. By default, the system displays the dialogue that Siri reads to people alongside any custom visual elements that you provide with a custom snippet. If the visual you provide contains the same information as the dialogue, suppress the dialogue so it won’t be shown.
사용자 정의 시각적 프레젠테이션이 대화를 중복적으로 만들 때 대화를 지원하는 것을 생략합니다. 기본적으로 시스템은 사용자 정의 스니펫과 함께 제공하는 사용자 정의 시각적 요소와 함께 Siri가 사람들에게 읽어주는 대화를 표시합니다. 제공하는 시각적 요소가 대화와 동일한 정보를 포함하는 경우 대화를 표시하지 않도록 억제하십시오.
Write snippet dialogues for all platforms, not just visual ones. Because your snippets can appear when people run App Shortcuts on audio-only platforms such as AirPods and HomePod, be sure to include all of the critical information in the snippet in the dialogue as well as any custom visual elements. Make sure your custom snippets look and sound great on all of the platforms where they’ll appear.
비주얼 플랫폼뿐만 아니라 모든 플랫폼에 대한 스니펫 대화를 작성하십시오. 사람들이 에어팟이나 홈팟과 같은 오디오 전용 플랫폼에서 앱 바로가기를 실행할 때 스니펫이 나타날 수 있기 때문에 스니펫에 포함된 모든 중요 정보와 사용자 지정 시각적 요소를 대화에 포함해야 합니다. 사용자 지정 스니펫이 표시되는 모든 플랫폼에서 잘 보이고 잘 들리는지 확인하십시오.
Arrange your shortcuts in the order that you want them to appear in Spotlight. This is the same order that they appear in the Shortcuts app. You can manually change the order with an app update, and you can also let peoples’ parameter choice reorder your shortcuts dynamically. As people use your app more and the number of their custom parameters increases, sorting shortcuts dynamically becomes more important. Consider using a heuristic such as recency or frequency to drive the order.
바로가기를 Spotlight에 표시할 순서대로 정렬합니다. 이 순서는 바로가기 앱에 표시되는 순서와 같습니다. 앱 업데이트를 통해 수동으로 순서를 변경할 수 있으며, 사람들의 파라미터 선택에 따라 바로가기의 순서를 동적으로 바꾸도록 할 수도 있습니다. 사람들이 당신의 앱을 더 많이 사용하고, 사용자 정의 파라미터의 수가 증가할수록, 바로가기를 동적으로 정렬하는 것이 더 중요해집니다. 최근 또는 빈도와 같은 휴리스틱(heristic)을 사용하여 순서를 구동하는 것을 고려해 보십시오.
Use a Siri tip view to highlight App Shortcuts in your app. Pick key places to surface these tips, where people are most likely to benefit as they’re exploring — immediately before or after completing an action that they may want to repeat, for example. Be sure to make these tips dismissible; it’s always good to respect a person’s desire to remove unwanted information from their workflow. For developer guidance, see SiriTipUIView.
Siri 팁 보기를 사용하여 앱에서 앱 바로 가기를 강조 표시합니다. 예를 들어, 사람들이 탐색할 때 혜택을 받을 가능성이 가장 높은 곳(예를 들어, 반복하고 싶을 수 있는 작업을 완료하기 직전 또는 완료한 후)을 선택하십시오. 이러한 팁은 무시할 수 있도록 해야 합니다. 워크플로우에서 원하지 않는 정보를 제거하려는 사용자의 요구를 수용하는 것이 좋습니다. 개발자 지침은 'SiriTipUIView'를 참조하십시오.
Use an open-ended request to collect information with a wide range of possible values. This is particularly useful for collecting values like numbers, place names, or times. Since people can say anything in response, make it clear what type of information you expect. To benefit from built-in dialogue and visual patterns, as well as Siri’s natural language understanding, use one of the open-ended requests provided by the App Intents framework if it fits the needs of your shortcut task.
가능한 값의 범위가 넓은 정보를 수집하려면 개방형 요청을 사용하십시오. 이것은 특히 숫자, 장소 이름 또는 시간과 같은 값을 수집할 때 유용합니다. 사람들은 무엇이든 대답할 수 있기 때문에 어떤 유형의 정보를 기대하는지 분명히 해야 합니다. 시리의 자연어 이해뿐만 아니라 기본 제공되는 대화 및 시각적 패턴으로부터 이익을 얻기 위해 앱 인텐트 프레임워크에서 제공하는 개방형 요청 중 하나를 바로 가기 작업의 필요에 맞게 사용하십시오.
Use an intent confirmation before collecting an important response. Intent confirmations are meant for particularly consequential actions, such as financial transactions, destructive actions like deleting content, or actions that feel high-risk (like sending a Calendar invitation to a big group). Be deliberate about when you use confirmations, since people appreciate being able to get through shortcuts quickly, and confirmations add an extra step.
중요한 응답을 수집하기 전에 의도를 확인하세요. 의도 확인은 금융 거래, 콘텐츠 삭제와 같은 파괴적인 행동 또는 고위험을 느끼는 행동(큰 그룹에 달력 초대장을 보내는 것과 같은 행동)과 같이 특히 결과적인 행동을 위한 것입니다. 사용자들이 shortcut을 이용해 빠르게 진행하는 것을 선호하지만, confirmation이라는 단계가 추가되기 때문에 confirmation 적용에 신중해야 합니다.
When confirming an intent, use a verb that reiterates the specific action. Specific verbs (like “order”) communicate more clearly than ambiguous ones (like “confirm”). The App Intents framework provides a list of useful default verbs and their synonyms that you can use as-is, or you can use a custom verb that specifically matches the needs of your shortcut; if you use a custom verb, be sure to provide all of its relevant synonyms so Siri understands the intent in as many situations as possible.
의도를 확인할 때는 특정 동작을 반복하는 동사를 사용한다. 특정 동사(예: "명령")는 모호한 동사(예: "확인")보다 더 명확하게 의사소통합니다. App Intents 프레임워크는 유용한 기본 동사 목록과 해당 동의어를 그대로 사용하거나, 사용자 정의 동사를 사용하여 단축키의 요구사항과 구체적으로 일치시킬 수 있습니다. 사용자 정의 동사를 사용하는 경우 시리가 가능한 많은 상황에서 의도를 이해할 수 있도록 관련 동의어를 모두 제공해야 합니다.
→ 의도를 명확하게 표현하기 위해, 특정 동작을 반복하는 동사를 사용하라.
Actions are specific tasks or functions that you want to make accessible through Siri, Spotlight, and the Shortcuts app. When you designate a function in your app as an action, people can use it in custom shortcuts they create, and the action can appear as a suggestion as people establish use patterns with your app.
액션은 Siri, Spotlight, 그리고 Shortcuts 앱을 통해 실자하행고자 특 정특 작업 또는 기능입니다. 당신이 당신의 앱에서 어떤 기능을 액션으로 지정하면, 사람들은 그것을 그들이 만든 사용자 지정 단축키에서 사용할 수 있고, 사람들이 당신의 앱으로 사용 패턴을 설정할 때 그 액션은 제안으로 나타날 수 있습니다.
Note
The most useful, concise, and self-contained actions are great candidates for App Shortcuts.
앱 바로가기의 가장 유용하고, 간결하며, 자체적으로 사용할 수 있는 작업은 훌륭한 대안입니다.
Prioritize building actions for features that people use the most. Starting with your app’s most widely used features helps people get the most out of each action. In the Calendar app, for example, people often add new events, get existing events, and edit their events, so these are great candidates for actions.
사람들이 가장 많이 사용하는 기능에 대한 작업 우선 순위를 지정합니다. 앱에서 가장 널리 사용되는 기능부터 시작하면 사람들이 각 작업을 최대한 활용할 수 있도록 도와줍니다. 예를 들어 달력 앱에서는 사람들이 새 이벤트를 추가하고 기존 이벤트를 가져오며 이벤트를 편집하는 경우가 많기 때문에 이러한 작업을 수행할 수 있는 훌륭한 후보입니다.
Split complex tasks into smaller, more concise actions when possible. This can make for a more powerful and configurable automation experience, and helps people understand exactly what each action will do.
복잡한 작업을 가능한 한 더 작고 간결한 작업으로 분할합니다. 이를 통해 보다 강력하고 구성 가능한 자동화 환경을 구현할 수 있으며, 사람들이 각 작업이 수행할 작업을 정확하게 이해할 수 있습니다.
Make your actions platform agnostic. People appreciate when actions are available on all of the devices they use. Support as many devices as you can in the context of your app. For AirPods and HomePod, this means creating a straightforward, complete experience interacting with voice alone.
당신의 행동 플랫폼에 구애받지 않도록 하세요. 사람들은 그들이 사용하는 모든 기기에서 행동을 사용할 수 있을 때를 고맙게 생각합니다. 당신의 앱 맥락에서 당신이 할 수 있는 한 많은 기기를 지원하세요.. 에어팟과 홈팟의 경우, 이것은 음성만으로 상호작용하는 간단하고 완전한 경험을 만들어 내는 것을 의미합니다.
Consider the experience that people will have when customizing your actions. People can use your actions as part of larger custom shortcuts that they create in the Shortcuts app. Be sure to present parameters that flow clearly, according to natural language, to help people understand what the action does and how it can relate to other actions in the context of a larger workflow.
사용자의 작업을 사용자 정의할 때 사용자 경험을 고려하십시오. 사용자는 단축어 앱에서 생성하는 더 큰 사용자 정의 바로 가기의 일부로 사용할 수 있습니다. 더 큰 워크플로우의 맥락에서 사용자가 작업이 수행하는 내용과 다른 작업과 어떻게 관련될 수 있는지 이해할 수 있도록 자연 언어에 따라 명확하게 흐르는 매개 변수를 제시해야 합니다.
Write an action title that matches the action’s parameter summary. An action is represented by its title, which is a brief representation that appears throughout the system, and by its parameter summary, which is a phrase that includes the action’s important parameters and appears in the editor of the Shortcuts app. Both the action’s title and its parameter summary start with the same verb, and they share as many words as possible between them. For example, Messages pairs the “Send Message” action title with the parameter summary “Send “Message”to Recipients.” For developer guidance, see Providing your app’s capabilities to system services.
작업의 매개 변수 요약과 일치하는 작업 제목을 작성하세요. 액션은 시스템 전체에 나타나는 간략한 표현인 제목과 바로 가기 앱의 편집기에 나타나는 중요한 매개 변수를 포함하는 구문인 매개 변수 요약으로 표현됩니다. 액션의 제목과 매개 변수 요약은 모두 동일한 동사로 시작하며, 둘 사이에 가능한 한 많은 단어를 공유합니다. 예를 들어, 메시지는 "메시지 보내기" 수행 제목과 매개변수 요약 "수신자에게 메시지 보내기"를 쌍으로 만듭니다. 개발자 지침은 시스템 서비스에 앱의 기능 제공을 참조하십시오.
→ 액션은 시스템 전체에 나타나는 제목과 주요 파라미터를 포함하는 요약으로 표시된다.
Parameters are elements within an action that provide additional information to the system to resolve the action. For example, an action that sends a message might include a parameter for the recipient, and one for the message string. An action can have any number of parameters, though actions you designate as App Shortcuts can have only one.
파라미터는 액션을 해결하기 위해 시스템에 추가적인 정보를 제공하는 액션 내의 요소입니다. 예를 들어, 메시지를 보내는 액션은 수신자에 대한 파라미터와 메시지 문자열에 대한 파라미터를 포함할 수 있습니다. 액션은 임의의 수의 파라미터를 가질 수 있지만, App Shortcuts로 지정한 액션은 하나만 가질 수 있습니다.
Include parameters where they would naturally occur in an action. Any place an action can make use of a variety of possible input values, or present a variety of possible results, is a great opportunity to add a parameter.
어떤 행동에서 자연스럽게 발생할 수 있는 매개변수를 포함합니다. 어떤 행동이 가능한 다양한 입력값을 활용할 수 있거나 가능한 다양한 결과를 제시할 수 있는 모든 장소는 매개변수를 추가할 수 있는 좋은 기회입니다.
Keep in mind that people can use parameters in shortcuts they configure. People interact with your actions when they provide follow-up responses to resolve them, and when they configure custom shortcuts in the Shortcuts app. Be sure that the parameter’s position in the action and its possible response values make sense in both contexts. For example, when setting up an action for archiving tasks, be sure to include similar values for the “archive” parameter when editing it in the Shortcuts app (configuration) and when running the action with Siri (resolution).
사람들은 자신이 구성한 바로 가기에서 매개 변수를 사용할 수 있다는 점을 명심하십시오. 사람들은 작업을 해결하기 위한 후속 응답을 제공할 때와 바로 가기 앱에서 사용자 지정 바로 가기를 구성할 때 상호 작용합니다. 작업에서 매개 변수의 위치와 가능한 응답 값이 두 가지 맥락에서 모두 의미가 있는지 확인하십시오. 예를 들어, 작업 보관을 위해 작업을 설정할 때 바로 가기 앱(configuration)에서 작업을 편집할 때와 Siri(resolution)로 작업을 실행할 때 "보관" 매개 변수에 대해 유사한 값을 포함해야 합니다.
Define custom parameter entities as necessary. The system provides useful built-in parameters that you can query as part of an action, but if you need to describe a parameter that isn’t included by default, you can configure a custom one. Use dynamic enumerations to define custom UIs for custom parameters in your actions. For developer guidance, see DynamicOptionsProvider.
필요에 따라 custom parameter entity를 정의합니다. 시스템은 작업의 일부로 쿼리할 수 있는 유용한 기본 제공 매개 변수를 제공하지만 기본적으로 포함되지 않은 매개 변수를 설명해야 하는 경우 사용자 지정 매개 변수를 구성할 수 있습니다. 동적 열거를 사용하여 작업의 사용자 지정 매개 변수에 대한 사용자 지정 UI를 정의합니다. 개발자 지침은 'DynamicOptionsProvider )을 참조하세요.
Consider providing a default value for each required parameter of your action. If you have a strong opinion about a good starting place for a certain parameter, consider providing it as a default so people don’t have to go through multiple steps when using your action. Whether you provide a default or not, make sure that the action prompts people to provide their own value for the parameter — either through a question, or from a list — since people can always configure a parameter to “Ask Each Time” using the Shortcuts app.
작업에 필요한 각 매개변수에 대해 기본값을 제공하는 것을 고려하세요. 특정 매개변수에 대한 좋은 시작 위치에 대해 강력한 의견이 있는 경우 작업을 사용할 때 사람들이 여러 단계를 거칠 필요가 없도록 기본값으로 제공하는 것을 고려하세요. 기본값을 제공하든 제공하지 않든 사람들은 항상 단축키 앱을 사용하여 매개변수를 "매번 묻습니다"로 구성할 수 있으므로 작업에서 사람들이 질문을 통해 또는 목록을 통해 매개변수에 대한 자신의 값을 제공하도록 지시하는지 확인하세요.
→ 작업을 수행할 때 사용자가 여러 단계를 거치지 않도록, 필요한 매개변수에 대해 기본값을 제공하는 것을 고려하세요.
Place all of your optional parameters in the Options UI. This way people can disclose them when they need to see them, and you don’t need to include them as part of the action summary.
옵션 UI에 모든 옵션 매개변수를 배치합니다. 이렇게 하면 사람들이 볼 필요가 있을 때 공개할 수 있으며, 작업 요약의 일부로 포함할 필요가 없습니다.
No additional considerations for iOS, iPadOS, visionOS, or watchOS. Not supported in tvOS.
iOS, iPadOS, visionOS, watchOS 추가 고려 사항 없음.tvOS에서는 지원되지 않음.
App Shortcuts aren’t supported in macOS. However, actions you create for your app using App Intents and SiriKit are supported, and people can build shortcuts using them with the Shortcuts app on Mac.
앱 바로가기는 macOS에서는 지원되지 않지만 앱인텐트와 SiriKit을 사용하여 앱을 위해 만든 작업은 지원되며 사람들은 맥에서 바로가기 앱을 사용하여 바로가기를 만들 수 있습니다.
Providing your app’s capabilities to system services — App Intents
Integrating custom data types into your intents — App Intents
Change log
작성 날짜 | 작성자 | 수정사항 |
2023/11/30 | 조엘 | 초기 번역 |
2023/12/26 | 조엘 | 배포 |