文件 - 动作 - 《代码 AI工具软件开发》

动作（名称与参数）表

动作名称动作说明动作参数动作参数说明读取本地图片读取一张本地图片的信息。 是否输出base64 是否需要在读取之后转换为base64格式，默认为是。转换为base64，会有一定的性能消耗，如果仅需要显示图片并上传，可以使用临时路径+文件对象的方法，无需输出base64。如果选择输出base64，则返回结果中可引用base64结果（src字段），否则不会返回base64结果。压缩后宽当选择输出base64时，可选择对读取的本地图片进行压缩，此参数可指定压缩后宽，如果仅指定压缩后宽，不指定压缩后高，则系统自动按图片比例计算压缩后高。压缩后高当选择输出base64时，可选择对读取的本地图片进行压缩，此参数可指定压缩后高，如果仅指定压缩后高，不指定压缩后宽，则系统自动按图片比例计算压缩后宽。输出格式选择读取后图片的格式为jpg或png。如果选择jpg，则可以进一步指定图片质量。

参数选项

png、 jpeg、输出质量输出图片的质量，是一个0-1之间的数值。注意，仅当输出图片格式选择为jpg时次选项才有效，png格式为不可压缩格式。读取多张本地图片读取多张本地图片的信息。最大图片数最多允许一次上传的图片个数。是否输出base64 是否需要在读取之后转换为base64格式，默认为是。转换为base64，会有一定的性能消耗，如果仅需要显示图片并上传，可以使用临时路径+文件对象的方法，无需输出base64。如果选择输出base64，则返回结果中可引用base64结果（src字段），否则不会返回base64结果。压缩后宽当选择输出base64时，可选择对读取的本地图片进行压缩，此参数可指定压缩后宽，如果仅指定压缩后宽，不指定压缩后高，则系统自动按图片比例计算压缩后高。压缩后高当选择输出base64时，可选择对读取的本地图片进行压缩，此参数可指定压缩后高，如果仅指定压缩后高，不指定压缩后宽，则系统自动按图片比例计算压缩后宽。输出格式选择读取后图片的格式为jpg或png。如果选择jpg，则可以进一步指定图片质量。

参数选项

png、 jpeg、输出质量输出图片的质量，是一个0-1之间的数值。注意，仅当输出图片格式选择为jpg时次选项才有效，png格式为不可压缩格式。读取本地文件读取一个本地文件的信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。转为base64 默认否，选择是之后，将自动把文件转成base64，此时，可以在回调中选择读取结果的base64串，否则无法读取。可选文件类型参数可以限制选择的文件类型，由文件的mimeType构建的字符串，如设置多个，以英文逗号分割，例如：”image/*,application/x-zip-compressed” 读取多个本地文件读取多个本地文件的信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。可选文件类型参数可以限制选择的文件类型，由文件的mimeType构建的字符串，如设置多个，以英文逗号分割，例如：”image/*,application/x-zip-compressed” 最大文件数最多允许一次上传的文件个数。上传一张图片上传一张图片到ivx服务器，可以在回调中获取图片相关信息。路径图片来源，可为base64字串或文件对象。不填时默认打开文件选择器让用户选择。最大图片大小（kb）不填时默认不限大小。最小图片大小（kb）不填时默认不限大小。压缩后宽默认不压缩压缩后高默认不压缩图片来源可限制图片来源为拍照或相册。

参数选项

不限、仅相册、仅拍照、使用微信接口在微信浏览器中，是否使用微信的上传图片接口，默认为否。注意，打开这个开关以后，微信会自动压缩图片，无法原图上传；但如果不打开这个开关，会出现部分安卓手机无法同时调起相册和相机，单选camera会有部分iOS手机会出现闪退现象。同时，微信接口上传图片，不返回图片上传进度，这个是微信浏览器内部的限制，请根据需求来选择。上传格式可选择上传图片为jpg或png格式，选择jpg格式后，还可以额外指定图片质量。

参数选项

不限、仅相册、仅拍照、使用微信接口在微信浏览器中，是否使用微信的上传图片接口，默认为否。注意，打开这个开关以后，微信会自动压缩图片，无法原图上传；但如果不打开这个开关，会出现部分安卓手机无法同时调起相册和相机，单选camera会有部分iOS手机会出现闪退现象。这个是微信浏览器内部的限制，请根据需求来选择。上传格式可选择上传图片为jpg或png格式，选择jpg格式后，还可以额外指定图片质量。

参数选项

默认、 png、 jpeg、图片质量一个0-1之间的数值，当图片格式选择为jpg时，可以指定图片质量，以削减上传图片的文件大小。超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。路径前缀在私有部署时可指定一个上传文件的路径前缀，系统将自动在文件名前方添加这个前缀，方便文件管理。注意，为了避免和系统文件名称冲突，建议路径前缀都是用大写字母。另，此功能仅在私有部署是有效，公共服务器上无效。开始上传执行动作上传中执行动作预览图片预览图片，被预览的图片会被放大占据整个窗口。预览图片接收两个参数，其中第一个参数为需要预览的所有图片路径构成的数组，例如两张需预览图片的 url 地址分别为 url1、url2，那么该参数为 [url1, url2]。第二个参数非必需，为预览效果出现时展现的图片，默认为第一个参数内的第一个元素，可以手动设置——传入数组内的某个元素的 url 值，例如 url2。需要预览的图片路径列表(必填) 所有需要预览的图片的url地址构成的数组。当前显示图片的地址默认显示数组内的第一个元素对应的图片，接收一个具体的 url 地址。上传视频上传一条视频到ivx服务器，可以在回调中获取视频相关信息。路径文件的url地址，不填时默认打开文件选择器让用户选择。最大视频大小（kb）不填时默认不限大小。最小视频大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作批量上传视频（最多20条）批量上传视频到ivx服务器，可以在回调中获取视频相关信息。最大视频数最多允许一次上传的视频个数。路径文件的url地址构成的数组，不填时默认打开文件选择器让用户选择。最大视频大小（kb）不填时默认不限大小。最小视频大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作上传音频上传一条音频到ivx服务器，可以在回调中获取音频相关信息。不支持在支付宝小程序中使用。路径文件的url地址，不填时默认打开文件选择器让用户选择。最大音频大小（kb）不填时默认不限大小。最小音频大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作批量上传音频（最多20条）批量上传音频到ivx服务器，可以在回调中获取音频相关信息。不支持在支付宝小程序中使用。最大音频数最多允许一次上传的音频个数。路径文件的url地址构成的数组，不填时默认打开文件选择器让用户选择。最大音频大小（kb）不填时默认不限大小。最小音频大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作上传文件上传一个文件到ivx服务器，可以在回调中获取文件相关信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。路径文件的url地址，不填时默认打开文件选择器让用户选择。最大文件大小（kb）不填时默认不限大小。最小文件大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。可选文件类型参数可以限制选择的文件类型，由文件的mimeType构建的字符串，如设置多个，以英文逗号分割，例如：”image/*,application/x-zip-compressed” 开始上传执行动作上传中执行动作批量上传文件（最多20个）批量上传文件到ivx服务器，可以在回调中获取文件相关信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。最大文件数最多允许一次上传的文件个数。路径文件的url地址构成的数组，不填时默认打开文件选择器让用户选择。最大文件大小（kb）不填时默认不限大小。最小文件大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作中断文件上传中断当前文件上传进程。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。 -/- 预览文件预览给定地址的文件。链接要预览的文件的链接。下载文件下载给定地址的文件。文件名链接要下载的文件的链接。批量下载文件批量下载文件，输入需要下载的文件url数组，下载为一个zip打包文件。 zip包名称下载的zip文件的名称资源地址数组需要下载的资源地址数组，数组支持绝对路径或是使用”文件接口”的”获取文件临时地址”。资源路径数组中如不需指定子文件名称，则默认使用哈希值作为子文件名称；如需指定子文件名称，则要传入对象数组结构如 [{“name”:”xx1.jpg”,”url”:”xx”},{“name”:”xx2.jpg”,”url”:”xx”}]，name要求有后缀。此外，zip包内支持设置多级文件夹，请在数组中增加id和parentId列，并设置好父子级关系，url为空按文件夹类型处理，详细用法请见文档。文件前缀当前文件的前缀，可以用这个前缀和当前的文件相对路径，拼接出文件的绝对路径。 -/- 保存图片至相册将某个图片保存至相册。注意，这个功能在纯web/h5中不生效，因为移动端浏览器原生并不提供这个接口。但在打包成各种小程序以及发布为ios/安卓之后，可以生效。路径图片资源的绝对地址（https开头），或者base64格式的资源上传文件夹将某个文件夹中的文件，批量上传。上传之后，将按文件夹结构返回一个json结构。我们可以进一步按照这个json结构，结合树形组件，将文件夹的结构呈现出来。最大文件大小（kb）不填时默认不限大小。最小文件大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作上传文本至文件将本地的文本上传为一个文本文件，比如，将一段json上传为一个文本文件，将此文本的url存入数据库。避免存储大量的文本至数据库，以提高数据库性能，并降低存储成本。文件名称上传之后的文件名称，请勿包括后缀。文件后缀文本文件的后缀，比如txt, json,db等。文本内容需要上传的文本内容。超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作

参数选项

MainBundlePath、 CachesDirectoryPath、 DocumentDirectoryPath、 TemporaryDirectoryPath、 LibraryDirectoryPath、 ExternalDirectoryPath、 ExternalStorageDirectoryPath、

参数选项

utf8、 ascii、 base64、

参数选项

utf8、 ascii、 base64、获取文件临时地址获取文件的临时地址，这个地址可临时打开文件，但经过一段时间后（不长于1个小时）文件地址会失效。文件路径文件在ivx中存储的路径属性，比如图片的素材资源地址，视频的素材资源地址属性。上传文档上传一个office类文档到ivx服务器，可以在回调中获取文件相关信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。路径文档的url地址，不填时默认打开文件选择器让用户选择。最大文档大小（kb）不填时默认不限大小。最小文档大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。可选文件类型参数可以限制选择的文件类型，由文件的mimeType构建的字符串，如设置多个，以英文逗号分割，例如：”image/*,application/x-zip-compressed” 开始上传执行动作上传中执行动作批量上传文档（最多20个）批量上传office类文档到ivx服务器，可以在回调中获取文件相关信息。不支持在微信浏览器、webApp微信小程序、支付宝/钉钉小程序中使用。最大文档数最多允许一次上传的文档个数。路径文档的url地址构成的数组，不填时默认打开文件选择器让用户选择。最大文档大小（kb）不填时默认不限大小。最小文档大小（kb）超时时长设置一个上传行为的超时时长，以秒为单位，默认60S。超过超时时长尚未上传完成，将触发超时回调。开始上传执行动作上传中执行动作

动作（回调）表

对应动作结果引用结果状态结果引用属性结果属性说明读取本地图片读取结果成功失败 base64图片图片转换为base64格式的资源地址。注意，仅在读取时打开输出base64时，此项才会有结果，否则结果为空。名称图片名称。类型图片的类型。尺寸图片的大小。宽度图片的宽度。高度图片的高度。临时本地路径图片临时本地路径。读取失败原因读取图片失败的原因。文件对象读取到的图片文件对象，可用来作为上传图片的文件路径。读取多张本地图片读取结果成功失败图片列表所有被读取的图片的相关信息组成的数组。返回结果是一个对象数组，每个对象包含的字段包含src,name,type,size,width,height,path,file,详见读取一张图片的返回结果说明。读取失败原因读取图片失败的原因。读取本地文件读取结果成功失败名称文件名称。类型文件的类型。尺寸文件的大小。临时本地路径文件临时本地路径。 base64数据文件的base64格式数据，注意，必须在读取的时候选择base64格式方可读取。读取多个本地文件读取结果成功失败文件列表所有被读取的文件的相关信息组成的数组。读取失败原因读取文件失败的原因。上传一张图片上传的图片开始上传上传中上传完成上传失败 url地址上传图片的url地址。名称上传图片的名称。类型上传图片的类型。大小（字节）上传图片的字节大小。大小（带单位）上传图片的大小，附带单位。上传进度上传进度上传失败原因上传失败原因分辨率分辨率原始宽图片的原始宽度。原始高图片的原始高度。批量上传图片（最多20张）上传的图片开始上传上传中上传完成上传失败值所有成功上传的图片的信息数组，是一个对象数组，包括url地址，名称等信息。 url地址所有图片url地址组成的数组。名称所有图片名称组成的数组。类型所有图片类型组成的数组。大小（字节）所有图片字节大小组成的数组。大小（带单位）所有图片带单位大小组成的数组。上传进度上传进度。上传失败原因上传失败原因。分辨率所有图片的分辨率组成的数组。原始宽所有图片的原始宽度组成的数组。原始高所有图片的原始高度组成的数组。上传视频上传的视频开始上传上传中上传完成上传失败 url地址视频的url地址。名称视频名称。类型视频文件类型。大小（字节）视频的字节大小。大小（带单位）视频带单位的大小。时长（秒）视频的时长，以秒为单位。封面图视频的封面图。上传进度视频上传进度。上传失败原因上传失败原因分辨率视频分辨率。原始宽视频的原始宽度。原始高视频的原始高度。批量上传视频（最多20条）上传的视频开始上传上传中上传完成上传失败值所有成功上传的视频的信息数组，是一个对象数组，包括url地址，名称等信息。 url地址所有视频url地址。名称所有视频名称。类型所有视频的文件类型。大小（字节）所有视频的字节大小。大小（带单位）所有视频的带单位大小。时长（秒）所有视频的时长。封面图所有视频的封面图。上传进度视频上传进度。上传失败原因上传失败原因。分辨率所有视频的分辨率。原始宽所有视频的原始宽度。原始高所有视频的原始高度。上传音频上传的音频开始上传上传中上传完成上传失败 url地址音频的url地址。名称音频名称。类型音频文件类型。大小（字节）音频的字节大小。大小（带单位）音频的带单位大小。上传进度音频上传进度。上传失败原因上传失败原因。时长（秒）音频的时长。批量上传音频（最多20条）上传的音频开始上传上传中上传完成上传失败值所有成功上传的图片的信息数组，是一个对象数组，包括url地址，名称等信息。 url地址所有音频的url地址。名称所有音频的名称。类型所有音频的文件类型。大小（字节）所有音频的字节大小。大小（带单位）所有音频的带单位大小。上传进度音频上传进度。上传失败原因上传失败原因。时长（秒）所有音频的时长。上传文件上传的文件开始上传上传中上传完成上传失败 url地址文件的url地址。名称文件名称。类型文件的类型。大小（字节）文件的字节大小。大小（带单位）文件带单位的大小。上传进度文件上传进度。上传失败原因上传失败原因。批量上传文件（最多20个）上传的文件开始上传上传中上传完成上传失败值所有成功上传的文件的信息数组，是一个对象数组，包括url地址，名称等信息。 url地址所有文件的url地址。名称所有文件名称。类型所有文件的类型。大小（字节）所有文件的字节大小。大小（带单位）所有文件带单位的大小。上传进度文件上传进度。上传失败原因上传失败原因。下载文件返回结果下载中下载完成下载错误已下载量已下载的文件大小，以bit为单位。下载进度错误信息批量下载文件返回结果下载中下载完成下载错误已下载量已下载的zip文件大小，以bit为单位。下载进度错误信息保存图片至相册返回结果 success fail -/- 上传文件夹上传的文件开始上传上传中上传完成上传失败结果（JSON） JSON树形结构的返回结果。结果（对象数组）对象数组格式的返回结果，可以直接绑定为树形容器的数据来源。上传进度文件上传进度。上传失败原因上传失败原因。 success fail success fail 上传文本至文件 beforeUpload uploading uploaded onError success fail success fail success fail success fail success fail success fail 上传文档上传的文件 beforeUpload uploading uploaded onError 文档名称文档名称。类型对应文档的mimeType。 url地址文档的url地址。路径前缀文档url地址的前缀。资源解析路径文档内图片等资源对应的解析路径，需搭配组件的“设置资源解析路径”动作使用。 txt路径由于上传文件解析后字符过多，因此将转为txt文件返回。上传进度上传失败原因批量上传文档（最多20个）上传的文件 beforeUpload uploading uploaded onError 值所有成功上传的文档的信息数组，是一个对象数组。上传进度上传失败原因