本文介绍毕升office v4版本中Demo项目的使用。
Demo项目代码所在位置为https://gitee.com/ibisheng/demo2022。项目的运行方式如下:
- 参照demo目录中的config.sample.json*文件,创建名称为config.json的配置文件,并保存在demo目录中。
- 执行npm i安装依赖库。
- 执行npm run build编译Demo前端。
- 执行npm run server运行Demo服务端。
- 在浏览器中输入http://loacalhost:9090并访问。
在用户登录界面输入用户ID*,并点击登录按钮登录至Demo项目首页。
登录后画面显示文件列表按钮和ClientApi按钮。
点击文件列表按钮跳转到文件页面,可在此页面使用当前的登录用户对文件进行预览或编辑*操作。
点击ClientApi按钮跳转到ClientApi页面,包含部分网盘SDK调用的实例,具体可参考网盘SDK页面。
- bsdHost
网盘服务的API调用地址。
- access_key_id
系统管理页面/开发设置/API密钥页面中,创建API密钥时,下载获得的ID信息(ak)。
- secret_access_key
系统管理页面/开发设置/API密钥页面中,创建API密钥时,下载获得的Key信息(sk)。
- syncUserUrl
同步调用方用户信息的地址。详细请参考被动同步(syncUserUrl)内容。
- fetchUrl
调用方系统中,指定文件的下载地址。
- callURL
调用方系统中,获取集成文档信息的地址。详细请参考使用callURL来传递数据内容。
- appId
系统管理页面/开发设置/应用集成页面中,创建App时的ID信息。
- appKey
系统管理页面/开发设置/应用集成页面中,创建App时的Key信息。
- folderPath
指定文件在APP空间的保存位置,可将文件上传至当前APP空间根目录的对应路径下。例:上传到根路径->folderPath="/",上传到[/a/b/c]路径->folderPath="/a/b/c"。
调用时指定的用户ID。如果网盘中存在指定ID的用户,将使用此用户进行预览编辑操作;如果网盘中不存在指定ID的用户,将通过syncUserUrl获取用户信息,使用获取的用户信息创建新用户。
- 文件的预览、编辑操作使用Demo项目中登录用户的身份进行操作。
- 对网盘中不存在的文件进行操作时,网盘系统会使用callURL获取文件信息并创建文件。如果文件信息中指定了fetchUrl,网盘系统会将文件下载至App空间中指定的folderPath中,如果没有指定fetchUrl,网盘系统将会在App空间的根目录下创建空白的新文件。
- demo 调用毕升相关服务的代码为 server/router/api.js中相关逻辑,同时请参考本文中的相关文档