@@ -22,16 +22,18 @@ Qiniu-JavaScript-SDK (下文简称为 JS-SDK)适用于 IE8+、Chrome、Firef
22
22
23
23
Qiniu-JavaScript-SDK 为客户端 SDK,没有包含 token 生成实现,为了安全,token 建议通过网络从服务端获取,具体生成代码可以参考以下服务端 SDK 的文档。
24
24
25
- - [ Java] ( http://developer.qiniu.com/code/v7/sdk/android.html )
26
- - [ PHP] ( http://developer.qiniu.com/code/v7/sdk/php.html )
27
- - [ Python] ( http://developer.qiniu.com/code/v7/sdk/python.html )
28
- - [ Ruby] ( http://developer.qiniu.com/code/v6/sdk/ruby.html )
29
- - [ Go] ( http://developer.qiniu.com/code/v7/sdk/go.html )
30
- - [ Node.js] ( http://developer.qiniu.com/code/v6/sdk/nodejs.html )
31
- - [ C#] ( http://developer.qiniu.com/code/v6/sdk/csharp.html )
32
- - [ C/C++] ( http://developer.qiniu.com/code/v6/sdk/cpp.html )
33
-
34
- Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js 服务器端 SDK ] ( http://developer.qiniu.com/code/v6/sdk/nodejs.html ) 开发的。
25
+ - [ Android] ( https://developer.qiniu.com/kodo/sdk/android )
26
+ - [ Java] ( https://developer.qiniu.com/kodo/sdk/java )
27
+ - [ PHP] ( https://developer.qiniu.com/kodo/sdk/php )
28
+ - [ Python] ( https://developer.qiniu.com/kodo/sdk/python )
29
+ - [ Ruby] ( https://developer.qiniu.com/kodo/sdk/ruby )
30
+ - [ Go] ( https://developer.qiniu.com/kodo/sdk/go )
31
+ - [ Node.js] ( https://developer.qiniu.com/kodo/sdk/nodejs )
32
+ - [ C#] ( https://developer.qiniu.com/kodo/sdk/csharp )
33
+ - [ C/C++] ( https://developer.qiniu.com/kodo/sdk/cpp )
34
+ - [ Objective-C] ( https://developer.qiniu.com/kodo/sdk/objc )
35
+
36
+ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js 服务器端 SDK ] ( https://developer.qiniu.com/kodo/sdk/nodejs ) 开发的。
35
37
36
38
<!--
37
39
本 SDK 可使开发者忽略上传底层实现细节,而更多的关注 UI 层的展现。
@@ -86,11 +88,11 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
86
88
- JS-SDK 的上传功能基于 [ Plupload] ( http://www.plupload.com/ ) 插件封装的,所以需要[ 下载 Plupload] ( http://plupload.com/download ) ,建议使用 2.1.1 版本。
87
89
您也可以访问[ 开放静态文件 CDN ] ( http://staticfile.org/ ) ,搜索 plupload,使用 CDN 加速的静态文件地址。
88
90
89
- - 在使用 JS-SDK 之前,您必须先注册一个七牛帐号,并登录控制台获取一对有效的 AccessKey 和 SecretKey,您可以阅读[ 如何接入七牛 ] ( http ://developer.qiniu.com/article/ kodo/kodo-first/ quickstart.html ) 和[ 安全机制 ] ( http ://developer.qiniu.com/article/ kodo/kodo-developer/index.html #security) 以进一步了解如何正确使用和管理密钥 。
91
+ - 在使用 JS-SDK 之前,您必须先注册一个七牛帐号,并登录控制台获取一对有效的 AccessKey 和 SecretKey,您可以阅读[ 快速入门 ] ( https ://developer.qiniu.com/kodo/manual/console- quickstart) 和[ 安全机制 ] ( https ://developer.qiniu.com/kodo/manual/security #security) 以进一步了解如何正确使用和管理密钥 。
90
92
91
93
- JS-SDK 依赖服务端颁发 uptoken,可以通过以下二种方式实现:
92
- - 利用[ 七牛服务端 SDK ] ( http ://developer.qiniu.com/resource/official.html #sdk) 构建后端服务
93
- - 利用七牛底层 API 构建服务,详见七牛[ 上传策略] ( http ://developer.qiniu.com/article/developer/security/ put-policy.html ) 和[ 上传凭证] ( http ://developer.qiniu.com/article/developer/security/ upload-token.html )
94
+ - 利用[ 七牛服务端 SDK ] ( https ://developer.qiniu.com/sdk #sdk) 构建后端服务
95
+ - 利用七牛底层 API 构建服务,详见七牛[ 上传策略] ( https ://developer.qiniu.com/kodo/manual/ put-policy) 和[ 上传凭证] ( https ://developer.qiniu.com/kodo/manual/ upload-token)
94
96
95
97
后端服务应提供一个 URL 地址,供 JS-SDK 初始化使用,前端通过 Ajax 请求该地址后获得 uptoken。Ajax 请求成功后,服务端应返回如下格式的 json:
96
98
@@ -328,7 +330,7 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
328
330
329
331
```
330
332
331
- 具体水印参数解释见[水印(watermark)](http ://developer.qiniu.com/docs/v6/ api/reference/fop/ image/ watermark.html )
333
+ 具体水印参数解释见[水印(watermark)](https ://developer.qiniu.com/dora/ api/image-watermarking-processing- watermark)
332
334
333
335
- imageView2
334
336
@@ -343,7 +345,7 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
343
345
}, key);
344
346
345
347
```
346
- 具体缩略参数解释见[图片处理 (imageView2)](http ://developer.qiniu.com/docs/v6/ api/reference/fop/image/ imageview2.html )
348
+ 具体缩略参数解释见[图片基本处理 (imageView2)](https ://developer.qiniu.com/dora/ api/basic-processing-images- imageview2)
347
349
348
350
- imageMogr2
349
351
@@ -363,14 +365,14 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
363
365
364
366
```
365
367
366
- 具体高级图像处理参数解释见[高级图像处理 (imageMogr2)](http ://developer.qiniu.com/docs/v6/ api/reference/fop/image/ imagemogr2.html )
368
+ 具体高级图像处理参数解释见[图像高级处理 (imageMogr2)](https ://developer.qiniu.com/dora/ api/the-advanced-treatment-of-images- imagemogr2)
367
369
368
370
- imageInfo
369
371
370
372
```JavaScript
371
373
var imageInfoObj = Qiniu.imageInfo(key);
372
374
```
373
- 具体 imageInfo 解释见[图片基本信息(imageInfo)](http ://developer.qiniu.com/docs/v6/ api/reference/fop/image/ imageinfo.html )
375
+ 具体 imageInfo 解释见[图片基本信息(imageInfo)](https ://developer.qiniu.com/dora/ api/pictures-basic-information- imageinfo)
374
376
375
377
Ajax跨域限制,IE系列此函数只支持IE10+
376
378
@@ -380,7 +382,7 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
380
382
var exifOjb = Qiniu.exif(key);
381
383
```
382
384
383
- 具体 exif 解释见[图片EXIF信息(exif)](http ://developer.qiniu.com/docs/v6/ api/reference/fop/image/ exif.html )
385
+ 具体 exif 解释见[图片EXIF信息(exif)](https ://developer.qiniu.com/dora/ api/photo- exif-information-exif )
384
386
385
387
Ajax跨域限制,IE系列此函数只支持IE10+
386
388
@@ -450,7 +452,7 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
450
452
451
453
```
452
454
453
- 具体管道操作解释见[管道操作](http ://developer.qiniu.com/docs/v6/api/overview/fop/pipeline.html )
455
+ 具体管道操作解释见[管道操作](https ://developer.qiniu.com/dora/manual/processing-mechanism )
454
456
455
457
<a id="demo"></a>
456
458
### 运行示例
@@ -459,7 +461,7 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
459
461
2. 进入 `demo` 目录,按照目录下的 `config.example` 示例,创建 `config.js` 文件,其中,`Access Key` 和 `Secret Key` 按如下方式获取
460
462
461
463
* [开通七牛开发者帐号](https://portal.qiniu.com/signup)
462
- * [登录七牛开发者自助平台,查看 AccessKey 和 SecretKey](https://portal.qiniu.com/setting /key) 。
464
+ * [登录七牛开发者自助平台,查看 AccessKey 和 SecretKey](https://portal.qiniu.com/user /key) 。
463
465
464
466
```javascript
465
467
@@ -482,14 +484,14 @@ Qiniu-JavaScript-SDK 的示例 Demo 中的服务器端部分是基于[ Node.js
482
484
483
485
2. JS-SDK 依赖 uptoken,可以直接设置 `uptoken` 、通过提供 Ajax 请求地址 `uptoken_url` 或者通过提供一个能够返回 uptoken 的函数 `uptoken_func` 实现。
484
486
485
- 3. 如果您想了解更多七牛的上传策略,建议您仔细阅读 [七牛官方文档-上传](http ://developer.qiniu.com/code/v6/api/kodo-api/index.html#up )。
487
+ 3. 如果您想了解更多七牛的上传策略,建议您仔细阅读 [七牛官方文档-上传](https ://developer.qiniu.com/kodo/manual/upload-types )。
486
488
另外,七牛的上传策略是在后端服务指定的,JS-SDK 的 setOption API 只是设置 Plupload 的初始化参数,和上传策略无关。
487
489
488
- 4. 如果您想了解更多七牛的图片处理,建议您仔细阅读 [七牛官方文档-图片处理](http ://developer.qiniu.com/code/v6/ api/kodo- api/index.html#image )
490
+ 4. 如果您想了解更多七牛的图片处理,建议您仔细阅读 [七牛官方文档-图片处理](https ://developer.qiniu.com/dora/ api/image-processing- api)
489
491
490
492
5. 如果是 https 网站,上传地址为 https://up.qbox.me 否则使用 http://upload.qiniu.com
491
493
492
- 6. JS-SDK 示例生成 uptotken 时,指定的 `Bucket Name` 为公开空间,所以可以公开访问上传成功后的资源。若您生成 uptoken 时,指定的 `Bucket Name` 为私有空间,那您还需要在服务端进行额外的处理才能访问您上传的资源。具体参见[下载凭证](http ://developer.qiniu.com/article/developer/security/ download-token.html )。JS-SDK 数据处理部分功能不适用于私有空间。
494
+ 6. JS-SDK 示例生成 uptotken 时,指定的 `Bucket Name` 为公开空间,所以可以公开访问上传成功后的资源。若您生成 uptoken 时,指定的 `Bucket Name` 为私有空间,那您还需要在服务端进行额外的处理才能访问您上传的资源。具体参见[下载凭证](https ://developer.qiniu.com/kodo/manual/ download-token)。JS-SDK 数据处理部分功能不适用于私有空间。
493
495
494
496
<a id="faq"></a>
495
497
### 常见问题
0 commit comments