七牛公仔
之前在開發(fā)項(xiàng)目的過(guò)程中用到了七牛圖片上傳功能，支持拖拽上傳，在次整理一下筆記分享給大家，主要用到上傳下面的三個(gè)模塊和縮略圖功能。
功能簡(jiǎn)介：
-
上傳
-
html5 模式大于 4 M 時(shí)可分塊上傳，小于 4 M 時(shí)直傳
-
Flash、html4 模式直接上傳
-
繼承了 Plupload 的功能，可篩選文件上傳、拖曳上傳等
-
-
下載（公開資源）
-
數(shù)據(jù)處理（圖片）
-
imageView2（縮略圖）
imageMogr2（高級(jí)處理，包含縮放、裁剪、旋轉(zhuǎn)等）
imageInfo （獲取基本信息）
exif （獲取圖片 EXIF 信息）
watermark （文字、圖片水印）
pipeline （管道，可對(duì) imageView2、imageMogr2、watermark 進(jìn)行鏈?zhǔn)教幚恚?/em>
一、引入 Plupload
本 SDK 上傳功能基于Plupload插件封裝，所以需要下載Plupload，建議使用 2.1.1 ~ 2.1.9。您也可以訪問(wèn)開放靜態(tài)文件 CDN ，搜索 plupload ，使用 CDN 加速的靜態(tài)文件地址。
上傳
在頁(yè)面中引入 plupload，plupload.full.min.js（產(chǎn)品環(huán)境）或引入 plupload.dev.js 和 moxie.js（開發(fā)調(diào)試）
在頁(yè)面中引入 qiniu.min.js（生產(chǎn)環(huán)境）或 qiniu.js（開發(fā)調(diào)試）
初始化 uploader (請(qǐng)確保在執(zhí)行初始化時(shí)，頁(yè)面已經(jīng)引入 plupload)：
引入成功后就可以進(jìn)行代碼的編寫了：
var uploader = Qiniu.uploader({
runtimes: 'html5,flash,html4', // 上傳模式，依次退化
browse_button: 'pickfiles', // 上傳選擇的點(diǎn)選按鈕，必需
// 在初始化時(shí)，uptoken，uptoken_url，uptoken_func三個(gè)參數(shù)中必須有一個(gè)被設(shè)置
// 切如果提供了多個(gè)，其優(yōu)先級(jí)為uptoken > uptoken_url > uptoken_func
// 其中uptoken是直接提供上傳憑證，uptoken_url是提供了獲取上傳憑證的地址，如果需要定制獲取uptoken的過(guò)程則可以設(shè)置uptoken_func
uptoken : '<Your upload token>', // uptoken是上傳憑證，由其他程序生成
// uptoken_url: '/uptoken', // Ajax請(qǐng)求uptoken的Url，強(qiáng)烈建議設(shè)置（服務(wù)端提供）
// uptoken_func: function(file){ // 在需要獲取uptoken時(shí)，該方法會(huì)被調(diào)用
// // do something
// return uptoken;
// },
get_new_uptoken: false, // 設(shè)置上傳文件的時(shí)候是否每次都重新獲取新的uptoken
// downtoken_url: '/downtoken',
// Ajax請(qǐng)求downToken的Url，私有空間時(shí)使用，JS-SDK將向該地址POST文件的key和domain，服務(wù)端返回的JSON必須包含url字段，url值為該文件的下載地址
// unique_names: true, // 默認(rèn)false，key為文件名。若開啟該選項(xiàng)，JS-SDK會(huì)為每個(gè)文件自動(dòng)生成key（文件名）
// save_key: true, // 默認(rèn)false。若在服務(wù)端生成uptoken的上傳策略中指定了sava_key，則開啟，SDK在前端將不對(duì)key進(jìn)行任何處理
domain: '<Your bucket domain>', // bucket域名，下載資源時(shí)用到，必需
container: 'container', // 上傳區(qū)域DOM ID，默認(rèn)是browser_button的父元素
max_file_size: '100mb', // 最大文件體積限制
flash_swf_url: 'path/of/plupload/Moxie.swf', //引入flash，相對(duì)路徑
max_retries: 3, // 上傳失敗最大重試次數(shù)
dragdrop: true, // 開啟可拖曳上傳
drop_element: 'container', // 拖曳上傳區(qū)域元素的ID，拖曳文件或文件夾后可觸發(fā)上傳
chunk_size: '4mb', // 分塊上傳時(shí)，每塊的體積
auto_start: true, // 選擇文件后自動(dòng)上傳，若關(guān)閉需要自己綁定事件觸發(fā)上傳
//x_vars : {
// 查看自定義變量
// 'time' : function(up,file) {
// var time = (new Date()).getTime();
// do something with 'time'
// return time;
// },
// 'size' : function(up,file) {
// var size = file.size;
// do something with 'size'
// return size;
// }
//},
init: {
'FilesAdded': function(up, files) {
plupload.each(files, function(file) {
// 文件添加進(jìn)隊(duì)列后，處理相關(guān)的事情
});
},
'BeforeUpload': function(up, file) {
// 每個(gè)文件上傳前，處理相關(guān)的事情
},
'UploadProgress': function(up, file) {
// 每個(gè)文件上傳時(shí)，處理相關(guān)的事情
},
'FileUploaded': function(up, file, info) {
// 每個(gè)文件上傳成功后，處理相關(guān)的事情
// 其中info是文件上傳成功后，服務(wù)端返回的json，形式如：
// {
// "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
// "key": "gogopher.jpg"
// }
// 查看簡(jiǎn)單反饋
// var domain = up.getOption('domain');
// var res = parseJSON(info);
// var sourceLink = domain +"/"+ res.key; 獲取上傳成功后的文件的Url
},
'Error': function(up, err, errTip) {
//上傳出錯(cuò)時(shí)，處理相關(guān)的事情
},
'UploadComplete': function() {
//隊(duì)列文件處理完畢后，處理相關(guān)的事情
},
'Key': function(up, file) {
// 若想在前端對(duì)每個(gè)文件的key進(jìn)行個(gè)性化處理，可以配置該函數(shù)
// 該配置必須要在unique_names: false，save_key: false時(shí)才生效
var key = "";
// do something with key here
return key
}
}
});
// domain為七?？臻g對(duì)應(yīng)的域名，選擇某個(gè)空間后，可通過(guò) 空間設(shè)置->基本設(shè)置->域名設(shè)置 查看獲取
// uploader為一個(gè)plupload對(duì)象，繼承了所有plupload的方法
plupload上傳圖片的功能還有很多，在這里不多做介紹,下面是這個(gè)上傳功能的一個(gè)Demo演示，下一篇說(shuō)下縮略圖策略。
上傳Demo: http://jssdk.demo.qiniu.io/
