휴대폰에서 차량으로
섹션, 행, 부제목 및 앱에서 정의한 페이로드를 포함한 루트 템플릿을 푸시합니다.
@capgo/capacitor-auto iOS 및 Android에서 승인된 템플릿 기반의 차량용 인터페이스가 필요한 앱을 위한 가벼운 브릿지를 제공합니다.
WebView를 차량 화면에 그대로 미러링하는 방식이 아닙니다. 휴대폰 앱이 제한된 차량용 템플릿을 전송하면, 차량 호스트가 CarPlay 또는 Android Auto UI로 이를 렌더링하며, 행(row) 선택 시 Capacitor 앱으로 이벤트가 전달됩니다.
차량에서 휴대폰으로
이벤트 리스닝: carAction 운전자가 차량 디스플레이에서 동작을 선택할 때 발생하는 이벤트입니다.
연결 상태
CarPlay 또는 Android Auto 호스트의 연결 및 연결 해제 시 반응합니다.
네이티브 엔트리 포인트
CarPlay scene delegate 및 Android Auto를 지원하여 CarAppService 차량 호스트가 통합 기능을 실행할 수 있도록 합니다.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 부분 | 시작하기 보기 |
핵심 API
“Core API” 섹션isAvailable()플랫폼 지원 여부와 현재 연결 상태를 반환합니다.setRootTemplate(options)간단한 리스트 템플릿으로 차량 디스플레이를 업데이트합니다.sendMessage(options)앱에서 정의한 메시지를 네이티브 브리지를 통해 전송합니다.connectionChanged차량 호스트가 연결되거나 연결 해제될 때 보고합니다.carAction차량 화면의 행이 선택되면 발생합니다.messageReceived앱에서 정의한 브리지 메시지를 전달합니다.
플랫폼 모델
“플랫폼 모델” 섹션iOS는 CarPlay를 사용하며 CPTemplateApplicationSceneDelegate 화면을 렌더링합니다. CPListTemplate.
Android는 AndroidX Car App Library를 사용하고, 서비스를 등록하며 CarAppService템플릿 기반 Android Auto 화면을 렌더링합니다.
두 플랫폼 모두 Apple 및 Google의 차량 앱 정책을 준수해야 합니다. 사용 사례에 맞는 올바른 앱 카테고리, entitlement, 심사 승인 및 플랫폼 설정이 필요합니다.
신뢰할 수 있는 소스
“Source of truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-auto.
@capgo/capacitor-auto에서 계속하기
“@capgo/capacitor-auto에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-auto 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-auto 사용하기 @capgo/capacitor-auto 사용의 네이티브 기능에 대해서는, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.
