# 🎬 演示功能使用說明

## 問題：只聽到聲音？

您遇到的情況是正常的！默認情況下，演示模式只播放音頻，不顯示視頻畫面。這樣可以：
- 快速瀏覽所有說話人
- 專注於語音內容
- 不受視頻窗口干擾

---

## 解決方案：顯示視頻畫面

### 方法 1: 使用演示腳本（推薦）

```bash
# 快速演示 + 顯示視頻
./run_demo.sh --quick --video

# 標準演示 + 顯示視頻
./run_demo.sh --video

# 完整演示 + 顯示視頻
./run_demo.sh --video
```

### 方法 2: 直接使用播放器

```bash
# 啟用視頻顯示
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --demo \
  --show-video

# 自定義視頻窗口大小
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --demo \
  --show-video \
  --video-width 1200 \
  --video-height 800
```

---

## 完整參數說明

### 視頻相關參數

| 參數 | 說明 | 默認值 |
|------|------|--------|
| `--show-video` | 顯示視頻畫面 | false（僅音頻） |
| `--video-width` | 視頻窗口寬度 | 800 |
| `--video-height` | 視頻窗口高度 | 600 |

### 演示相關參數

| 參數 | 說明 | 默認值 |
|------|------|--------|
| `--demo` | 啟用自動演示模式 | false |
| `--demo-segments-per-speaker` | 每個說話人的片段數 | 3 |
| `--demo-speed` | 演示速度倍數 | 2.0 |

---

## 使用範例

### 1. 音頻模式（默認）

```bash
# 僅播放音頻，不顯示視頻
./run_demo.sh --quick
```

**優點**：
- ✅ 快速瀏覽
- ✅ 專注語音
- ✅ 不受干擾

**適用場景**：
- 快速測試
- 語音內容分析
- 後台播放

### 2. 視頻模式

```bash
# 顯示視頻畫面
./run_demo.sh --video
```

**優點**：
- ✅ 視聽結合
- ✅ 更直觀
- ✅ 完整體驗

**適用場景**：
- 功能演示
- 內容展示
- 完整測試

### 3. 自定義模式

```bash
# 慢速演示 + 大窗口
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --demo \
  --show-video \
  --demo-speed 1.0 \
  --video-width 1600 \
  --video-height 900 \
  --demo-segments-per-speaker 5
```

---

## 對比：音頻模式 vs 視頻模式

| 特性 | 音頻模式 | 視頻模式 |
|------|----------|----------|
| **播放速度** | 快 | 慢 |
| **資源占用** | 低 | 高 |
| **窗口干擾** | 無 | 有 |
| **體驗完整度** | 70% | 100% |
| **適用場景** | 測試、分析 | 演示、展示 |

---

## 推薦使用方式

### 開發測試
```bash
# 快速音頻測試
./run_demo.sh --quick
```

### 功能演示
```bash
# 視頻演示
./run_demo.sh --video
```

### 完整體驗
```bash
# 慢速視頻演示
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --face /tmp/face_long.json \
  --demo \
  --show-video \
  --demo-speed 1.0 \
  --demo-segments-per-speaker 5
```

---

## 常見問題

### Q: 為什麼默認不顯示視頻？

A: 
1. **性能考慮**：音頻模式更快、更輕量
2. **專注內容**：不受視覺干擾
3. **測試效率**：快速瀏覽所有說話人

### Q: 如何調整視頻窗口大小？

A:
```bash
--video-width 1200 --video-height 800
```

### Q: 可以同時顯示字幕嗎？

A: 目前終端會顯示 ASR 文字，未來可以考慮在視頻上疊加字幕。

### Q: 視頻播放卡頓？

A: 
1. 使用較低的 `--demo-speed`（如 1.5）
2. 減少 `--demo-segments-per-speaker`
3. 確保系統性能足夠

---

## 完整演示命令集合

```bash
# 1. 快速音頻演示
./run_demo.sh --quick

# 2. 快速視頻演示
./run_demo.sh --quick --video

# 3. 標準音頻演示
./run_demo.sh

# 4. 標準視頻演示
./run_demo.sh --video

# 5. 完整視頻演示（慢速 + 大窗口）
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --demo \
  --show-video \
  --demo-speed 1.0 \
  --video-width 1600 \
  --video-height 900
```

---

**更新日期**: 2026-04-02  
**版本**: 1.2.0  
**作者**: Momentry Team
