86 lines
4.0 KiB
Markdown
86 lines
4.0 KiB
Markdown
# 临时呼叫页面语音提示与确认功能设计规约 (Design Spec)
|
||
|
||
## 1. 需求概述
|
||
在 `TempCallActivity` 弹出页面（临时呼叫页面）时，需要播放一段本地语音提示。
|
||
* **语音播报文本**："您有一条拉动，请注意确认"。
|
||
* **播报循环规则**：若用户不操作，默认播放并重复 3 次。
|
||
* **交互设计**：
|
||
* 页面中央的信息卡片中新增一个“确认”按钮。
|
||
* 用户点击“确认”按钮时，能够立即静音/停止当前正在播放的语音，且该按钮在静音后隐藏。
|
||
* 点击“确认”按钮时仅关闭语音播放，暂时不需要关闭页面。
|
||
|
||
## 2. 方案设计
|
||
|
||
### 2.1 语音资源准备
|
||
* **文件名**：`pull_alert.wav`
|
||
* **保存路径**：`app/src/main/res/raw/pull_alert.wav`（若没有 `raw` 文件夹，将自动创建）
|
||
* **生成方式**：使用 Python 脚本调用 Edge TTS 等免费 TTS 接口，在线合成带有“您有一条拉动，请注意确认”文本的高质量 WAV 音频，并自动保存到对应目录下。
|
||
|
||
### 2.2 布局修改
|
||
* **目标文件**：`app/src/main/res/layout/activity_temp_call.xml`
|
||
* **修改位置**：在包含 `tv_talk_status` 的内部 `LinearLayout` 容器下方，添加“确认”按钮。
|
||
* **按钮样式**：
|
||
* 文字："确认"
|
||
* 默认可见性：`android:visibility="gone"`（开始播放时显示，停止播放/确认后隐藏）
|
||
* 背景：复用现有 `@drawable/btn_minimize_bg`。
|
||
|
||
```xml
|
||
<!-- 用于确认并静音语音的按钮 -->
|
||
<Button
|
||
android:id="@+id/btn_confirm_alert"
|
||
android:layout_width="match_parent"
|
||
android:layout_height="wrap_content"
|
||
android:layout_marginTop="16dp"
|
||
android:background="@drawable/btn_minimize_bg"
|
||
android:text="确认"
|
||
android:textColor="#FFFFFF"
|
||
android:textSize="14sp"
|
||
android:visibility="gone" />
|
||
```
|
||
|
||
### 2.3 业务逻辑实现
|
||
* **目标文件**：`app/src/main/java/com/stand/standapp/TempCallActivity.kt`
|
||
* **主要逻辑**：
|
||
1. 定义 `MediaPlayer` 实例 `private var alertPlayer: MediaPlayer? = null` 及播放计数器 `private var alertPlayCount = 0`。
|
||
2. 实现播放方法 `private fun startVoiceAlert()`：
|
||
- 如果 `alertPlayer` 尚未初始化，利用 `MediaPlayer.create(this, R.raw.pull_alert)` 初始化。
|
||
- 显示“确认”按钮：`btnConfirmAlert.visibility = View.VISIBLE`。
|
||
- 监听播放完成事件：
|
||
```kotlin
|
||
alertPlayer?.setOnCompletionListener {
|
||
alertPlayCount++
|
||
if (alertPlayCount < 3) {
|
||
alertPlayer?.start()
|
||
} else {
|
||
stopVoiceAlert()
|
||
}
|
||
}
|
||
```
|
||
- 开始播放并设置 `alertPlayCount = 0`。
|
||
3. 实现停止方法 `private fun stopVoiceAlert()`：
|
||
- 安全释放 `MediaPlayer` 资源：
|
||
```kotlin
|
||
alertPlayer?.let { player ->
|
||
try {
|
||
if (player.isPlaying) {
|
||
player.stop()
|
||
}
|
||
} catch (e: Exception) {
|
||
// 忽略错误
|
||
} finally {
|
||
player.release()
|
||
}
|
||
}
|
||
alertPlayer = null
|
||
```
|
||
- 隐藏“确认”按钮：`btnConfirmAlert.visibility = View.GONE`。
|
||
4. 设置“确认”按钮的点击事件：
|
||
- 点击时调用 `stopVoiceAlert()`。
|
||
5. 页面销毁生命周期：
|
||
- 在 `onDestroy()` 中，必须调用 `stopVoiceAlert()` 以防止内存泄漏和页面销毁后后台仍在播放的情况。
|
||
|
||
## 3. 测试与自审规范
|
||
* **测试用例 1**：启动临时呼叫页面，验证语音提示是否以正常音量播放，且重复播放 3 次后自动停止，同时“确认”按钮自动隐藏。
|
||
* **测试用例 2**：语音播放期间点击“确认”按钮，验证语音是否立刻停止播放，且“确认”按钮是否立即隐藏。
|
||
* **测试用例 3**：语音播放期间直接关闭或最小化页面，验证后台音乐播放器是否正确释放，不存在背景音残留。
|