Pygame的多媒体
end

Pygame的多媒体

1. 音乐

要在游戏中播放背景音乐，可以使用pygame.mixer.music模块。

使用
```
pygame.init()
```
进行全部模块的初始化，或者只初始化音频部分：
```
pygame.mixer.init()
```
使用文件名作为参数载入音乐
```
pygame.mixer.music.load('/usr/share/example-content/ubuntu Sax.ogg')
```
音乐可以是ogg、mp3等格式。载入的音乐不会全部放到内容中，而是以流的形式播放的，即在播放的时候才会一点点从文件中读取。
使用
```
pygame.mixer.music.play();
```
播放载入的音乐。该函数立即返回，音乐播放在后台进行。play方法还可以使用两个参数
```
pygame.mixer.music.play(loops=0, start=0.0)
```
loops和start分别代表重复的次数和开始播放的位置。
播放到一半可以使用
```
pygame.mixer.music.stop()
```
停止播放，还可以用
```
pygame.mixer.music.pause()
```
暂停播放。暂停播放的音乐可以用
```
pygame.mixer.music.unpause()
```
来继续播放。使用
```
pygame.mixer.music.fadeout(time)
```
来进行淡出，在time毫秒的时间内音量由初始值渐变为0，最后停止播放。
可以用
```
pygame.mixer.music.set_volume(value)
```
来设置播放的音量，音量value的范围为0.0到1.0。
要判断是否在播放音乐，可以使用
```
pygame.mixer.music.get_busy()
```
，返回1为正在播放。在音乐播放完成时，可以用事件的方式通知用户程序。使用
```
pygame.mixer.music.set_endevent(pygame.USEREVENT + 1)
```
，来设置当音乐播放完成时发送pygame.USEREVENT+1事件给用户程序。当前正有音乐在播放时，可以使用
```
pygame.mixer.music.queue(filename)
```
来指定下一个要播放的音乐文件，当前的音乐播放完成后自动开始播放指定的下一个。一次只能指定一个等待播放的音乐文件。

注意：同时只能播放一个音乐文件。音乐文件可以很大，系统以流的形式播放。

2. 音效

要在游戏中播放碰撞、爆炸、语音等音效，需要使用pygame.mixer模块。这个模块支持同时播放多个音效文件，多个文件在多个不同的通道Channel中播放，一个通道一次只能播放一个音效文件。

使用
```
pygame.init()
```
进行全部模块初始化，或者只初始化音频部分
```
pygame.mixer.init()
```
可以这样查看总共有多少个通道
```
pygame.mixer.get_num_channels()
```
可以使用
```
channel = pygame.mixer.Channel(i)
```
取得第i个通道。或者使用
```
channel = pygame.mixer.find_channel()
```
自动取得一个空闲的通道（没有音效正在播放的通道）。
使用
```
sound = pygame.mixer.Sound('/usr/share/sounds/KDE_Startup_2.ogg)
```
指定文件名载入一个音频文件，并创建一个Sound对象。音频文件可以是wav,ogg等格式。音频文件的内容会被全部载入到内存中。
使用
```
channel.play(sound)
```
在一个通道中播放一个音效。或者使用
```
sound.play()
```
自动找一个空闲的通道播放音效。
正在播放的音效可以使用
```
sound.stop()
```
停止音效sound的播放。或者用
```
channel.stop()
```
停止在通道channel中播放的音效。正在播放音效的通道还可以用
```
channel.pause()
```
暂停通道中的音效。暂停的音效还可以用
```
channel.unpause()
```
继续播放。使用
```
channel.fadeout(time)
```
来进行淡出，在time毫秒的时间内音量由初始值渐变为0，最后停止播放。
对于一个通道可以用
```
channel.get_busy()
```
检查它是否正在播放音效。当一个通道中的音效播放完成时，可以通过事件通知给用户程序。使用
```
channel.set_endevent(pygame.USEREVENT + 1)
```
来设置当音乐播放完成时发送pygame.USEREVENT+1事件给用户程序。使用
```
channel.queue(sound) 
```
为正在播放音效的通道指定下一个要播放的音效。当前的音效播放完成后，下一个音效会自动播放。一个通道只能有一个等待播放的音效。
使用
```
channel.set_volume(value)
```
来设置通道中播放的音效的音量。使用
```
sound.set_volume(value)
```
来设置单个音效的音量。两者的取值范围都是0.0到1.0。音效播放的实际音量是通道音量和音效音量的乘积，比如通道音量0.5，音效音量0.6，则实际播放的音量为0.3。

注意：音效和音乐的区别是：音效要整个文件载入到Sound对象中才能播放，而音乐不用完全载入，而以流的方式播放。

3. 视频

要在游戏中播放片头动画、过场动画等视频画面，可以使用pygame.movie模块。

要播放视频中的音乐，pygame.movie模块需要对音频接口的完全控制，不能初始化mixer模块。因此要这样完成初始化
```
pygame.init()
pygame.mixer.quit()
```
或者只初始化
```
pygame.display.init()
```
用
```
movie = pygame.movie.Movie('filename')
```
指定文件名载入视频。视频的格式可以为mpeg1。视频文件不会马上全部载入内存，而是在播放的时候一点一点的载入内存。

用

movie.set_display(pygame.display.set_mode((640,480)))

指定播放的surface。

用
```
movie.set_volume(value)
```
指定播放的音量。音量的值value的取值范围为0.0到1.0。
用
```
movie.play()
```
播放视频。这个函数会立即返回，视频在后台播放。这个函数可以带一个参数loops，指定重复次数。
正在播放的视频可以用
```
movie.stop()
```
停止播放。还可以用
```
movie.pause()
```
暂停播放。可以使用
```
movie.skip(seconds)
```
使视频前进seconds秒钟。

注：在某些XWindow下，可能需要配置环境变量：

export SDL_VIDEO_YUV_HWACCEL=0

4. CD

如果要在游戏中用音频CD作为背景音乐，则需要用到pygame.cdrom模块。

用
```
pygame.cdrom.init()
```
初始化cdrom模块。
用
```
pygame.cdrom.get_count()
```
查看系统中的光驱数量。用
```
cd = pygame.cdrom.CD(id)
```
得到指定的光驱对象。id为光驱的编号。
用
```
cd.init()
```
对光驱对象进行初始化。光驱对象必须先初始化才能够使用。
用
```
cd.get_numtracks()
```
查看光驱里的光盘上有多少条音轨。用
```
cd.get_track_length(track)
```
可以获得指定音轨的时间长度。指定音轨的编号从0开始。
用
```
cd.play(track)
```
播放光盘上指定编号的音轨。音轨从0开始编号。用
```
cd.stop()
```
停止播放。用
```
cd.pause()
```
暂停播放。暂停的音轨用
```
cd.resume()
```
继续播放。
用
```
cd.get_current()
```
得到当前正在播放的音轨。用
```
cd.get_busy()
```
判断光盘是否正在播放。
用
```
cd.eject()
```
来弹出光盘。

Pygame的多媒体

Pygame的多媒体

1. 音乐

2. 音效

3. 视频

4. CD

end