메인 콘텐츠로 건너뛰기
@capgo/capacitor-자동 장치 API 오픈 소스

자동 Capacitor 플러그인

Capacitor 앱을 CarPlay와 Android Auto 템플릿 표면을 통해 양방향 차량 통신을 위한 브리지로 연결합니다.

설치

bun add @capgo/capacitor-auto bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

가이드

Capacitor의 Capacitor 사용 방법

장치에서 테스트

Capgo 앱을 다운로드한 후 QR code를 스캔하세요.

자동 플러그인 미리보기 QR 코드 code

@capgo/capacitor-auto를 사용하여

@capgo/capacitor-auto Capacitor 앱을 승인된 CarPlay 및 Android Auto 템플릿 표면과 연결합니다. 앱은 작은 템플릿 목록을 차량 디스플레이로 보내고, 차량 디스플레이는 선택된 액션을 JavaScript로 다시 보내줍니다.

__CAPGO_KEEP_0__은 운전자의 안전한 정책 제어 워크플로우를 위해 설계되었습니다. WebView를 차량 디스플레이에 반영하지 않습니다.

설치 및 동기화

npm install @capgo/capacitor-auto
npx cap sync

차량에 템플릿을 보내세요

import { Auto } from '@capgo/capacitor-auto';

await Auto.setRootTemplate({
  title: 'Garage',
  sections: [
    {
      header: 'Doors',
      items: [
        {
          id: 'open-main-door',
          title: 'Open main door',
          subtitle: 'Tap to send the action to the phone app',
          payload: { doorId: 'main' },
        },
      ],
    },
  ],
});

운전자의 액션을 듣세요

await Auto.addListener('carAction', async (event) => {
  if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
  }
});

연결 상태를 감시하세요

const status = await Auto.isAvailable();
console.log(status.available, status.connected, status.platform);

await Auto.addListener('connectionChanged', (event) => {
  console.log('Car connected:', event.connected, event.platform);
});

iOS 요구 사항

CarPlay는 애플이 승인한 앱 카테고리에 대한 자격을 필요로 합니다. CarPlay 장면 구성에 대한 설명을 iOS 설정 문서에 추가하고, 앱 UI를 애플이 승인한 템플릿 안에 유지하세요. iOS 설정 문서 자동차 UI를 애플이 승인한 템플릿 안에 유지하세요.

Android 요구 사항

Android Auto는 AndroidX Car App Library를 사용합니다. 플러그인은 CarAppServicedeclare를 template 능력을 선언하고, 기본적으로 IOT 카테고리를 사용합니다. 앱이 다른 Android Auto 카테고리가 필요하다면 Android 설정 문서를 리뷰하세요. 설계 지침

자동차 표면에서 짧고 예측 가능한 액션을 사용하세요:

Android 설정 문서

  • 상태 행
  • 한 번에 명령
  • 드라이버 안전한 확인
  • 휴대폰 앱에서 단순한 상태 전달

휴대폰 UI에서 복잡한 흐름을 유지하고 carAction 이벤트를 네이티브 인텐트 트리거로 사용하십시오.

Using @capgo/capacitor-auto

이 기능을 사용하고 계신가요? Using @capgo/capacitor-auto 네이티브 미디어 및 인터페이스 동작을 계획하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-auto @capgo/capacitor-auto와 연결하십시오. @capgo/capacitor-auto의 구현 세부 사항을 @capgo/capacitor-auto에서 확인하십시오. Getting Started Getting Started Using @capgo/capacitor-live-activities Using @capgo/capacitor-live-activities @capgo/capacitor-라이브-활동 Using @capgo/capacitor-live-activities Using @capgo/capacitor-video-player Using @capgo/capacitor-video-player

FAQ

자동 플러그인 FAQ

자동 플러그인을 Capacitor 앱에 설치하는 방법은 무엇입니까?

Run "bun add @capgo/capacitor-auto" (또는 "npm install @capgo/capacitor-auto")를 실행한 후 "bunx cap sync"를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 앱 code에서 "@capgo/capacitor-auto"를 임포트하세요.

React, Vue 및 Angular과 함께 @capgo/capacitor-auto가 작동합니까?

Yes. Auto is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

어떤 Capacitor 버전을 @capgo/capacitor-auto가 지원하는지 궁금하십니까?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

어떤 @capgo/capacitor-auto가 무료이며 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-auto/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code를 업데이트할 수 있나요?

code를 업데이트하면 Native code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo Live Update를 통해 즉시 배포할 수 있습니다.

자동 업데이트를 기다리지 않고 Ship Auto

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트 사용자에게 JavaScript, HTML 및 CSS 변경 사항을 몇 분 안에 푸시합니다.

시작하기 Capgo