编辑“Joomla/Advanced Flash Mp3 Player播放器模块用法”

{{joomla top}}
Advanced Flash Mp3 Player播放器是一个针对[[Joomla]]开发的标准模块。使用[[Flash]]作为面板，因此载入速度很快。该模块由Webmaster-Tips.net网站开发。界面如下图所示：

[[Image:Joomla mp3 player 1.jpg]]

==播放器简介==
该模块不仅支持播放站内mp3文件，也支持远程mp3歌曲播放。这是一个很重要的功能，意味着我们可以听到成千上万首歌曲，却不需要占用自己网站的空间。由于远程mp3播放从其它网站提取音频流，所以也不会增加自己网站的[[带宽]]占用。此播放器使用流媒体（stream）技术播放mp3，因此一旦载入1%左右就可以听到歌曲，访客无需等待整个歌曲缓冲完毕。

==前台访客的用法==
*点击播放器左下角"+" 按钮弹出专辑列表
*选中专辑后，歌曲会出现在"播放列表"区域
*点击专辑列表右上角叉叉关闭专辑列表面板
*在播放列表中选择一首歌曲，点击播放按钮
*5秒钟后——如果你还没有听到音乐，请检查你的音箱是否打开了

==播放器操作==
该模块安装后，在网站的modules目录中自动建立一个子目录叫作mod_a_player。我们下面所有的操作都在这个目录中完成，因此请不要进错了位置。

在mod_a_player目录中，albumdata.xml文件就是专辑定义文件，而test.xml、songlist1.xml 或者zhuzhu.xml（如果你安装了我汉化的版本就有这个文件），这些都是歌曲列表定义文件。每个[[xml]]文件对应一个专辑。你有多少个专辑，就需要多少个歌曲定义文件。

首先看看专辑列表文件的语法，如下图所示：

[[Image:Joomla mp3 player 2.jpg]]

请注意：如果你的网站使用[[utf-8]]编码，那么albumdata.xml文件及各个歌曲列表文件都必须保存为utf-8编码。

歌曲列表的文件名最好使用英文，以免出现麻烦。专辑名称可以定义为中文，前台访问时只能看到专辑名称，看不到歌曲列表文件的。你可以打开albumdata.xml这个文件（这个文件由播放器自动读取，千万不能修改文件名称！），添加你喜欢的专辑。前台专辑列表中的专辑排列次序，决定于此文件中该专辑所出现的位置。因此，你可以通过移动某个专辑在albumdata.xml文件中的位置来改变前台的显示次序。移动的时候注意完整移动整个<myPath></myPath>元素对。

==远程mp3文件的播放==
在mod_a_player目录中打开一个歌曲列表文件，比如上图中所展示的“猪猪最爱”专辑，其歌曲列表文件名为zhuzhu.xml。我们就打开这个文件，可以看到内容如下：

[[Image:Joomla mp3 player 3.jpg]]

很明显，这些歌曲不存在于“酣游天下-酣客网”，而是来自其它网站。这个文件的语法也很简单啊。上面的图中，每3行定义一首歌曲。mylabel属性定义歌曲名称，mydata属性定义远程歌曲的[[URL]]。

==站内mp3文件的播放==
有时候，我们确实需要播放自己站内的歌曲。比如会员上传的歌曲，比如在其它网站找不到的或者播放不流畅的歌曲，或者你可能存放一些mp3格式的讲课录音等。所有针对Advanced Flash Mp3 Player播放器的操作都在mod_a_player这个目录中完成。站内的mp3音乐也必须上传到这个目录。你如果通过[[FTP]][[软件]]进入该目录，会发现那里已经有一个test.mp3文件了。这是该模块作者赠送的测试音乐。

对于站内mp3的添加，可以在专辑列表文件albumdata.xml里面建立一个新条目，名称自己选吧。同时定义一个新的歌曲列表文件名。然后开始编写自己的歌曲列表文件（温馨提示：如果你实在记不住语法，就复制一份zhuzhu.xml 或者test.xml文件然后修改吧）。对于站内mp3音乐的添加语法是：
 <Index mylabel="邓丽君-又见炊烟" mydata="YouJianChuiYan.mp3"> </Index>
 <Index mylabel="金刚经mp3朗诵版" mydata="jgj.mp3"> </Index>

==参考来源==
http://www.joomlagate.com/article/joomla10-tutorial/use-advanced-flash-mp3-player-module-on-joomla/

{{Joomla 1.0}}

[[category:Joomla|A]]