iCloud.docDownload()

概览

iCloud 文档不一定在磁盘上，当需要释放磁盘空间时，系统可能会将其驱逐。为了加快文档访问速度，可调用此函数来发起下载并调用带有 iCloudDocEvent 的 onComplete 侦听器函数。

陷阱

onComplete 监听函数在下载开始时（而不是下载完成后）被调用。

语法

iCloud.docDownload( params )

参数参考

params 表格的有效键包括

• filename — 必需；要下载的文件。

• onComplete — 必需 侦听器 函数，此函数带有 iCloudDocEvent 被调用。

• containerId — 可选 字符串 值，指示要用于文档存储的特定 iCloud 容器。如果您只有与应用关联的一个 iCloud 容器，则不要传递此参数。

示例

local function docListener( event )

    if event.isError then
        print( event.error )
        print( event.errorCode )
    end
end

iCloud.docDownload(
    {
        filename = "test.txt",
        onComplete = docListener
    }
)