全部产品

唤醒客户端下载文件

更新时间:2020-08-06 15:47:33

唤醒客户端并下载文件

介绍

这个 Widget 主要功能是支持在 Web 页面上唤醒客户端并下载文件。

1. 效果演示

(1) 点击按钮,调用唤醒方法

1

(2) 浏览器询问,确定打开

2

(3) 自动唤醒客户端并下载

3

接入方法

1. 举例

(1) 引入js

  1. <script src="https://g.alicdn.com/pds/pds-widgets/${version}/index.min.js"></script>
  2. <button id="btn">使用客户端下载</button>

(2) 给按钮添加点击事件,调用唤醒方法

  1. document.querySelector('#btn').addEventListener('click', function(){
  2. var opt = {
  3. domain_id: 'hz001',
  4. pathname: '/drive/1301',
  5. file_keys: ['/5.png']
  6. }
  7. PDSWidget.downloadByClient(opt)
  8. })

2. API 详解

(1) 唤醒方法:

  1. PDSWidget.downloadByClient(opt)

(2) opt[]参数说明:

字段 必选 描述
domain_id 域的ID
pathname 桌面端打开后,跳转到BasicUI对应的pathname。 对于PDSPath,此处为:/drive; 对于OSSPath, 如果为文件在Drive中,应该为:/drive/:driveId, 如果在Share中,则为:/share/:shareId。以此类推。
file_keys 桌面端打开后,要下载的文件的ID(PDSPath)或者路径(OSSPath)数组。默认为:[], 不下载。
wait 是否等待唤醒,默认false。 如果为true,返回Promise。网页会轮询客户端直到唤醒客户端才resolve,如果超时会reject。如果为false,不返回内容。
verbose 是否打印调试日志,默认false