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列表文件的例子