旗舰版平台开发API文档.DOC

组件开发API说明文档 概览 通过此文档，可以开发一个第三方的节目组件加入到系统中，扩展系统的功能。 开发流程 创建必须的文件→配置组件属性→开发功能及外观→打包组件→上传组件→组件测试 组件所需文件 组件所需文件 文件名 重要性 说明 Manifest.xml 必须 组件配置 logo.png 必须 组件图片,文件名可自定义,用以在管理端中显示 index.html 必须 组件默认加载页面，制作节目时加载 其它文件 可选 资源文件、css、javascript、html等，根据需要添加 Manifest.xml 文件说明 属性名称 重要性 要求 说明 id 必须 字母和数字的组合 组件ID、标识 name 必须 名称 节目编辑器中显示 description 必须 说明 组件管理中显示 icon 必须 相对路径 组件图片路径 width 必须 数字+px 组件弹出后的宽度 height 必须 数字+px 组件弹出后的高度 ver 必须 示例:2.0.3.1 版本号 builddate 必须 日期格式 最后修改时间 enable 必须 true 或者 false 是否启用 dataurl 可选 组件ID.xml(可为URL) 数据源地址,没有请留空 调用方式 用户确认插入组件到编辑器，在窗体之前执行javascript代码 window.returnValue = JSON; windows.close(); 返回的JSON对象说明 属性名称 类型 说明 js 数组 javascript文件路径集合 css 数组 Css文件路径集合 html 字符串 返回到节目制作组件html代码 注意事项 1.返回的html代码顶层元素请用组件Id标记属性 table id=组件id/table 元素Id/name class的name 样式和javascript的文件名 请用组件ID作为前缀以免和其它的组件冲突 2.顶层元素的加入样式position：absolute 3.顶层元素加入属性plugin=组件id 4.JSON返回的html代码为最终显示效果 5.由于服务器端和播放端节目文件组织方式的差异，载入数据源的路径需要做一次修正判断，如： xml.load(manifest.xml); //播放端路径修复 if (xml.parseError.errorCode != 0) xml.load(./plugins/demo/manifest.xml); 组件上传 1.把组件文件夹压缩成压缩包 压缩包中包含demo文件夹(demo是组件的id)demo文件夹中是组件的必要文件和开发者定义文件 2.登录管理端-系统设置-组件管理，上传组件  上传成功后，组件管理中会多出一个组件,有数据源的组件请先配置数据源  ` 七、组件测试 组件上传成功并启用，在节目制作中可以看到该组件 插入组件到场景中，生成节目发布到终端看效果是否正确 2012年1月10日