编辑“Gallery:模块:getid3”

=Getid3模块=
显示mp3文件（艺术家，专辑名等）的嵌入元数据。

==描述==
编写者：Don Willingham.
::[http://getid3.sourceforge.net/ getid3()]为[mailto:info@getid3.org James Heinrich]所编写。

显示mp3文件（艺术家，专辑名等）的嵌入元数据，还包括视频文件和某些归档（zip）格式文件。Gallery2中附带的getid3模块不支持视频或归档文件，因为这会造成下载的尺寸过大。如果你希望添加视频和归档文件或其他格式的支持的话，就必须modules/getid3/libs/中添加合适的getid3模块（又上面的链接获取原始的getid3库）。

==特点==
* 从音频，视频和归档文件中解压出ID3和其他元数据标记。详细信息请见：[http://getid3.sourceforge.net/ getid3()]
* 向你的相片页面添加''getid3''区块以显示G2中某页面上某项目相关的ID3信息。

==用法==
*如有必要的话，从下载页面进行模块下载。最小化和典型的G2整合包不包括此模块。
*在''站点管理（Site Admin）'' -> ''插件（Plugins）''中安装并激活该模块。
*在''站点管理（site admin）'' -> ''外观主题（themes）'' -> ''matrix''（或其他活动或正在使用的外观主题）中，'''添加getid3区块'''至你的相片页面。
* 向你的G2添加一些mp3文件（或其他被支持的文件）并浏览G2中对应的项目页面来查看相关的ID3数据。

==被请求的特点==
目前尚无有关该模块的特点请求。
==Bug==
此模块目前无法再Microsoft Windows服务器上运行。

== 文件类型/支持的元数据==
* audio/mp3
** Artist
** Album
** Track
** Title
** Bit Rate
** Bit Rate Mode

== 备忘 ==
* 优先级
** test/data最大不应超过50K。
*** 在57K isotest.iso添加前，目录低于50K。第一次尝试超过300K。
** lib/getid3不应含有*任何*非必要的文件，
*** 即所含所有文件都应必要。
*** 某些类似archive.rar和audio.mod inc的文件只是占位符而已。
*** 图形及数据库缓冲没有必要，除非是tiff格式的。
** 除非我们很确信文件中有我们要检索的数据，否则不应呼叫getid3。
*** 这与单位mime类型的属性配置密不可分。（见后文）
* 归档类型
** 限制同时显示的文件数量，并允许用户进行分页（比如一次25页）。
** 显示更多的归档文件数据，比如datestamp。
* 操作
** 实现'dimensions'
** 实现'dimensions-and-duration'
* 单位mime类型的属性配置？
** 对于Audio-only类型，Audio Bit Rate应为Bit Rate。
** Wave文件不需要像mp3文件所需要那么多的元数据。
** 归档具有迥异的信息，音频和/或视频类型。
** 如果mime类型无任何属性配置的话，请不要呼叫getid3。
** 信息区块的标题应为Audio，Audio/Video或Archive Properties。
* 按如起始时间戳一样的track号进行排序。
* 解压提取id3v2 art并将其作为缩略图使用。（如果可以的话）
* 将"不被支持的"文件重新放回到
** modules.archive.szip
** module.archive.rar （如果/当实现时，目前还是占位符）
** write.* （如果我们决定要为该gallery功能提供访问的话）
** module.misc.exe
** module.graphic.* （可能做过一次单元测试）
** modules.audio.（aac，ac3，au，avr，bonk，la，lpac，midi，mod，monkey，mpc，optimfrog，rkau，shorten，tta，voc，vqf）
** modules.audio-video.（asf，bink，matroska，mpeg，nsv，real，swf）

== 开发注释 ==
Getid3需要做些微修改才可以通过单元测试。某些getid3模块被忽略了，因为我们不会对它们做单元测试。目前使用的是1.7.5版本（发布于2005年12月29日），而且无需单独下载和/或安装。Getid3支持的远比mp3文件的ID3更多，它还支持其他格式的音频文件，比如ogg，flac和wave；同时也支持如MOV和AVI格式的视频文件；还包括iso，tar和zip格式的归档文件。

[[Category:Gallery 2:Modules]]