文件接口
文档 属性·动作·事件
功能概述
文件系统主要应用于执行资源上传或下载相关的动作，通过文件系统可以实现资源管理——从本地上传或批量上传图片、文件、视频、音频等资源及下载资源。
基本用法
资源上传常用于各类用户数据收集或数据自定义场景。 例如，用户头像自定义-要求用户自行上传图片。
资源上传分为单资源上传和资源批量上传，本例中仅讲解单资源上传。 图片、视频、音频、文件资源上传的基本操作大致类似，此处以图片资源的上传为例-进行讲解。
1、资源上传
步骤 1 系统组件的添加
要实现资源上传，需要首先添加一个“系统”组件。 选中前台，单击系统组件，即可完成添加。
步骤 2 上传资源动作的设定
此处设定当点击舞台区域时-要求上传图片，则为前台添加事件如下，目标对象选取“系统”，动作选取“上传一张图片”。
同时，系统自动添加回调，用于检测该上传操作的状态，包括“开始上传”、“正在上传”、“上传完成”、“上传失败”等：
可为每个状态-添加动作触发其它操作、或进行状态提示。 本例中，我们设定当上传成功时-系统弹出弹窗：
进行预览，当我们点击舞台区域时-即弹出本地资源浏览窗口，要求我们选取本地资源进行上传。 上传完毕时，系统会弹出弹框提示。当文件过大或网络状况不好时，该操作可能会有延迟。
2、资源获取
完成上传操作后，资源地址被暂存在缓存中，我们需要访问该地址，以便进行存储或展示。 此处假设：使用一张预设的空白图片-显示上传的图片，则需要将该空白图片的地址设置为上传图片的资源地址。
接上例，在回调下添加事件，目标对象选取预设空白图标，动作选择“设置图片地址”，地址通过下拉菜单选取“上传的图片”，从其属性中选取“URL地址”：
进行预览，可以看到，当上传完成后，预设的图片的URL地址将被替换为上传图片的地址，从而实现了图片的替换操作。
如果需要下载文件，使用 URL 地址下载资源，将在新页中打开该资源。
3、单个资源下载
文件接口的下载文件的方法，可指定文件名和资源地址进行下载：
4、批量下载为zip
文件接口的批量下载文件的方法， 可指定zip包的名称，以及一个资源地址数组：
这个资源地址数组，可以有两种格式：
1）一维数组：直接指定资源地址，这里的资源地址，可以是相对地址，比如ivx中上传的资源返回的url地址，或一个外部的绝对地址。
使用这种方法下载的zip包，zip包中每个文件的名称，是自动生成的哈希名称，如下图所示：
2）对象数组：在一个对象数组中，指定资源地址与每个资源的名称，**name要求有后缀：
这样，下载的zip包中，每个文件会按照指定的名称命名：
以下demo中，将两种方法**都做了演示。
demo地址
5、批量下载为Zip（含子文件夹）
生成和下载 含子文件夹的Zip文件时，资源数组的需包含id、parentId、name和url列，结构示例如下：
打包时，若url为空，则为文件夹类型，若url非空则按资源地址-下载文件。
只有文件夹类型可以作为父级。
上图为例，id=1和2都是文件夹类型，id=3和4的parentId是1，意味着这两个文件属于文件夹1。id=5和6根据所设的parentId属于文件夹2，最后一行id=7的图片文件属于文件夹3。 批量下载后的效果如下：
注意：层级关系为树形结构，若设置错误，将无法正常生成文件导致失败。
若有收获，就点个赞吧
0 人点赞
