sam-kd/voice/README_GOOGLE_API.md

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

빠른 시작

1. Google Cloud API 키 설정

1. 설정 파일 생성

   # 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
   $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. ✅ 필요시 추가 최적화