معرفی شرکت ها
audioplayer-0.6
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
audioplayer is a cross platform Python 3 module for playing sounds (mp3, wav, ...)
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | audioplayer-0.6 |
| نام | audioplayer |
| نسخه کتابخانه | 0.6 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Marcos Brusso |
| ایمیل نویسنده | mjbrusso@gmail.com |
| آدرس صفحه اصلی | https://github.com/mjbrusso/audioplayer |
| آدرس اینترنتی | https://pypi.org/project/audioplayer/ |
| مجوز | MIT License |
# AudioPlayer
**audioplayer** is a cross platform Python 3 package for playing sounds (mp3, wav, ...). It provides the key features of an audio player, such as opening a media file, playing (loop/block), pausing, resuming, stopping, and setting the playback volume.
I created this package to provide sound functionality to my game library [game2dboard](https://github.com/mjbrusso/game2dboard), but I decided to publish it separately.
Suported systems (see [full list](#Suported-Systems)):
- GNU/Linux (PC, Raspberry Pi, ...)
- Windows
- macOS
Inspired by (and with a few lines of codes from) the [playsound module](https://github.com/TaylorSMarks/playsound).
## Install
### Prerequisites
#### GNU/Linux
In Linux, you need to install PyGObject and others dependencies.
Ubuntu/Debian/Raspberry Pi OS:
```bash
sudo apt-get install python-gst-1.0 \
gir1.2-gstreamer-1.0 \
gstreamer1.0-tools \
gir1.2-gst-plugins-base-1.0
gstreamer1.0-plugins-good \
gstreamer1.0-plugins-ugly
```
Redhat/Centos/Fedora:
```bash
sudo yum install -y python-gstreamer1 \
gstreamer1-plugins-good \
gstreamer1-plugins-ugly
```
#### macOS
In macOS, you need to install PyObjC bridge.
```bash
pip3 install PyObjC --user
```
### Install
The recommended way to install `audioplayer` is using the Python **pip** (or **pip3**) installer.
```
pip3 install audioplayer
```
If you don't have administrator privileges, install in your home folder.
```
pip3 install audioplayer --user
```
You can install the latest release by cloning this repository.
```bash
git clone https://github.com/mjbrusso/audioplayer.git
cd audioplayer
python3 setup.py install --user
```
### Usage
The API is documented [bellow](#API) and within the docstrings.
After install, you can use this code to test (replace "path/to/somemusic.mp3"):
```python
from audioplayer import AudioPlayer
# Playback stops when the object is destroyed (GC'ed), so save a reference to the object for non-blocking playback.
AudioPlayer("path/to/somemusic.mp3").play(block=True)
```
## API
### Creation
- `audioplayer.AudioPlayer(filename)`<br>
Creates the player.
- `filename` : *str* – The file name with extension (.mp3, .wav, ...)
Raise: `FileNotFoundError()` : The file does not exist.
### Properties
- `filename` : *str* (readonly)<br>
The file name as provided in the constructor.
- `fullfilename` : *str* (readonly)<br>
The file name with full path.
- `volume` : *int* <br>
Gets or sets the current volume (in %) of the audio (0 — 100)
### Methods
- `play(loop=False, block=False)`<br>
Starts audio playback.
- `loop` (*bool*) – Sets whether to repeat the track automatically when finished.
- `block` (*bool*) – If true, blocks the thread until playback ends.
Raise: `AudioPlayerError()`: Failed to play.
- `pause()`<br>
Pauses audio playback.
- `resume()`<br>
Resumes audio playback.
- `stop()`<br>
Stops audio playback. Can play again.
- `close()`<br>
Closes device, releasing resources. Can't play again.
## Suported Systems
**audioPlayer** has been tested on the following platforms:
| OS | Details | mp3 | wav | ogg | mid |
| --------- | ---------------------- | :---: | :---: | :---: | :---: |
| GNU/Linux | Mint 19 (Cinnamon) | ✓ | ✓ | ✓ | ✕ |
| GNU/Linux | Xubuntu 20.04 | ✓ | ✓ | ✓ | ✓ |
| GNU/Linux | Raspberry Pi OS | ✓ | ✓ | ✓ | ✓ |
| Windows | Windows 10 x64 | ✓ | ✓ | ✕ | ✓ |
| macOS | Catalina (Python 3.8) | ✓ | ✓ | ✕ | ✕ |
`?`: *Not yet tested*
Let me know if you are using on another system/distro/version!
## What's in the roadmap?
- `.seek(position)` : Moves playback to the specified position.
- `.state` : Current state (playing, stopped, paused, ...)
- `.speed = value` : Gets/sets playback speed.
- Callbacks: when state changed, when position changed by a delta, ...
## How to Contribute
### Submitting an issue
Use the [issue tracker](https://github.com/mjbrusso/audioplayer/issues) to submit bug reports and features or enhancements requests.
### Translating
You can contribute by translating this document into other languages (except *en* and *pt_br*).
### Submitting a pull request
If you can improve anything in this project, feel free to add a [pull request](https://github.com/mjbrusso/audioplayer/pulls).
## License
**audioplayer** is under [MIT license](https://github.com/mjbrusso/audioplayer/blob/master/LICENSE). It can be reused within proprietary software provided that all copies of the licensed software include a copy of the MIT License terms and the copyright notice.
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3 | Python |
نحوه نصب
نصب پکیج whl audioplayer-0.6:
pip install audioplayer-0.6.whl
نصب پکیج tar.gz audioplayer-0.6:
pip install audioplayer-0.6.tar.gz