개요
“개요” 섹션@capgo/capacitor-live-activities 관리합니다 ActivityKit JSON 레이아웃 DSL을 사용하여 Capacitor의 Live Activities를 관리합니다 (잠금 화면, Dynamic Island, 타이머, 공유 App Group 내 이미지 포함). 이 플러그인은 Apple의 App Intents를, Siri 구문, Shortcuts 앱, Spotlight 인덱싱 또는 대기 중인 App Intent 큐를 구현하지는 않습니다.
위젯 홈 화면, SVG 템플릿 또는 LiveActivityIntent 템플릿 이벤트 로그와 연결된 버튼의 경우, @capgo/capacitor-widget-kit 대신 사용하거나 이 플러그인과 함께 사용하세요. JavaScript에서 Siri 구문, Spotlight 및 대기 중인 App Intent 큐를 사용하려면 @capgo/capacitor-app-intents.
자세한 내용은 Siri, 단축어 및 위젯 Capgo 플러그인이 시스템 통합 기능에 어떻게 매핑되는지 확인하세요.
다음으로 시작하세요 areActivitiesSupported() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
데모
“데모” 섹션
핵심 기능
“핵심 기능” 섹션areActivitiesSupported- 이 기기에서 Live Activities를 지원하는지 확인합니다. iOS 16.1 이상 및 기기 지원이 필요합니다.startActivity- 지정된 레이아웃과 데이터로 새로운 Live Activity를 시작합니다.updateActivity- 기존 Live Activity를 새로운 데이터로 업데이트합니다.endActivity- Live Activity를 종료합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
areActivitiesSupported | 이 기기에서 Live Activities를 지원하는지 확인합니다. iOS 16.1 이상 및 기기 지원이 필요합니다. |
startActivity | 지정된 레이아웃과 데이터로 새로운 Live Activity를 시작합니다. |
updateActivity | 기존 Live Activity를 새로운 데이터로 업데이트합니다. |
endActivity | Live Activity를 종료합니다. |
getAllActivities | 현재 활성화된 모든 Live Activity를 가져옵니다. |
saveImage | Live Activity에서 사용할 이미지를 공유 App Group 컨테이너에 저장합니다. 위젯 확장 프로그램에서 접근하려면 이미지를 반드시 공유 컨테이너에 저장해야 합니다. |
removeImage | 저장된 이미지를 공유 컨테이너에서 삭제합니다. |
listImages | 공유 컨테이너에 저장된 모든 이미지를 나열합니다. |
cleanupImages | 공유 컨테이너에 저장된 모든 이미지를 삭제합니다. |
getPluginVersion | 네이티브 Capacitor 플러그인 버전을 가져옵니다. |
startTimerSequence | 운동/스포츠용 타이머 시퀀스를 시작합니다. iOS: Live Activity 및 Dynamic Island에 표시됩니다. Android: 타이머가 포함된 포그라운드 알림으로 표시됩니다. |
pauseTimerSequence | 타이머 시퀀스를 일시 중지합니다. |
resumeTimerSequence | 일시 중지된 타이머 시퀀스를 재개합니다. |
stopTimerSequence | 타이머 시퀀스를 중지하고 해제합니다. |
skipTimerStep | 시퀀스의 다음 단계로 건너뜁니다. |
previousTimerStep | 시퀀스의 이전 단계로 돌아갑니다. |
getTimerState | 타이머 시퀀스의 현재 상태를 가져옵니다. |
addListener | 타이머 시퀀스 이벤트 리스너를 추가합니다. 이벤트 종류: stepChange, complete, tick, paused, resumed, stopped, loopComplete. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-live-activities.
@capgo/capacitor-live-activities에서 계속하기
“@capgo/capacitor-live-activities에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-live-activities 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player 사용 시 네이티브 기능은, @capgo/capacitor-video-player @capgo/capacitor-video-player 구현 상세 정보는, @capgo/capacitor-native-navigation 사용하기 @capgo/capacitor-native-navigation 사용 시 네이티브 기능은, 그리고 @capgo/capacitor-native-navigation @capgo/capacitor-native-navigation. 구현 상세 정보는
