본문 바로가기

음성 인식 Capacitor 플러그인

스트리밍 방식의 부분 결과 제공 및 플랫폼 간 일관성을 갖춘 자연스럽고 지연 시간 낮은 음성 인식

설치

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

가이드

Capacitor에서 Speech Recognition 사용 방법

기기에서 테스트하기

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

Speech Recognition 플러그인 미리보기 QR code

@capgo/capacitor-speech-recognition 사용하기

실시간 부분 결과(partial results)를 지원하는 Capacitor 플러그인으로 강력한 온디바이스 음성 인식을 구현하세요.

설치

bun add @capgo/capacitor-speech-recognition
bunx cap sync

플러그인 주요 기능

  • available - 현재 기기에서 네이티브 음성 인식 서비스를 사용할 수 있는지 확인합니다.
  • isOnDeviceRecognitionAvailable - 선택한 언어(locale)에 대해 플랫폼의 최신 온디바이스 인식 경로를 사용할 수 있는지 확인합니다.
  • start - 오디오 캡처 및 음성 텍스트 변환을 시작합니다.
  • stop - 리스닝을 중단하고 네이티브 리소스를 해제합니다.

사용 예시

available

현재 기기에서 네이티브 음성 인식 서비스를 사용할 수 있는지 확인합니다.

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.available();
console.log(result);

isOnDeviceRecognitionAvailable

선택한 로캘에 대해 플랫폼의 최신 온디바이스 인식 경로를 사용할 수 있는지 확인합니다.

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.isOnDeviceRecognitionAvailable();
console.log(result);

start

오디오 캡처와 음성 전사를 시작합니다.

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.start();
console.log(result);

stop

리스닝을 중단하고 네이티브 리소스를 해제합니다.

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

await SpeechRecognition.stop();

전체 레퍼런스

@capgo/capacitor-speech-recognition 사용법 더 보기

사용 중인 경우 @capgo/capacitor-speech-recognition 사용하기 대시보드와 API 운영을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-speech-recognition @capgo/capacitor-speech-recognition의 구현 세부 사항은 시작하기 시작하기 문서의 구현 상세 내용은, API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 세부 사항과, API 키 API Keys의 구현 세부 사항을 참고하세요.

자주 묻는 질문

Speech Recognition 플러그인 FAQ

Capacitor 앱에 Speech Recognition 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-speech-recognition" (또는 "npm install @capgo/capacitor-speech-recognition")를 실행한 다음, "bunx cap sync"를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 반영하도록 합니다. 앱의 code에서 "@capgo/capacitor-speech-recognition"를 통해 import 하세요.

@capgo/capacitor-speech-recognition가 React, Vue, Angular와 호환되나요?

네. Speech Recognition은 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript를 포함하여 Capacitor 환경에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-speech-recognition는 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8의 경우 플러그인 v8). GitHub README의 호환성 표에서 유지 관리되는 버전을 확인할 수 있습니다.

@capgo/capacitor-speech-recognition는 무료이며 오픈 소스인가요?

네. code 소스 코드는 GitHub의 https://github.com/Cap-go/capacitor-speech-recognition/ 에서 공개되어 있으며, npm에서 무료로 설치할 수 있습니다. 버그 리포트와 pull request를 환영합니다.

App Store 심사 없이 Speech Recognition을 사용하는 code를 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 심사 대기 없이 Speech Recognition 변경 사항을 즉시 배포하세요

스토어 빌드에 플러그인이 포함되면 Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo부터 시작하세요