# Google Cloud Speech-to-Text API 전환 계획

## 목표
Web Speech API의 모바일 제한을 해결하고, Google Cloud Speech-to-Text API로 전환하여 모바일과 웹에서 모두 안정적으로 작동하도록 개선

## 현재 문제점
1. 모바일 Chrome에서 Web Speech API의 `onresult` 이벤트가 발생하지 않음
2. 웹 버전에서 텍스트 중복 문제 발생 (수정 완료)

## 해결 방안

### 1. Google Cloud Speech-to-Text API 사용
- **장점:**
  - 모바일과 웹에서 모두 안정적으로 작동
  - 더 높은 정확도
  - 실시간 스트리밍 지원
  - 한국어 지원 우수

- **단점:**
  - 서버 측 구현 필요
  - Google Cloud API 키 필요
  - API 사용량에 따른 비용 발생 (무료 할당량 있음)

### 2. 구현 계획

#### 2.1 서버 측 (PHP)
- `api/speech_to_text.php` 생성
- Google Cloud Speech-to-Text API 연동
- 오디오 파일 수신 및 변환
- JSON 응답 반환

#### 2.2 클라이언트 측 (JavaScript)
- MediaRecorder API로 오디오 녹음
- 실시간 스트리밍 또는 청크 단위 전송
- 서버 응답 받아서 텍스트 표시
- 기존 UI/UX 유지

### 3. 구현 단계

#### Phase 1: 서버 측 API 구현
1. Google Cloud Speech-to-Text API 설정
2. PHP API 엔드포인트 생성
3. 오디오 파일 수신 및 변환 로직

#### Phase 2: 클라이언트 측 구현
1. MediaRecorder API로 오디오 녹음
2. 실시간 또는 청크 단위 전송
3. 서버 응답 처리 및 텍스트 표시

#### Phase 3: 통합 및 테스트
1. 모바일/웹 호환성 테스트
2. 에러 처리 강화
3. 사용자 경험 개선

### 4. 필요한 설정

#### Google Cloud 설정
1. Google Cloud 프로젝트 생성
2. Speech-to-Text API 활성화
3. 서비스 계정 키 생성
4. PHP에서 사용할 수 있도록 설정

#### 서버 설정
1. PHP cURL 확장 확인
2. Google Cloud PHP 클라이언트 라이브러리 설치 (선택사항)
3. API 키 또는 서비스 계정 키 파일 위치 설정

### 5. API 사용 방법

#### 실시간 스트리밍 (권장)
- WebSocket 또는 Server-Sent Events 사용
- 실시간으로 오디오 전송 및 텍스트 수신

#### 청크 단위 전송
- 일정 간격으로 오디오 청크 전송
- 각 청크에 대한 텍스트 수신 및 누적

### 6. 비용 고려사항
- Google Cloud Speech-to-Text 무료 할당량: 월 60분
- 이후 사용량에 따른 과금
- 대안: 무료 할당량 내에서 사용하거나 유료 플랜 고려

## 다음 단계
1. Google Cloud 프로젝트 설정 확인
2. 서버 측 API 엔드포인트 구현
3. 클라이언트 측 오디오 녹음 및 전송 로직 구현
4. 통합 테스트