pygame中的mixer（含music）模块

混音器模块具有用于播放声音的有限数量的频道。通常程序会告诉pygame开始播放音频并自动选择可用的频道。默认值是8个同时的通道，但是复杂的程序可以更精确地控制通道的数量和使用。
所有的声音播放都在后台线程中调配。当开始播放一个Sound对象时，它将在声音继续播放时立即返回。单独一个声音对象也可以多次主动播放。
混音器模块必须像其他pygame模块一样初始化，但它有一些额外的条件：pygame.mixer.init() 函数需要几个可选参数来控制播放速率和样本大小。Pygame将默认为合理的值，但是Pygame不能执行声音重采样，因此应该初始化混音器以匹配音频资源的值。
对于较轻的延迟声音，请使用较小的缓冲区大小。默认设置是为了减少在某些计算机上发出刺耳声音的可能性。可以通过在调用pygame.mixer.init() 或 pygame.init()之前调用pygame.mixer.pre_init()。例如：pygame.mixer.pre_init(44100,-16,2, 1024)
混音器通过pygame.mixer.music模块控制音乐播放。音乐播放和常规声音播放的区别在于，音乐是流媒体播放的，而不是一次全部加载。混音系统一次只支持一个音乐流。但是注意MP3支持是有限的。在某些系统上，不支持的格式可能会使程序崩溃，例如Debian Linux，考虑改用OGG。

方法详解

控制播放

`pygame.mixer.init`()

功能：初始化混音器模块

属性：init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None, allowedchanges=AUDIO_ALLOW_FREQUENCY_CHANGE | AUDIO_ALLOW_CHANNELS_CHANGE) -> None

初始化混音器模块以加载和播放声音。可以重写默认参数以提供特定的音频混合。可以接受关键字参数，并对于设置为零的参数有向后兼容性，即替换为默认值。【可调用 pre_init 更改】

size参数表示每个音频样本使用了多少位。如果该值为负，则将使用带符号的样本值。正值表示将使用无符号音频样本。无效值引发异常。New in pygame 2：使用SDL2编译时，大小可以是32（32位浮点数）。
channels参数用于指定是使用mono还是stereo：1是单声道，2是立体声。New in pygame 2：频道的数量也可以是4或6。
buffer参数控制混音器中使用的内部采样数。默认值在大多数情况下都应该有效。可以降低它以减少延迟，但可能会出现声音丢失。它可以提高到更大的值以确保播放永远不会跳过，但它会对声音播放造成延迟。buffer参数大小必须是2的幂（如果不是，则四舍五入到下一个最接近的幂2）。
一些平台需要display模块初始化后初始化 pygame.mixer 模块。最高层 pygame.init() 自动处理此问题，但不能将任何参数传递给混音器初始化方法。为了解决这个问题，mixer有一个函数 pygame.mixer.pre_init()可以在使用顶层初始化之前设置正确的默认值。
当 allowedchanges=0 时，将在运行时转换示例以匹配硬件支持的内容。例如，声卡可能不支持16位声音采样，因此将在内部使用8位采样。如果提供了AUDIO_ALLOW_FORMAT_CHANGE，则请求的格式将更改为SDL2支持的最接近的格式。除了0之外，allowedchanged还接受以下常量（或同时）：
AUDIO_ALLOW_FREQUENCY_CHANGE
AUDIO_ALLOW_FORMAT_CHANGE
AUDIO_ALLOW_CHANNELS_CHANGE
AUDIO_ALLOW_ANY_CHANGE
New in pygame 2：为SDL2添加了allowedchanges。这对SDL1没有影响（即请求的格式可能总是与返回的格式不同）。
多次调用是安全的，但是在混音器初始化之后，如果不调用 pygame.mixer.quit()无法更改播放参数。

Changed in pygame 1.8:：默认缓冲区大小从1024更改为3072。The default buffersize was changed from 1024 to 3072.

Changed in pygame 1.9.1：默认缓冲区大小从3072更改为4096。

Changed in pygame 2.0.0：默认缓冲区大小从4096更改为512。默认频率从22050更改为44100。

`pygame.mixer.pre_init`()

功能：预设混音器初始参数

属性：pre_init(frequency=44100, size=-16, channels=2, buffer=512, devicename=None) -> None

当实际调用 pygame.mixer.init()时调用 pre_init 更改默认使用值。可以接受关键字参数。设置自定义混音器播放值的最佳方法是在顶层初始化 pygame.init()之前调用 pygame.mixer.pre_init()。具有向后兼容性，参数值0将替换为启动默认值。

Changed in pygame 1.8:：默认缓冲区大小从1024更改为3072。The default buffersize was changed from 1024 to 3072.

Changed in pygame 1.9.1：默认缓冲区大小从3072更改为4096。

Changed in pygame 2.0.0：默认缓冲区大小从4096更改为512。默认频率从22050更改为44100。

`pygame.mixer.quit`()

功能：取消混音器初始化

属性：quit() -> None

将取消初始化pygame.mixer。如果稍后重新初始化混音器，则所有播放都将停止，并且任何加载的声音对象可能与混音器不兼容。

`pygame.mixer.get_init`()

功能：测试混音器是否初始化

属性：get_init() -> (frequency, format, channels)

如果混音器已初始化，则返回正在使用的播放参数。如果混音器尚未初始化，则返回None。

`pygame.mixer.stop`()

功能：停止播放所有声道

属性：stop() -> None

`pygame.mixer.pause`()

功能：暂时停止所有声道的播放

属性：pause() -> None

稍后可以使用 pygame.mixer.unpause()恢复播放。

`pygame.mixer.unpause`()

功能：恢复暂停的声道播放

属性：unpause() -> None

`pygame.mixer.fadeout`()

功能：停止前将所有声音的音量淡出

属性：fadeout(time) -> None

将在时间参数（毫秒）中淡出所有活声道通道上的音量。静音后，播放将停止。

`pygame.mixer.set_num_channels`()

功能：设置播放频道总数

属性：set_num_channels(count) -> None

设置混音器的可用频道数。默认值为8。该值可以增加或减少。如果该值减小，则在缩减的频道上播放的声音将停止。

`pygame.mixer.get_num_channels`()

功能：获取当前活动的播放频道的总数【返回值】

属性：get_num_channels() -> count

`pygame.mixer.set_reserved`()

功能：预约自动使用的频道

属性：set_reserved(count) -> None

混音器可以预约任意数量的声道，这些声道不会自动选择以供声音播放。如果当前正在预约频道上播放声音，则不会停止。这允许应用程序为重要声音预约特定数量的频道，以保证这些声音不能被丢弃或有频道可供播放。

`pygame.mixer.find_channel`()

功能：查找未使用的频道

属性：find_channel(force=False) -> Channel

这将查找并返回一个不活动的通道对象。如果没有函数将返回 None。如果没有不活动的通道并且force参数为 True，则会找到运行声音最长的通道并返回该通道。
如果混音器已由 pygame.mixer.set_reserved()留了一些频道，则这些频道将不会在此处返回。

`pygame.mixer.get_busy`()

功能：测试混音器是否运行

属性：get_busy() -> bool

如果混音器任何频道运行，则返回True。如果混音器空闲，则返回 False。

`pygame.mixer.get_sdl_mixer_version`()

功能：获取混音器的SDL版本

属性：

get_sdl_mixer_version() -> (major, minor, patch)
get_sdl_mixer_version(linked=True) -> (major, minor, patch)

参数：linked (bool) -- 如果为 True（默认值），则返回链接的版本号，否则返回编译的版本号。

返回值(tuple)：混音器的SDL库版本号（根据linked参数选择是链接或编译）为3个整数的元组(major, minor, patch)

注意：链接的和编译的版本号应该相同。

New in pygame 2.0.0.

`pygame.mixer.Sound`

功能：从文件或缓冲区对象中创建新的声音（Sound）对象

属性：

Sound(filename) -> Sound
Sound(file=filename) -> Sound
Sound(buffer) -> Sound
Sound(buffer=buffer) -> Sound
Sound(object) -> Sound
Sound(file=object) -> Sound
Sound(array=object) -> Sound

从文件名、python文件对象或可读缓冲区对象加载一个新的声音缓冲。执行有限的重新采样可以帮助样本匹配混音器的初始化参数。Unicode字符串只能表示文件路径名。Python2.x字符串或Python3.x字节对象可以表示路径名或缓冲区对象。需要使用 'file' 或 'buffer' 关键字以避免歧义，否则Sound可能会猜错。如果使用了array关键字（首先检查该对象的缓冲区接口），则该对象将导出一个版本3、C级的数组接口或者导出一个新的缓冲区接口【对于Python 2.6或更高版本】。
声音对象表示了实际的声音采样数据。更改声音对象状态的方法将更改声音播放的所有实例。声音对象还导出一个数组接口和一个新的缓冲区接口【对于Python2.6或更高版本】。
声音可以从OGG音频文件或未压缩WAV未见加载。
缓冲区（buffer）将在内部复制，它与声音对象之间不会共享任何数据。目前由于数值数组，缓冲区和数组支持 sndarray.make_sound ，因此采样忽略符号和字节顺序。但是如果不正确处理符号和字节顺序，在不同的情况下可能会引发异常。此外，源样本会被截断以适应音频样本大小。

New in pygame 1.8：pygame.mixer.Sound(buffer)

New in pygame 1.9.2：pygame.mixer.Sound 关键字参数和数组接口支持

`pygame.mixer.Sound.play`()

功能：开始播放声音

属性：play(loops=0, maxtime=0, fade_ms=0) -> Channel

开始在可用频道（例如，计算机扬声器上）上播放声音。此方法将强制选择一个频道，因此播放可能会在必要时切断当前播放的声音。
loops参数控制样本在第一次播放后重复的次数。值5表示声音将播放一次，然后重复5次，因此总共播放6次。默认值（零）表示声音不重复，因此只播放一次。如果loops设置为-1，声音将无限循环（仍然可以调用stop()来停止）。
maxtime参数可控制在给定毫秒数后停止播放。
fade_ms参数将使声音在给定时间内以0音量开始播放，并逐渐增加满音量。声音对象可能在完成淡入之前结束。
此方法将返回所选通道的通道对象。

`pygame.mixer.Sound.stop`()

功能：停止在任何活动频道上播放此声音

属性：stop() -> None

`pygame.mixer.Sound.fadeout`()

功能：淡出后停止播放声音

属性：fadeout(time) -> None

将在时间参数（毫秒）内淡出声音后停止播放。所有正在播放频道上的此声音都将减弱并停止。

`pygame.mixer.Sound.set_volume`()

功能：设置此声音的播放音量

属性：set_volume(value) -> None

设置此声音的播放音量（响度）。如果正在播放，这将立即影响声音。也会影响到以后播放的任何声音。

参数：value (float) -- 0.0到1.0（含）范围内的音量。如果值小于0.0，则不会更改音量；如果值大于1.0，则音量将设置为1.0。

`pygame.mixer.Sound.get_volume`()

功能：获取播放音量

属性：get_volume() -> value

返回一个从0.0到1.0的值，表示此声音的音量。

`pygame.mixer.Sound.get_num_channels`()

功能：计算此声音正在播放的频道数【返回值】

属性：get_num_channels() -> count

`pygame.mixer.Sound.get_length`()

功能：获取声音的长度【返回值（秒）】

属性：get_length() -> seconds

`pygame.mixer.Sound.get_raw`()

功能：获取声音样本的bytestring副本

属性：get_raw() -> bytes

以字节（对于Python3.x）或字符串对象（对于Python2.x）的形式返回一个声音对象缓冲区的副本。

New in pygame 1.9.2.

`pygame.mixer.Channel`

功能：创建一个用于控制播放的通道（Channel）对象

属性：Channel(id) -> Channel

返回一个当前通道的通道对象。id必须是从0到pygame.mixer.get_num_channels()的值。
通道对象可用于对声音的回放进行精细控制。一个频道一次只能播放一个声音对象。使用通道是完全可选的，因为pygame可以在默认情况下管理它们。

`pygame.mixer.Channel.play`()

功能：在特定频道播放声音

属性：play(Sound, loops=0, maxtime=0, fade_ms=0) -> None

这将开始在特定频道上播放声音。如果频道当前正在播放任何其他声音，则会停止播放。
循环（loops）参数的含义与Sound.play()中一致：第一次重复声音的次数。如果是3，声音将播放4次（第一次，然后再播放3次）。如果循环为-1，则播放将无限期重复。
类似Sound.play()，maxtime参数可用于在给定毫秒数后停止播放声音。
类似Sound.play()，fade_ms参数可以在声音中使用淡出。

`pygame.mixer.Channel.stop`()

功能：停止频道上的声音播放

属性：stop() -> None

停止播放后，频道可供播放新声音。

`pygame.mixer.Channel.pause`()

功能：暂时停止在频道上播放声音

属性：pause() -> None

以后可以使用Channel.unpause()恢复播放。

`pygame.mixer.Channel.unpause`()

功能：在暂停的频道上继续播放

属性：unpause() -> None

`pygame.mixer.Channel.fadeout`()

功能：淡出频道后停止播放

属性：fadeout(time) -> None

在给定时间参数（毫秒）内淡出声音后停止播放频道。

`pygame.mixer.Channel.set_volume`()

功能：设置播放频道的音量

属性：

set_volume(value) -> None
set_volume(left, right) -> None

设置播放声音的音量（响度）。当一个频道开始播放时，它的音量值被重置。因此此方法只影响当前声音。value参数介于0.0和1.0之间。
如果只传递一个参数，它将是两个扬声器的音量。如果传递了两个参数并且混音器处于立体声（stereo）模式，则第一个参数将是左扬声器的音量，第二个参数将是右扬声器的音量。（如果第二个参数为 None，则第一个参数将是两个扬声器的音量。）

如果频道播放的声音上还调用了sound.set_volume()，则将同时考虑这两个调用。例如：

sound = pygame.mixer.Sound("s.wav")
channel = s.play()      # Sound plays at full volume by default
sound.set_volume(0.9)   # Now plays at 90% of full volume.
sound.set_volume(0.6)   # Now plays at 60% (previous value replaced).
channel.set_volume(0.5) # Now plays at 30% (0.6 * 0.5).

`pygame.mixer.Channel.get_volume`()

功能：获取播放频道的音量

属性：get_volume() -> value

返回当前播放声音的频道音量。这不考虑由Channel.set_volume()设置的立体声分离的情况，声音对象仍有与声道混合在一起的自己的音量。

`pygame.mixer.Channel.get_busy`()

功能：检查通道是否激活

属性：get_busy() -> bool

如果通道正在进行声音混合，则返回 True。如果通道空闲，则返回 False。

`pygame.mixer.Channel.get_sound`()

功能：获取当前播放的声音

属性：get_sound() -> Sound

返回当前在此频道上播放的实际声音对象。如果通道空闲，则返回 None。

`pygame.mixer.Channel.queue`()

功能：将声音对象排队以跟随当前

属性：queue(Sound) -> None

当声音在频道上排队时，它将在当前声音结束后立即开始播放。每个通道一次只能有一个声音排队。仅当当前播放自动完成时，才会播放排队的声音。可以与其他Channel.stop() 或 Channel.play()调用关联。
如果频道上没有正在播放的声音，则该声音将立即开始播放。

`pygame.mixer.Channel.get_queue`()

功能：返回任何正排队的声音

属性：get_queue() -> Sound

如果一个声音已经在这个频道上排队，它将被返回。一旦队列中的声音开始播放，它将不再在队列中。

`pygame.mixer.Channel.set_endevent`()

功能：播放停止时让频道发送事件

属性：

set_endevent() -> None
set_endevent(type) -> None

当一个频道设置了endevent时，它将在每次声音在该频道上播放完时（不仅仅是第一次）向pygame队列发送一个事件。一旦发送endevent，就使用 pygame.event.get() 索回。
注意如果调用Sound.play(n) 或Channel.play(sound,n)，end event只发送一次：在声音播放“n+1”次之后（参见Sound.play详细文档)。
如果当声音仍在播放时调用了Channel.stop() 或 Channel.play()，事件将立即发布。
类型参数将是发送到队列的事件id。这可以是任何有效的事件类型，但一个最好是选择pygame.locals.USEREVENT和pygame.locals.NUMEVENTS二者之一。如果未给出类型参数，则通道将停止发送endevents。

`pygame.mixer.Channel.get_endevent`()

功能：获取播放停止时频道发送的事件

属性：get_endevent() -> type

返回每次频道完成声音播放时要发送的事件类型。如果没有endevent，则函数返回pygame.NOEVENT。

`pygame.mixer.music`

`pygame.mixer.music.load`()

功能：加载音乐文件以便播放

属性：

load(filename) -> None
load(object) -> None

加载音乐文件名/文件对象并准备播放。如果音乐流已在播放，则将停止播放。但不会开始播放音乐。

`pygame.mixer.music.unload`()

功能：卸载当前加载的音乐以释放资源

属性：unload() -> None

New in pygame 2.0.0.

`pygame.mixer.music.play`()

功能：开始播放音乐流

属性：play(loops=0, start=0.0, fade_ms = 0) -> None

播放加载的音乐流。如果音乐已经播放，它将重新启动。

参数：

loops (int) -- （可选）重复音乐的次数。设置为5将播放五次音乐。设为-1可使音乐不确定地重复。
start (float) -- （可选）音乐开始播放的位置。起始位置取决于播放的音乐格式：MP3和OGG使用该位置为时间（秒）。对于MOD music，它是模式顺序号。如果无法设置起始位置，则传递起始位置将引发NotImplementedError。
fade_ms (int) -- （可选）使音乐在给定时间内开始以0音量播放并淡入到最大音量。片段可能在淡入完成之前结束。在PyGame2.0中添加。

`pygame.mixer.music.rewind`()

功能：重新启动当前音乐

属性：rewind() -> None

`pygame.mixer.music.stop`()

功能：停止音乐播放

属性：stop() -> None

如果当前正在播放音乐，则停止播放。不会卸载音乐。

`pygame.mixer.music.pause`()

功能：暂时停止音乐播放

属性：pause() -> None

暂时停止播放音乐流。可以用pygame.mixer.music.unpause()函数恢复播放。

`pygame.mixer.music.unpause`()

功能：继续播放暂停的音乐

属性：unpause() -> None

`pygame.mixer.music.fadeout`()

功能：淡出后停止播放当前音乐

属性：fadeout(time) -> None

此功能将一直阻塞，直到音乐淡出。在此期间，对 fadeout()和set_volume()的调用将无效。如果使用set_endevent()设置了事件，则在音乐淡出后将调用该事件。

参数：time (int) -- 音乐音量在停止前淡出的时间（毫秒）。

`pygame.mixer.music.set_volume`()

功能：设置音乐音量

属性：set_volume(volume) -> None

参数：volume (float) -- 参数值应介于0.0和1.0之间。重新加载音乐时，音量将重置为满音量。

`pygame.mixer.music.get_volume`()

功能：获取音乐音量

属性：get_volume() -> value

返回混音器的当前音量。该值将介于0.0和1.0之间。

`pygame.mixer.music.get_busy`()

功能：检查音乐流是否正在播放

属性：get_busy() -> bool

当音乐流正在播放时返回True。当音乐空闲时，返回False。即使音乐暂停，它也会返回True。

`pygame.mixer.music.set_pos`()

功能：设置播放位置

属性：set_pos(pos) -> None

这将设置音乐文件中开始播放的位置。“pos”的意思是一个浮点数（或一个可以转换成浮点数的数字），取决于音乐格式。

对于MOD文件，pos是模块中的整数模式号。对于OGG，它是从声音开始的绝对位置，以秒为单位。对于MP3文件，它是相对于当前位置的相对位置（秒）。要在MP3文件中进行绝对定位，请首先调用rewind()。
不支持其他文件格式。较新版本的SDL_mixer比早期版本具有更好的定位支持。如果特定格式不支持定位，则会引发SDLError。
函数set_pos()调用带下划线的SDL_mixer函数 Mix_SetMusicPosition。

New in pygame 1.9.2.

`pygame.mixer.music.get_pos`()

功能：获得音乐播放时间

属性：get_pos() -> time

获取音乐播放的毫秒数。返回的时间仅表示音乐已播放的时间，不考虑任何起始位置偏移。

`pygame.mixer.music.queue`()

功能：将声音文件排队以跟踪当前文件

属性：queue(filename) -> None

这将加载一个声音文件并将其排队。当前声音自然结束后，排队的声音文件将立即开始。一次只能排队一个声音。在另一个声音排队时对新声音排队将导致新声音成为正在排队声音。此外，如果当前声音被停止或更改，排队的声音将丢失。以下示例将播放巴赫的音乐六次，然后播放莫扎特的音乐一次：

pygame.mixer.music.load('bach.ogg')
pygame.mixer.music.play(5)        # Plays six times, not five!
pygame.mixer.music.queue('mozart.ogg')

`pygame.mixer.music.set_endevent`()

功能：播放停止时让音乐发送事件

属性：

set_endevent() -> None
set_endevent(type) -> None

这将导致pygame在音乐播放完毕时发出信号（通过事件队列）。参数决定将要加入队伍的事件类型。
每次音乐结束时，事件都会排队，而不仅仅是第一次。若要停止事件排队，请在不带参数的情况下调用此方法。

`pygame.mixer.music.get_endevent`()

功能：获取播放停止时频道发送的事件

属性：get_endevent() -> type

返回每次音乐播放结束时要发送的事件类型。如果没有，则函数返回 pygame.NOEVENT。

整理自：

Rita_Aloha

关注

11
点赞
踩
78

收藏

觉得还不错? 一键收藏
3
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫