纯Python,跨平台,单功能模块,无需依赖即可播放声音。
项目描述
纯Python,跨平台,单功能模块,无需依赖即可播放声音。
安装
通过pip安装
$ pip install playsound
完成。
如果您坚持使用(稍微)困难的方式从源代码安装,您已经知道如何做,不需要我的帮助。
最新版本的源代码可以在以下位置找到: https://github.com/TaylorSMarks/playsound
快速入门
安装完成后,您可以非常快速地通过以下方式验证它是否正常工作
>>> from playsound import playsound
>>> playsound('/path/to/a/sound/file/you/want/to/play.mp3')
文档
playsound模块只包含一个东西 - 函数(也命名为playsound)。
它需要一个参数 - 您想播放的声音文件的路径。这可能是一个本地文件,或者一个URL。
有一个可选的第二个参数,block,默认设置为True。将其设置为False将使函数异步运行。
在Windows上,使用windll.winmm。已测试WAVE和MP3格式,并且已知它们可以正常工作。其他文件格式也可能可以正常工作。
在OS X上,使用AppKit.NSSound。已测试WAVE和MP3格式,并且已知它们可以正常工作。一般来说,QuickTime可以播放的任何内容,对于OS X,playsound也应该能够播放。
在Linux上,使用GStreamer。已知在Ubuntu 14.04和ElementaryOS Loki上可以正常工作。我预计任何具有标准gnome桌面体验的Linux发行版都应该可以正常工作。
如果您希望其他Linux发行版(或任何其他操作系统)可以正常工作,请提交一个PR来添加对其的支持,但请确保它通过了测试(见下文)。
测试
Playsound包含一组小型测试 - 如果您正在创建PR,请确保您没有回归,并且所有测试都在您的本地系统上通过。同时,请确保Travis-CI(这些测试针对Windows Server 2016、macOS 10.11(El Capitan,2015)和11.3(Big Sur,2020)、Ubuntu 14(Trusty)和Ubuntu 18(Bionic)运行,并对Python 2.7和3.9进行了全面测试)完全通过。您可以在以下位置检查Playsound的Travis-CI状态:https://travis-ci.cn/github/TaylorSMarks/playsound/builds
版权
本软件版权所有(c)2021 Taylor Marks <taylor@marksfam.com>。
有关更多信息,请参阅附带LICENSE文件。
项目详情
playsound-1.3.0.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | cc6ed11d773034b0ef624e6bb4bf50f4b76b8414a59ce6d38afb89b423297ced |
|
MD5 | e50e650bf09732c35e20204b57fef9cd |
|
BLAKE2b-256 | 678cc9f46b4b194126c4abb12e96321a6bea5c8dcc5c0e4d97622c14dfabe299 |