From 64b3ad2b5984b706c48b851ca67cef96f6d01665 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?=
 <lightone2017@codebridge-x.com>
Date: Sun, 8 Mar 2026 13:58:48 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20[sound-logo]=20TTS=20=EC=9D=8C=EC=84=B1?=
 =?UTF-8?q?=20=EC=98=B5=EC=85=98=20=ED=99=95=EC=9E=A5=20+=20=EC=9E=A1?=
 =?UTF-8?q?=EC=9D=8C=20=EB=AC=B8=EC=A0=9C=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- PCM 디코딩 endianness 수정 (big-endian → little-endian, Gemini TTS는 s16le)
- 16종 음성 선택 옵션 추가 (남성/여성/중성, 성격 설명)
- 9종 발화 스타일 옵션 추가 (밝고 활기차게, 차분하고 신뢰감 등)
- 음성/스타일을 컨트롤러에 전달하여 Gemini API에 적용
- 기본 텍스트: '우리들의 솔루션 쌤, 쌤, 쌤'
---
 app/Http/Controllers/RdController.php         | 16 ++++-
 resources/views/rd/sound-logo/index.blade.php | 58 +++++++++++++++++--
 2 files changed, 68 insertions(+), 6 deletions(-)

diff --git a/app/Http/Controllers/RdController.php b/app/Http/Controllers/RdController.php
index 18439262..3f70fc9a 100644
--- a/app/Http/Controllers/RdController.php
+++ b/app/Http/Controllers/RdController.php
@@ -485,6 +485,8 @@ public function soundLogoTts(Request $request): JsonResponse
     {
         $request->validate([
             'text' => 'required|string|max:200',
+            'voice_name' => 'nullable|string|max:30',
+            'voice_style' => 'nullable|string|max:100',
         ]);
 
         $apiKey = config('services.gemini.api_key');
@@ -494,8 +496,18 @@ public function soundLogoTts(Request $request): JsonResponse
             return response()->json(['success' => false, 'error' => 'Gemini API 키가 설정되지 않았습니다.'], 500);
         }
 
-        // 짧은 텍스트는 TTS 모델이 텍스트 생성으로 인식할 수 있으므로 발화 컨텍스트 추가
+        $voiceName = $request->voice_name ?: 'Kore';
+        $voiceStyle = $request->voice_style ?: '';
+
+        // TTS에 전달할 텍스트 구성
         $ttsText = $request->text;
+
+        // 스타일 지시가 있으면 프롬프트로 감싸기
+        if ($voiceStyle) {
+            $ttsText = "{$voiceStyle}: {$ttsText}";
+        }
+
+        // 짧은 텍스트는 TTS 모델이 텍스트 생성으로 인식할 수 있으므로 발화 컨텍스트 추가
         if (mb_strlen($ttsText) < 4) {
             $ttsText = "'{$ttsText}' ";
         }
@@ -512,7 +524,7 @@ public function soundLogoTts(Request $request): JsonResponse
                         'speechConfig' => [
                             'voiceConfig' => [
                                 'prebuiltVoiceConfig' => [
-                                    'voiceName' => 'Kore',
+                                    'voiceName' => $voiceName,
                                 ],
                             ],
                         ],
diff --git a/resources/views/rd/sound-logo/index.blade.php b/resources/views/rd/sound-logo/index.blade.php
index 6585bc22..dd8c7422 100644
--- a/resources/views/rd/sound-logo/index.blade.php
+++ b/resources/views/rd/sound-logo/index.blade.php
@@ -353,7 +353,22 @@
             <div class="sl-section">
                 <div class="sl-section-title">음성 오버레이 (TTS)</div>
                 <div style="margin-bottom: 6px;">
-                    <input class="sl-input" x-model="voiceText" placeholder='예: 쌤!, SAM' style="margin-bottom: 6px;">
+                    <input class="sl-input" x-model="voiceText" placeholder='예: 우리들의 솔루션 쌤' style="margin-bottom: 6px;">
+
+                    <!-- 음성 선택 -->
+                    <select class="sl-select" x-model="voiceName" style="margin-bottom: 6px;">
+                        <template x-for="opt in voiceOptions" :key="opt.value">
+                            <option :value="opt.value" x-text="opt.label + ' (' + opt.gender + ', ' + opt.desc + ')'"></option>
+                        </template>
+                    </select>
+
+                    <!-- 스타일 선택 -->
+                    <select class="sl-select" x-model="voiceStyle" style="margin-bottom: 6px;">
+                        <template x-for="s in voiceStyleOptions" :key="s.value">
+                            <option :value="s.value" x-text="s.label"></option>
+                        </template>
+                    </select>
+
                     <button class="sl-btn sm primary" style="width:100%;" @click="generateVoice()" :disabled="voiceLoading || !voiceText.trim()">
                         <template x-if="!voiceLoading">
                             <span><i class="ri-mic-line"></i> 음성 생성</span>
@@ -1044,13 +1059,44 @@ function soundLogo() {
             '클래식 록 기타 리프와 드럼',
         ],
         // 음성 오버레이
-        voiceText: '',
+        voiceText: '우리들의 솔루션 쌤, 쌤, 쌤',
         voiceAudioData: null,
         voiceMimeType: '',
         voiceLoading: false,
         voiceDelay: 0.0,
         voiceVolume: 0.8,
         voiceBuffer: null,
+        voiceName: 'Kore',
+        voiceStyle: '',
+        voiceOptions: [
+            { value: 'Kore', label: '코어', desc: '단정하고 명확한', gender: '여성' },
+            { value: 'Aoede', label: '아오이데', desc: '산뜻하고 가벼운', gender: '여성' },
+            { value: 'Leda', label: '레다', desc: '젊고 발랄한', gender: '여성' },
+            { value: 'Puck', label: '퍽', desc: '밝고 활발한', gender: '남성' },
+            { value: 'Charon', label: '카론', desc: '정보적이고 안정적', gender: '남성' },
+            { value: 'Fenrir', label: '펜리르', desc: '에너지 넘치는', gender: '남성' },
+            { value: 'Orus', label: '오루스', desc: '무게감 있는', gender: '남성' },
+            { value: 'Perseus', label: '페르세우스', desc: '차분하고 침착한', gender: '남성' },
+            { value: 'Zephyr', label: '제피르', desc: '밝고 경쾌한', gender: '중성' },
+            { value: 'Achernar', label: '아케르나르', desc: '부드럽고 섬세한', gender: '여성' },
+            { value: 'Gacrux', label: '가크룩스', desc: '성숙하고 중후한', gender: '남성' },
+            { value: 'Sulafat', label: '술라파트', desc: '따뜻하고 포근한', gender: '여성' },
+            { value: 'Achird', label: '아키르드', desc: '친근하고 다정한', gender: '남성' },
+            { value: 'Vindemiatrix', label: '빈데미아트릭스', desc: '부드럽고 차분한', gender: '여성' },
+            { value: 'Sadachbia', label: '사다키비아', desc: '활기차고 생동감', gender: '여성' },
+            { value: 'Algieba', label: '알기에바', desc: '매끄럽고 세련된', gender: '남성' },
+        ],
+        voiceStyleOptions: [
+            { value: '', label: '기본 스타일' },
+            { value: '밝고 활기차게', label: '밝고 활기차게' },
+            { value: '차분하고 신뢰감 있게', label: '차분하고 신뢰감 있게' },
+            { value: '따뜻하고 부드럽게', label: '따뜻하고 부드럽게' },
+            { value: '힘 있고 당당하게', label: '힘 있고 당당하게' },
+            { value: '귀엽고 사랑스럽게', label: '귀엽고 사랑스럽게' },
+            { value: '진지하고 전문적으로', label: '진지하고 전문적으로' },
+            { value: '느리고 또박또박', label: '느리고 또박또박' },
+            { value: '빠르고 신나게', label: '빠르고 신나게' },
+        ],
 
         aiQuickPrompts: [
             '밝고 미래적인 IT 기업 로고',
@@ -1619,7 +1665,11 @@ function soundLogo() {
                         'Content-Type': 'application/json',
                         'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
                     },
-                    body: JSON.stringify({ text: this.voiceText }),
+                    body: JSON.stringify({
+                        text: this.voiceText,
+                        voice_name: this.voiceName,
+                        voice_style: this.voiceStyle,
+                    }),
                 });
 
                 const data = await res.json();
@@ -1653,7 +1703,7 @@ function soundLogo() {
             const ch = buffer.getChannelData(0);
 
             for (let i = 0; i < numSamples; i++) {
-                ch[i] = view.getInt16(i * 2, false) / 32768; // L16 = big-endian
+                ch[i] = view.getInt16(i * 2, true) / 32768; // Gemini TTS = s16le (little-endian)
             }
             return buffer;
         },