在进行长时间工作或调试程序时，是否希望程序完成后能够发出提示音？本文将介绍如何在 stata 中实现这一功能。需要说明的是，本文中的代码是在 windows 10 (64-bit) + stata/mp 16.0 + python 3.7 环境下运行的。在不同系统和版本的程序中运行可能存在差异，如果你在自己的环境中遇到问题，建议放弃并将此文视为一个参考。如果你对这一主题感兴趣，可以自行搜索或与我交流。
我们将介绍三种让 Stata 发出提示音的方法：使用内置命令 beep、调用 Beep.exe 程序以及利用 Python 的 winsound 模块。最后一种方法特别值得探索，因为 winsound 中的 PlaySound 函数可以播放音乐，结合爬虫技术，你可以创建一个命令，用于播放最新排行榜的音乐。
我已经将本文涉及的安装包、代码和其他文件打包好，关注公众号并回复【Beep】即可获取。
实现过程
内置 beep 命令
在 Stata 命令窗口输入 beep 即可发出提示音。这可以很方便地嵌入到程序中，起到提醒作用。例如，当程序运行到50%时发出提示音：
forvalues i = 0(5)100 {
dis "程序已运行 `i' %"
if `i' == 50 {
beep
dis in y "提醒一下"
}
sleep 300
}调用 Beep 程序
使用 Beep.exe 前需要进行简单配置：从 RL Vision 下载 Beep.exe 程序（大小为40KB），然后进行路径管理，有两种选择：
- 将
Beep.exe放置在当前路径，使其随路径生效。 - 将
Beep.exe添加到环境变量中（环境变量配置见附录），这样配置一次后即可直接调用，但需要重启 Stata 才能生效。
配置好路径后，可以通过 {shell|!} 或 winexec 调用 Beep.exe：
shell Beep !Beep winexec Beep
Beep.exe 还支持一些参数，具体用法如下：
-- Usage --
Beep.exe {tone duration [/s sleep]} {...} [/r repeat] [/d]
tone Tone to play in Hz
duration Time in Ms to play tone
sleep Time in Ms to sleep after previous tone (optional)
* These 3 arguments can be repeated to play multiple tones.
* Time is measured in milliseconds (Ms). 1000 Ms = 1 second.
repeat Number of times to play entire sequence. (optional)
* Default is to play only once.
* Enter 0 for unlimited repeats (Break with Ctrl+C)
/d Print on screen what is playing (optional)
Note: If you don't enter any arguments, a "notification"
sound is played.
-- Examples --
Notification (the default sound):
beep.exe 240 10 /s 50 280 10 /s 50 340 10
Alarm:
beep.exe 300 15 310 15 320 15 330 15 340 15 350 15 360 15 370 15 380 15 390 15 400 15 390 15 380 15 370 15 360 15 350 15 340 15 330 15 320 15 310 15 300 15调用 Python 的 winsound 库
Python 的标准库 winsound 可以播放 Windows 声音，主要函数和常量如下：
frequency指定声音的频率（赫兹），duration 指定持续毫秒数
此外，还有一些播放次数和选择声音来源的设置，更详细的用法请参考官方文档。以下是一些用法示例：
Python:
import winsound
# 播放 Windows 退出提示音
winsound.PlaySound("SystemExit", winsound.SND_ALIAS)
# 循环、升调
freq = 100
dur = 50
for i in range(0, 10):
winsound.Beep(freq, dur)
freq += 100
dur += 80
# 播放自定义音乐
# 注意要是 `wav` 格式
winsound.PlaySound(r'..\Music\ding.wav', winsound.SND_FILENAME)
end
小结
通过以上方法，你可以在 Stata 中轻松实现程序运行完成后的提示音功能。无论是使用内置命令、调用外部程序，还是利用 Python 的 winsound 库，都能满足你的需求。希望本文对你有所帮助，祝你在使用 Stata 时更加高效和愉快。
