🗣️ TTSHelper

TTSHelper는 Google Cloud Text-to-Speech API를 통해 텍스트를 음성(MP3 파일)으로 변환하고, 앱의 오디오 재생 흐름에 통합하기 위한 유틸리티 클래스입니다.

---

✅ 주요 기능 요약

기능	설명
텍스트 → 음성 변환	Google TTS API를 사용해 텍스트를 MP3 오디오 파일로 변환
오디오 파일 캐싱	변환된 MP3는 캐시 디렉토리에 저장하여 재요청 방지
변환 완료 콜백 제공	변환이 완료되면 콜백 인터페이스로 알림
기본 음성 재생 지원	테스트용 기본 MP3가 존재할 경우 바로 재생 가능
실패 시 Toast 안내	에러 발생 시 사용자에게 Toast로 피드백 제공

---

🔧 주요 로직 설명

📌 텍스트를 TTS 요청으로 변환

data.put("input", new JSONObject().put("text", text));
data.put("voice", new JSONObject().put("languageCode", "ko-KR"));
data.put("audioConfig", new JSONObject().put("audioEncoding", "MP3"));

• JSON 형태로 Google TTS API에 요청할 데이터를 구성합니다.

---

📌 이미 존재하는 오디오 파일 확인

if (audioFile.exists()) {
    listener.onAudioFileReady(audioFile);
    return;
}

• 동일한 파일 이름이 이미 캐시에 존재하면 API 호출 없이 즉시 재생 가능하도록 처리합니다.

---

📌 오디오 파일 저장

byte[] decodedAudio = Base64.decode(audioContentEncoded, Base64.DEFAULT);
try (FileOutputStream fos = new FileOutputStream(audioFile)) {
    fos.write(decodedAudio);
    listener.onAudioFileReady(audioFile);
}

• TTS 응답에서 받은 Base64 인코딩된 음성을 디코딩 후 MP3 파일로 저장합니다.

---

🔗 관련 클래스 및 사용 위치

• AudioService: 오디오 재생 처리
• ReportAdapter 및 HomeFragment에서 사용되어 TTS 결과를 재생

---

⚠️ 참고: TTSHelper 클래스는 Google Cloud TTS API 키가 필요하며, 사용량에 따라 비용이 청구될 수 있습니다.