美图秀秀api开发文档.docVIP

API说明 美图秀秀开放插件包含美图秀秀M1（完整版）、美图秀秀M2（美化图片）、及美图秀秀M3（拼图），我们已经对三个版本进行整合，提供一致的接口供您调用。 1、环境配置 1.1、设置crossdomain.xml 下载crossdomain.xml文件，把解压出来的crossdomain.xml文件放在您保存图片或图片来源的服务器根目录下，比如： ，那么crossdomain.xml的路径为：/crossdomain.xml。需要注意的是crossdomain.xml必须部署于站点根目录下才有效， crossdomain.xml的目前是授权来自美图域下的flash向您的站点上传图片或者从您的站点加载图片。【备注】由于本地测试会被flash安全沙箱拦住，请自行搭建web服务器，在web 环境中测试。 1.2、调用方法 1.2.1、引用JS代码 在你的网页代码head标签里或者body标签里加入代码。 script src=/sources/xiuxiu.js type=text/javascript/script 1.2.2、初始化xiuxiu xiuxiu是所有API的顶级命名空间，API的调用书写形式均为：xiuxiu.xxx(arg1,arg2,...)调用API时，为保证flash初始化完成，请务必使用以下语法来调用API： xiuxiu.onInit = function () { // your code here } 2、API列表 2.1、方法 2.1.1、 加载SWF（xiuxiu.embedSWF） 功能描述：网页中嵌入美图秀秀的编辑器语法： xiuxiu.embedSWF(container,editorType,width,height,id); 参数 必选 字段类型 说明 container 是 string 嵌套flash的容器 editorType 否 int 编辑器类型（1为轻量编辑，2为轻量拼图，3为完整版，默认值1） width 否 string 编辑器宽度（可以为数字或者百分比，对轻量编辑和完整版有效） height 否 string 编辑器高度（可以为数字或者百分比，对轻量编辑和完整版有效） id 否 string 编辑器在页面中的id，默认值为” xiuxiuEditor”（当需要在同一个页面内嵌入一个以上编辑器时需要以不同的id来区分，这时候就很有用，在接下去的几个接口中便可通过不同的id调用不同编辑器的接口） 示例代码 xiuxiu.embedSWF(altContent, 3, 800, 100%,lite); 2.1.2、 加载图片（xiuxiu.loadPhoto） 功能描述：编辑器载入图片语法： xiuxiu.loadPhoto(images,base64,id); 参数 必选 字段类型 说明 images 是 string或者array 在编辑器中载入图片，类型可以为字符串或数组，也就是说可以同时载入一张到多张图片（需要注意的是，1.如果是数组，数组中元素必须是同一类型图片，要么都是base64类型的，要么是url；2.如果是base64图片，需要去掉几个头字符，只保留纯图片数据，例如去掉” data:image/jpeg;base64,”） base64 否 boolean 是否是base64图片，默认值为false id 否 string 编辑器在页面中的id，默认值为” xiuxiuEditor” 示例代码 单张图片： xiuxiu.loadPhoto(/sources/images/1.jpg); 单张base64的图片： xiuxiu.loadPhoto(/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja…, true); 多张图片： xiuxiu.loadPhoto([/sources/images/1.jpg]); 多张base64的图片： xiuxiu.loadPhoto([/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja…], true); 2.1.3、上传URL（xiuxiu.setUploadURL） 功能描述：设置上传接口地址，接收图片的地址语法： xiuxiu.setUploadURL (url,id); 参数 必选 字段类型 说明 url 是 string 设置上传接口地址（必须为绝对路径） id 否 string 编辑器在页面中的id，默认值为” xiuxiuEditor” 示例代码 xiuxiu.setUploadURL(/image_upload.php); //修改为您自己的上传接收图片程序 2.1.4、设置参数（xiuxi