Voice AI 모바일 중복 현상 수정

voice/README_GOOGLE_API.md

@@ -0,0 +1,104 @@
+# 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. ✅ 필요시 추가 최적화
+