개요
“개요” 섹션@capgo/capacitor-app-intents Apple App Intents를 Capacitor JavaScript 레이어에 연결합니다: 콜드 스타트 시 대기 중인 큐를 비우고, Shortcuts 파라미터용 엔티티 카탈로그를 게시하고, Spotlight 콘텐츠를 인덱싱하고, 홈 화면 퀵 액션을 설정하고, appIntentInvoked 이벤트를 수신합니다. Siri 단축어 구문은 런타임 문자열이 아니라 생성된 Swift의 컴파일 타임 리터럴입니다.
이 플러그인을 Siri, 단축어 및 위젯 Widget Kit, Live Activities, Share Target 또는 Intent Launcher도 사용할 때 함께 사용하세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | iOS 16 이상 |
| Android | 아니요 | 메서드가 명확한 에러와 함께 거부됨 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션getPendingInvocations- JavaScript가 준비되기 전에 큐에 쌓인 호출을 반환합니다.removePendingInvocation- 핸들러가 처리를 완료한 후 대기 중인 호출 하나를 제거합니다.setEntityCatalog- 주어진 타입 문자열에 대한 엔티티 카탈로그를 저장합니다.setHomeScreenShortcutItems- 홈 화면의 퀵 액션(UIApplicationShortcutItems)을 교체합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
getPendingInvocations | JavaScript가 준비되기 전에 대기열에 쌓인 호출을 반환합니다. |
removePendingInvocation | 핸들러에서 처리를 완료한 후 대기 중인 호출 하나를 제거합니다. |
setEntityCatalog | 지정된 타입 문자열에 대한 엔티티 카탈로그를 영구 저장합니다. |
setHomeScreenShortcutItems | 홈 화면 퀵 액션(UIApplicationShortcutItems)을 교체합니다. |
indexSpotlightEntities | 앱 도메인의 Spotlight 항목을 인덱싱합니다. |
removeSpotlightEntities | Spotlight 항목을 ID로 삭제합니다. |
performAppleSchemaTemplate | 알파 Apple 스키마 템플릿용 JavaScript 핸들러를 큐에 추가합니다. |
addListener | 이벤트 리스닝: appIntentInvoked 새로운 호출이 대기열에 추가될 때. |
removeAllListeners | 이 플러그인의 모든 리스너를 제거합니다. |
getPluginVersion | 네이티브 플러그인 버전 문자열. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-app-intents.
