pygame.cdrom

pygame module for audio cdrom control

pygame.cdrom.init	—	initialize the cdrom module
pygame.cdrom.quit	—	uninitialize the cdrom module
pygame.cdrom.get_init	—	true if the cdrom module is initialized
pygame.cdrom.get_count	—	number of cd drives on the system
pygame.cdrom.CD	—	class to manage a cdrom drive

警告

这个模块在pyGame 2.0及以上版本中是不起作用的，除非您已经用SDL1手动编译了pyGame。以后将不再支持此模块。可以使用的一种替代方法是 pycdio 。

CDROM模块管理 CD 和 DVD 电脑上的硬盘。它还可以控制音频CD的播放。此模块需要先初始化，然后才能执行任何操作。每个 CD 您创建的对象代表CDROM驱动器，在它可以执行大多数操作之前，还必须单独进行初始化。

pygame.cdrom.init()

initialize the cdrom module

init() -> None

初始化CDROM模块。这将扫描系统中的所有 CD 设备。在执行任何其他功能之前，必须先初始化该模块。当您调用 pygame.init() 。

多次调用此函数是安全的。

pygame.cdrom.quit()

uninitialize the cdrom module

quit() -> None

取消初始化CDROM模块。在您将其称为任何现有的 CD 对象将不再起作用。

多次调用此函数是安全的。

pygame.cdrom.get_init()

true if the cdrom module is initialized

get_init() -> bool

测试CDROM模块是否已初始化。这不同于 CD.init() 因为每个驱动器也必须单独初始化。

pygame.cdrom.get_count()

number of cd drives on the system

get_count() -> count

返回系统上的光驱数量。当您创建 CD 对象，则需要传递的整数id必须小于此计数。如果系统上没有驱动器，则计数将为0。

pygame.cdrom.CD

class to manage a cdrom drive

CD(id) -> CD

pygame.cdrom.CD.init	—	initialize a cdrom drive for use
pygame.cdrom.CD.quit	—	uninitialize a cdrom drive for use
pygame.cdrom.CD.get_init	—	true if this cd device initialized
pygame.cdrom.CD.play	—	start playing audio
pygame.cdrom.CD.stop	—	stop audio playback
pygame.cdrom.CD.pause	—	temporarily stop audio playback
pygame.cdrom.CD.resume	—	unpause audio playback
pygame.cdrom.CD.eject	—	eject or open the cdrom drive
pygame.cdrom.CD.get_id	—	the index of the cdrom drive
pygame.cdrom.CD.get_name	—	the system name of the cdrom drive
pygame.cdrom.CD.get_busy	—	true if the drive is playing audio
pygame.cdrom.CD.get_paused	—	true if the drive is paused
pygame.cdrom.CD.get_current	—	the current audio playback position
pygame.cdrom.CD.get_empty	—	False if a cdrom is in the drive
pygame.cdrom.CD.get_numtracks	—	the number of tracks on the cdrom
pygame.cdrom.CD.get_track_audio	—	true if the cdrom track has audio data
pygame.cdrom.CD.get_all	—	get all track information
pygame.cdrom.CD.get_track_start	—	start time of a cdrom track
pygame.cdrom.CD.get_track_length	—	length of a cdrom track

您可以创建一个 CD 对象，用于系统上的每个CDROM。使用 pygame.cdrom.get_count() 以确定实际存在的驱动器数量。Id参数是驱动器的一个整数，从零开始。

这个 CD 对象未初始化，您只能调用 CD.get_id() 和 CD.get_name() 在未初始化的驱动器上。

创建多个 CD 对象，则它们都将正常协作。

init()

initialize a cdrom drive for use

init() -> None

初始化CDROM驱动器以供使用。驱动器必须在大多数情况下进行初始化 CD 工作方法。即使pyGame的其余部分已经初始化。

驱动器初始化时可能会有短暂的停顿。避免 CD.init() 如果程序不应该停止一到两秒钟。

quit()

uninitialize a cdrom drive for use

quit() -> None

取消初始化驱动器以供使用。当您的程序在一段时间内不能访问驱动器时，调用此选项。

get_init()

true if this cd device initialized

get_init() -> bool

测试一下这是否 CDROM 设备已初始化。这不同于 pygame.cdrom.init() 因为每个驱动器也必须单独初始化。

play()

start playing audio

play(track, start=None, end=None) -> None

从光驱中的音频CDROM播放音频。除了曲目编号参数，您还可以传递播放的开始和结束时间。开始和结束时间以秒为单位，可以限制播放的音轨部分。

如果过了开始时间但没有结束，音频将播放到曲目的结尾。如果您传递的是开始时间，而结束时间为‘None’，则音频将播放到整个光盘的结尾。

请参阅 CD.get_numtracks() 和 CD.get_track_audio() 若要查找要播放的曲目，请执行以下操作。

请注意，磁道0是 CD 。曲目编号从零开始。

stop()

stop audio playback

stop() -> None

停止播放CDROM中的音频。这也将丢失当前的播放位置。如果驱动器尚未播放音频，则此方法不执行任何操作。

pause()

temporarily stop audio playback

pause() -> None

暂时停止上的音频播放 CD 。可以在相同的时间点使用 CD.resume() 方法。如果 CD 不是在玩这个方法什么都不做。

请注意，磁道0是 CD 。曲目编号从零开始。

resume()

unpause audio playback

resume() -> None

取消暂停暂停 CD 。如果 CD 未暂停或已在播放，则此方法不执行任何操作。

eject()

eject or open the cdrom drive

eject() -> None

这将打开光驱并弹出光驱。如果驱动器正在播放或暂停，它将被停止。

get_id()

the index of the cdrom drive

get_id() -> id

返回用于创建 CD 举个例子。此方法可以在未初始化的 CD 。

get_name()

the system name of the cdrom drive

get_name() -> name

返回驱动器的字符串名称。这是用于表示驱动器的系统名称。它通常是驱动器号或设备名称。此方法可以在未初始化的 CD 。

get_busy()

true if the drive is playing audio

get_busy() -> bool

如果驱动器忙于播放音频，则返回True。

get_paused()

true if the drive is paused

get_paused() -> bool

如果驱动器当前暂停，则返回True。

get_current()

the current audio playback position

get_current() -> track, seconds

返回当前曲目和该曲目的时间。当驱动器正在播放或暂停时，此方法起作用。

请注意，磁道0是 CD 。曲目编号从零开始。

get_empty()

False if a cdrom is in the drive

get_empty() -> bool

如果驱动器中当前有CDROM，则返回FALSE。如果驱动器为空，则返回True。

get_numtracks()

the number of tracks on the cdrom

get_numtracks() -> count

返回光驱中CDROM上的曲目数量。这将返回驱动器为空或没有磁道的零。

get_track_audio()

true if the cdrom track has audio data

get_track_audio(track) -> bool

确定CDROM上的曲目是否包含音频数据。您也可以拨打 CD.num_tracks() 和 CD.get_all() 以确定有关CDROM的更多信息。

请注意，磁道0是 CD 。曲目编号从零开始。

get_all()

get all track information

get_all() -> [(audio, start, end, length), ...]

返回一个列表，其中包含光盘上每首曲目的信息。该信息由一个具有四个值的元组组成。如果音轨包含音频数据，则音频值为True。开始、结束和长度值是以秒为单位的浮点数。开始和结束表示整个光盘上的绝对时间。

get_track_start()

start time of a cdrom track

get_track_start(track) -> seconds

返回CDROM曲目开始处的绝对时间(以秒为单位)。

请注意，磁道0是 CD 。曲目编号从零开始。

get_track_length()

length of a cdrom track

get_track_length(track) -> seconds

返回CDROM轨道长度的以秒为单位的浮点值。

请注意，磁道0是 CD 。曲目编号从零开始。

---

Edit on GitHub