105 lines
2.9 KiB
Markdown
105 lines
2.9 KiB
Markdown
|
# 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. ✅ 필요시 추가 최적화
|
||
|
|
|