SDK:
http://developer.qiniu.com/code/v6/sdk/javascript.html#upload
上傳
-
在頁面中引入 plupload,plupload.full.min.js(產品環境)或引入 plupload.dev.js 和 moxie.js(開發調試)
-
在頁面中引入 qiniu.min.js(生產環境)或 qiniu.js(開發調試)
-
初始化 uploader (請確保在執行初始化時,頁面已經引入 plupload):
var uploader = Qiniu.uploader({ runtimes: 'html5,flash,html4', // 上傳模式,依次退化 browse_button: 'pickfiles', // 上傳選擇的點選按鈕,必需 // 在初始化時,uptoken,uptoken_url,uptoken_func三個參數中必須有一個被設置 // 切如果提供了多個,其優先級為uptoken > uptoken_url > uptoken_func // 其中uptoken是直接提供上傳憑證,uptoken_url是提供了獲取上傳憑證的地址,如果需要定制獲取uptoken的過程則可以設置uptoken_func // uptoken : '<Your upload token>', // uptoken是上傳憑證,由其他程序生成 // uptoken_url: '/uptoken', // Ajax請求uptoken的Url,強烈建議設置(服務端提供) // uptoken_func: function(file){ // 在需要獲取uptoken時,該方法會被調用 // // do something // return uptoken; // }, get_new_uptoken: false, // 設置上傳文件的時候是否每次都重新獲取新的uptoken // downtoken_url: '/downtoken', // Ajax請求downToken的Url,私有空間時使用,JS-SDK將向該地址POST文件的key和domain,服務端返回的JSON必須包含url字段,url值為該文件的下載地址 // unique_names: true, // 默認false,key為文件名。若開啟該選項,JS-SDK會為每個文件自動生成key(文件名) // save_key: true, // 默認false。若在服務端生成uptoken的上傳策略中指定了sava_key,則開啟,SDK在前端將不對key進行任何處理 domain: '<Your bucket domain>', // bucket域名,下載資源時用到,必需 container: 'container', // 上傳區域DOM ID,默認是browser_button的父元素 max_file_size: '100mb', // 最大文件體積限制 flash_swf_url: 'path/of/plupload/Moxie.swf', //引入flash,相對路徑 max_retries: 3, // 上傳失敗最大重試次數 dragdrop: true, // 開啟可拖曳上傳 drop_element: 'container', // 拖曳上傳區域元素的ID,拖曳文件或文件夾后可觸發上傳 chunk_size: '4mb', // 分塊上傳時,每塊的體積 auto_start: true, // 選擇文件后自動上傳,若關閉需要自己綁定事件觸發上傳 //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) { // 文件添加進隊列后,處理相關的事情 }); }, 'BeforeUpload': function(up, file) { // 每個文件上傳前,處理相關的事情 }, 'UploadProgress': function(up, file) { // 每個文件上傳時,處理相關的事情 }, 'FileUploaded': function(up, file, info) { // 每個文件上傳成功后,處理相關的事情 // 其中info是文件上傳成功后,服務端返回的json,形式如: // { // "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98", // "key": "gogopher.jpg" // } // 查看簡單反饋 // var domain = up.getOption('domain'); // var res = parseJSON(info); // var sourceLink = domain +"/"+ res.key; 獲取上傳成功后的文件的Url }, 'Error': function(up, err, errTip) { //上傳出錯時,處理相關的事情 }, 'UploadComplete': function() { //隊列文件處理完畢后,處理相關的事情 }, 'Key': function(up, file) { // 若想在前端對每個文件的key進行個性化處理,可以配置該函數 // 該配置必須要在unique_names: false,save_key: false時才生效 var key = ""; // do something with key here return key } } }); // domain為七牛空間對應的域名,選擇某個空間后,可通過 空間設置->基本設置->域名設置 查看獲取 // uploader為一個plupload對象,繼承了所有plupload的方法
-
如果一個頁面中有多個上傳實例,可以按如下操作:
var option1 = { key : val , …… }; var uploader = Qiniu.uploader(option1); var Qiniu2 = new QiniuJsSDK(); var option2 = { key : val , …… }; var uploader2 = Qiniu2.uploader(option2);