iCloud.docConflicts()

类型 函数
返回值
修订 版本 2024.3703
关键词 iCloud,同步,存储,文档,docConflicts
另请参阅 iCloud.docConflictData()
iCloud.docResolve()
iCloudDocEvent
event.conflicts
iCloud.*

概述

有时,同一个文件会从多个位置同时修改,iCloud 将无法同步更改。在这种情况下,将发生冲突。调用此函数以检查冲突,并在完成后使用 iCloudDocEvent 调用 onComplete 监听器函数。

重要

如果存在文档冲突,iCloudDocEvent 将包含 event.conflicts 表。应解决这些冲突。

语法

iCloud.docConflicts( params )
参数 (必填)

包含特定方法的参数 — 有关详细信息,请参阅下一节。

参数参考

params 表的有效键包括

示例

local function printConflictData( event )

    print( "Conflict contents: " .. event.contents )
end

local function docListener( event )

    if event.conflicts then
        for i = 1,#event.conflicts do
            print( "Conflict origin: " .. event.conflicts[i].origin )
            print( "Conflict time: " .. event.conflicts[i].time )

            iCloud.docConflictData(
                {
                    conflict = event.conflicts[i].dataHandle,
                    onComplete = printConflictData
                }
            )
        end
    end
end

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