Pygame.mixer.Sound: примеры (PYTHON)

Примеры использования

Простая загрузка и воспроизведение звукового файла:

import pygame
pygame.mixer.init()
sound = pygame.mixer.Sound('sound.wav')
sound.play()

# Звук начинает играть один раз.

Воспроизведение с параметрами:

import pygame
pygame.mixer.init()
sound = pygame.mixer.Sound('loop.ogg')
channel = sound.play(loops=-1, maxtime=5000)

# Звук зацикливается бесконечно, но обрезается после 5 секунд воспроизведения.

Управление громкостью:

import pygame
pygame.mixer.init()
sound = pygame.mixer.Sound('effect.wav')
sound.set_volume(0.5)
print(f"Громкость: {sound.get_volume()}")
sound.play()

Громкость: 0.5

Похожие функции в Python

В экосистеме Python существуют другие библиотеки для работы со звуком:

• pygame.mixer.music – модуль для фоновой музыки. Управляет одним потоком воспроизведения, поддерживает загрузку из файла без полной загрузки в память. Предпочтительнее для длинных аудиодорожек.
• simpleaudio – кроссплатформенная библиотека для простого воспроизведения WAV-файлов. Имеет менее сложный API, но и меньше возможностей.
• pydub – предоставляет высокоуровневый API для манипуляций со звуком (нарезка, конвертация, эффекты). Для воспроизведения часто использует внешние бэкенды, такие как pygame или simpleaudio.

Выбор зависит от задачи: pygame.mixer.Sound оптимален для звуковых эффектов в играх на PyGame.

Альтернативы в других языках

Разные языки предлагают свои подходы к воспроизведению звука.

JavaScript (Web Audio API):

const audioContext = new AudioContext();
const response = await fetch('sound.mp3');
const arrayBuffer = await response.arrayBuffer();
const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
const source = audioContext.createBufferSource();
source.buffer = audioBuffer;
source.connect(audioContext.destination);
source.start();

// Асинхронная загрузка и воспроизведение с более тонким контролем над аудиографом.

Java (javax.sound.sampled):

import javax.sound.sampled.*;
Clip clip = AudioSystem.getClip();
AudioInputStream ais = AudioSystem.getAudioInputStream(new File("sound.wav"));
clip.open(ais);
clip.start();

// Синхронная загрузка и воспроизведение через интерфейс Clip.

C# (System.Media.SoundPlayer):

using System.Media;
SoundPlayer player = new SoundPlayer("sound.wav");
player.Play();

// Простое воспроизведение WAV-файлов без низкоуровневого контроля.

Основное отличие от Python - более низкоуровневый доступ в JavaScript и статическая типизация в Java/C#.

Типичные ошибки

1. Не инициализирован микшер PyGame. Перед созданием объекта Sound необходимо вызвать pygame.mixer.init().

import pygame
sound = pygame.mixer.Sound('test.wav')  # Ошибка!

pygame.error: mixer not initialized

2. Неверный путь к файлу или неподдерживаемый формат.

import pygame
pygame.mixer.init()
sound = pygame.mixer.Sound('missing.mp3')

FileNotFoundError: [Errno 2] No such file or directory: 'missing.mp3'

3. Попытка воспроизведения слишком большого количества звуков одновременно. По умолчанию количество каналов ограничено 8. Если все каналы заняты, новый звук не воспроизведется.

import pygame
pygame.mixer.init()
sounds = [pygame.mixer.Sound('beep.wav') for _ in range(10)]
for s in sounds:
    s.play()  # Некоторые звуки не будут слышны

Изменения в последних версиях

В версии PyGame 2.0 были внесены значительные изменения в работу со звуком:

• Добавлена поддержка большего количества аудиоформатов через SDL2 (например, FLAC, Opus).
• Улучшена стабильность работы с MP3-файлами на всех платформах.
• Методы play() и fadeout() стали более предсказуемыми в многопоточной среде.
• Появилась возможность указать аргумент fade_ms в методе play() для плавного старта звука (начиная с PyGame 2.0.2).

Расширенные примеры

Использование буфера данных для создания звука:

import pygame
import numpy as np
pygame.mixer.init(frequency=22050, size=-16, channels=2)
# Генерация синусоиды 440 Гц длительностью 1 секунда
t = np.linspace(0, 1, 22050, endpoint=False)
data = (np.sin(2 * np.pi * 440 * t) * 32767).astype(np.int16)
# Создание стерео-буфера (чередование каналов)
stereo_data = np.repeat(data.reshape(-1, 1), 2, axis=1).flatten()
sound = pygame.mixer.Sound(buffer=stereo_data)
sound.play()

# Воспроизводится чистый тон ноты Ля первой октавы.

Плавный переход между звуками:

import pygame, time
pygame.mixer.init()
sound1 = pygame.mixer.Sound('intro.ogg')
sound2 = pygame.mixer.Sound('main.ogg')
channel1 = sound1.play()
time.sleep(sound1.get_length() - 0.5)  # Ждем почти до конца
channel2 = sound2.play(fade_ms=500)  # Плавный вход второго звука

# Два звука плавно сменяют друг друга.

Обработка события окончания воспроизведения (через канал):

import pygame
pygame.mixer.init()
def callback():
    print("Звук завершился")
sound = pygame.mixer.Sound('alarm.wav')
channel = sound.play()
if channel:
    channel.set_endevent(pygame.USEREVENT)
# В основном цикле игры нужно проверять очередь событий на pygame.USEREVENT