# 🎬 連續演示模式使用指南

## 功能特點

### 1️⃣ 從頭到尾連續播放
- 按 ASR 片段順序播放
- 不跳躍、不間斷
- 完整呈現所有內容

### 2️⃣ 顯示所有識別信息
每個片段顯示：
- **ASR**: 文字內容
- **Speaker**: 說話人 + 演員名 + 角色名
- **Face**: 人臉位置和置信度
- **Pose**: 嘴部關鍵點
- **更多**: 未來可擴展 OCR、場景等

### 3️⃣ 鍵盤控制
- **SPACE**: 暫停/恢復
- **Q**: 停止並退出

---

## 快速開始

### 基本用法

```bash
./run_demo.sh --continuous
```

### 顯示視頻

```bash
./run_demo.sh --continuous --video
```

---

## 使用範例

### 1. 音頻連續播放（默認）

```bash
./run_demo.sh --continuous
```

**輸出示例**：
```
🎬 Continuous Demo Mode
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📺 Playing from beginning to end
⏸️  Press SPACE to pause/resume
⏹️  Press Q to quit
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[1/1118] Segment
================================================================================
⏱  Time: 14.20s - 21.50s
🎤 Speaker: SPEAKER_4 → James Coburn (Tex Panthollow)
================================================================================
▶️  Playing: 14.20s - 21.50s (7.30s)

[2/1118] Segment
================================================================================
⏱  Time: 22.40s - 58.30s
🎤 Speaker: SPEAKER_4 → James Coburn (Tex Panthollow)
================================================================================
▶️  Playing: 22.40s - 58.30s (35.90s)
```

### 2. 視頻連續播放

```bash
./run_demo.sh --continuous --video
```

**特點**：
- 📺 彈出視頻窗口
- 🎬 視聽同步
- 💯 完整體驗

### 3. 自定義窗口大小

```bash
./target/debug/integrated_player \
  --video /tmp/charade_audio.wav \
  --asrx /tmp/asrx_charade_optimized.json \
  --continuous-demo \
  --show-video \
  --video-width 1600 \
  --video-height 900
```

---

## 鍵盤控制詳解

### ⏸️ 暫停（SPACE）

**何時使用**：
- 想仔細看某個片段
- 需要暫停分析
- 想跳過某些內容

**操作**：
```
⏸️  Paused - Press SPACE to resume
```

再次按 SPACE 恢復播放。

### ⏹️ 退出（Q）

**何時使用**：
- 演示完成
- 想提前結束
- 切換到其他任務

**操作**：
```
⏹️  Stopped by user
```

立即停止並退出。

---

## 演示流程

### 完整流程圖

```
開始
  ↓
載入數據（ASR, ASRX, Face, Pose）
  ↓
逐句播放 ASR 片段
  ├─ 顯示文字
  ├─ 顯示說話人
  ├─ 顯示人臉
  ├─ 顯示嘴部動作
  └─ 播放音頻/視頻
  ↓
用戶可隨時：
  ├─ SPACE 暫停/恢復
  └─ Q 退出
  ↓
播放完成
```

---

## 信息顯示格式

### 標準格式

```
[片段序號/總數] Segment
================================================================================
⏱  Time: 起始時間 - 結束時間
📝 Text: 文字內容（如果有）
🎤 Speaker: 說話人ID → 演員名 (角色名)
👤 Face: 位置、大小、置信度（如果有）
👄 Mouth landmarks: 嘴部關鍵點（如果有）
================================================================================
▶️  Playing: 起始時間 - 結束時間 (時長)
```

### 實際範例

```
[234/1118] Segment
================================================================================
⏱  Time: 299.50s - 303.10s
🎤 Speaker: SPEAKER_1 → Audrey Hepburn (Regina Lampert)
👤 Face: bbox=(1250,178) 147x206, confidence=0.88
================================================================================
▶️  Playing: 299.50s - 303.10s (3.60s)
```

---

## 與其他模式對比

| 特性 | 連續模式 | 說話人演示 | 交互模式 |
|------|----------|-----------|----------|
| **播放方式** | 從頭到尾 | 按說話人 | 手動控制 |
| **自動化** | ✅ 全自動 | ✅ 半自動 | ❌ 手動 |
| **信息展示** | ✅ 完整 | ✅ 完整 | ✅ 按需 |
| **暫停控制** | ✅ 支持 | ❌ 不支持 | N/A |
| **適用場景** | 完整演示 | 說話人分析 | 深度分析 |

---

## 使用場景

### 1. 完整功能演示

```bash
# 展示所有識別功能
./run_demo.sh --continuous --video
```

適用於：
- 向客戶演示
- 團隊內部展示
- 功能驗收

### 2. 內容審核

```bash
# 快速瀏覽所有內容
./run_demo.sh --continuous
```

適用於：
- 檢查 ASR 準確度
- 驗證說話人識別
- 確認人臉檢測

### 3. 數據驗證

```bash
# 驗證處理結果
./target/debug/integrated_player \
  --video video.mp4 \
  --asr asr.json \
  --asrx asrx.json \
  --face face.json \
  --continuous-demo
```

適用於：
- 檢查處理質量
- 發現問題片段
- 優化處理參數

---

## 高級用法

### 1. 慢速播放

```bash
# 慢速觀看細節
./target/debug/integrated_player \
  --video video.mp4 \
  --asrx asrx.json \
  --continuous-demo \
  --show-video
```

按 SPACE 暫停查看細節。

### 2. 快速瀏覽

```bash
# 音頻模式快速瀏覽
./run_demo.sh --continuous
```

適合快速了解內容。

### 3. 特定時間段

結合交互模式：

```bash
# 1. 先用交互模式找到起始時間
./target/debug/integrated_player --video video.mp4 --asrx asrx.json

# 2. 輸入時間跳轉
> 300

# 3. 改用連續模式從該時間開始
# (需要修改代碼支持 --start 參數)
```

---

## 性能優化

### 1. 音頻模式

```bash
# 最快、最輕量
./run_demo.sh --continuous
```

### 2. 視頻模式

```bash
# 較慢、更完整
./run_demo.sh --continuous --video
```

### 3. 自定義窗口

```bash
# 小窗口更快
--video-width 640 --video-height 480
```

---

## 常見問題

### Q1: 播放速度太快？

A: 按 SPACE 暫停，仔細查看信息。

### Q2: 想跳過某些片段？

A: 按 Q 退出，使用交互模式手動選擇。

### Q3: 沒有 ASR 數據？

A: 連續模式需要 ASR 數據。請確保提供 `--asr` 參數。

### Q4: 某些片段沒有信息？

A: 正常現象。不是每個片段都有所有信息（Face、Pose等）。

### Q5: 可以調整播放速度嗎？

A: 連續模式按實際時長播放。需要快進請使用 `--demo` 模式。

---

## 命令速查

```bash
# 連續音頻演示
./run_demo.sh --continuous

# 連續視頻演示
./run_demo.sh --continuous --video

# 自定義窗口
./target/debug/integrated_player \
  --video video.mp4 \
  --asrx asrx.json \
  --continuous-demo \
  --show-video \
  --video-width 1600 \
  --video-height 900

# 鍵盤控制
SPACE - 暫停/恢復
Q     - 退出
```

---

## 未來擴展

### 計劃功能

1. **進度條**: 顯示當前播放進度
2. **時間跳轉**: 支持從指定時間開始
3. **字幕疊加**: 在視頻上顯示 ASR 文字
4. **人臉標註**: 在視頻上畫出人臉框
5. **OCR 整合**: 顯示文字識別結果
6. **場景識別**: 顯示場景類型

---

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