CMP4使用手册 - 媒体列表【list.xml】

### CMP4列表格式说明

CMP4的列表文件是一个XML格式的树结构文件，用来设置所有要播放的音乐信息

列表文件路径由配置文件的lists参数来指定，如果不指定，则默认为：lists="list.xml"

##### 列表项属性：

label | 当前项的名称，目录名或音乐名，如果未指定则采用下面的src作为名称
src | 音乐地址源，必填项(目录可除外)，除了填写普通URL地址，还支持以下特殊协议： 1，javascript:协议，用于直接调用页面js，传递参数，如：javascript:alert(1) 2，proxy:协议，用于api接口加入的代理函数处理，格式如：proxy:代理函数名,代理函数参数
bak | src的备用地址，默认为空，一般不用，当第一次连接错误时，重试连接时将采用此设置

type

音乐类型，默认为空，将根据src中最后的文件后缀自动识别，支持：
1,MP3音频
2,FLV/MP4视频
3,WMP类型 需要浏览器结合WMP环境支持
4,flash 简单MovieClip播放支持，也包括图片jpg/png/gif
如果未指定，同时也无法用后缀识别，则采用全局配置中default_type参数指定的默认类型进行播放
详情见：http://bbs.cenfun.com/thread-11741-1-1.html

lrc | 歌词地址，默认为空，支持lrc格式歌词和kmc格式的卡拉OK歌词，如果这两种格式都不能识别，则当作文本显示，并支持简单html
duration | 总时间，如果无法获取音乐总时间，可在此指定，如某些视频，flash，图片等
bytes | 文件总字节数，专用于无keyframes关键信息时的stream模拟搜索
rotation | 设置视频旋转角度，默认0，用于某些倒立视频或者横向视频调整方向(如某些手机拍摄)，当然也可通过视频区右上角的旋转按钮来调整
opened | 设置目录项是否为打开状态，默认为空表示关闭状态，要设置打开则opened="1"
bg_video | 播放当前项时，视频区背景的设置，默认为空，和插件一样支持多属性传入 如：bg_video="{src:plugins/bigbg.swf,xywh:[0,0,100%,100%]}"
bg_lrc | 播放当前项时，歌词区背景的设置，默认为空，设置方法同上
xywh | 位置宽高参数，一般用于对背景的定义，一般不用
seekable | 表示播放时是否可以拖动进度条以尝试搜寻播放，默认true可以
scalemode | 当前项的缩放模式，默认为空，可用参数值同全局配置中的video_scalemode，但此处优先级高
stream | 是否为stream类视频，默认为空，可通过自动替换开始位置，播放非逐渐式下载视频，视频源需服务端支持 最新版CMP4已经支持根据src里是否含有{start_seconds}或{start_bytes}自动设置此参数
rtmp | rtmp服务器地址，用于播放实时流，配置此参数还需在src配置需播放的文件名
list_src | 子列表地址，用于当前目录的子级列表加载，不能含有子内容，如：<m label="子级列表" list_src="list.xml" />
image | 列表项缩略图地址，默认为空，需支持列表缩略图的皮肤方能加载显示
text | 当前项的文本描述，默认为空，需支持列表缩略图的皮肤方能加载显示，同时如果没有歌词加载，则显示到歌词窗口
文本样式属性 | 用于自定义当前项样式，实现多彩列表，支持文本样式的所有属性，如：color,size,bold,font等等 同皮肤中文本样式设置一样，填写1-2个值表示2种状态，如：color="#ff0000,#00ff00"
自定义属性 | 比如需要进行一些自动替换时，可以自定义一些属性，比如id,link等等

如果label或src存在于全局配置中，则将根据以上属性自动生成一个单曲项

###### 一个CMP4列表文件的例子

<list>
<m type="" src="music/test.mp3" lrc="" label="1,MP3音乐测试" />
<m type="" src="music/test.flv" lrc="" label="2,FLV视频测试" />
<m type="3" src="music/test.mp3" lrc="" label="3,WMP类型测试" />
<m type="" src="plugins/bigbg.swf" lrc="" scalemode="1" duration="10" label="4,Flash播放测试" />
<m type="" src="logo.png" lrc="" scalemode="1" duration="5" label="4,图片播放测试" />
<m list_src="list.xml" label="子列表" />
<m label="目录">
<m label="二级目录">
<m label="三级目录">
<m type="" src="music/test.mp3" lrc="" label="test" />
</m>
</m>
<m type="" src="music/test.mp3" lrc="" label="test" />
</m>
<m label="打开的目录" opened="1">
<m type="" src="music/test.mp3" lrc="" label="test" />
</m>
</list>