# Google Cloud Speech-to-Text API 실행 가이드

## 빠른 시작

### 1. Google Cloud API 키 설정

1. **설정 파일 생성**
   ```bash
   # config/google_speech_api.php.example을 복사
   cp config/google_speech_api.php.example config/google_speech_api.php
   ```

2. **Google Cloud Console에서 API 키 생성**
   - https://console.cloud.google.com/ 접속
   - 프로젝트 생성 또는 선택
   - "API 및 서비스" > "라이브러리"
   - "Cloud Speech-to-Text API" 검색 및 활성화
   - "API 및 서비스" > "사용자 인증 정보" > "사용자 인증 정보 만들기" > "API 키"
   - 생성된 API 키 복사

3. **설정 파일에 API 키 입력**
   ```php
   <?php
   $GOOGLE_SPEECH_API_KEY = '여기에_생성한_API_키_입력';
   ```

### 2. 실행 방법

1. **웹 서버 실행** (이미 실행 중이면 생략)
   - Apache/Nginx 등 웹 서버가 실행 중이어야 합니다.

2. **브라우저에서 접속**
   - `http://localhost/5130/voice/index.php` 또는 실제 서버 주소

3. **테스트**
   - **웹**: Web Speech API 사용 (기존 방식)
   - **모바일**: 자동으로 Google Cloud Speech-to-Text API 사용

### 3. 동작 방식

#### 웹 (데스크탑)
- Web Speech API 사용 (기존 방식 유지)
- 실시간 음성 인식
- 중복 텍스트 문제 해결됨

#### 모바일
- Google Cloud Speech-to-Text API 자동 사용
- MediaRecorder로 오디오 녹음
- 3초마다 서버로 전송하여 텍스트 변환
- 실시간 텍스트 업데이트

### 4. 문제 해결

#### API 키 오류
```
에러: Google Cloud Speech-to-Text API 키가 설정되지 않았습니다.
```
- `config/google_speech_api.php` 파일 확인
- API 키가 올바르게 설정되었는지 확인
- Google Cloud Console에서 API가 활성화되었는지 확인

#### 오디오 전송 실패
- 네트워크 연결 확인
- 서버 로그 확인 (`api/speech_to_text.php`의 에러 로그)
- 브라우저 콘솔 확인 (디버그 패널 사용)

#### 텍스트 변환 실패
- 마이크 권한 확인
- 오디오 형식 지원 확인 (webm, wav, ogg 등)
- Google Cloud API 할당량 확인 (무료: 월 60분)

### 5. 비용 정보

- **무료 할당량**: 월 60분
- **초과 시**: 사용량에 따른 과금
- **비용 절감**: 짧은 오디오만 전송하도록 최적화됨 (3초 청크)

### 6. 디버깅

디버그 패널 사용:
1. 우측 하단 디버그 버튼 클릭
2. 모든 로그 확인
3. 복사 버튼으로 로그 복사하여 공유

### 7. 파일 구조

```
5130/voice/
├── index.php (메인 페이지)
├── api/
│   └── speech_to_text.php (Google API 엔드포인트)
├── config/
│   └── google_speech_api.php (API 키 설정 - 생성 필요)
└── GOOGLE_SPEECH_API_PLAN.md (상세 계획)
```

## 다음 단계

1. ✅ API 키 설정
2. ✅ 웹에서 테스트
3. ✅ 모바일에서 테스트
4. ✅ 정확도 확인
5. ✅ 필요시 추가 최적화