类型 函数 返回值 CloudKitRecord 版本 版本 2024.3703 关键词 iCloud,同步,存储,CloudKit,recordCreate 另请参阅 iCloud.recordCreateZone() iCloud.recordDelete() CloudKitRecord CloudKitRecord:save() CloudKitRecord:set() iCloud.*
创建并返回一个新的 CloudKitRecord 对象。
创建的对象**不会**存储在 CloudKit 数据库中。 使用 CloudKitRecord:save() 将其发送到数据库。
iCloud.recordCreate( params )
表。 包含
params
表的有效键包括:
type
— 必填的 字符串 值,表示 CloudKit 数据库中的记录类型。 同一类型的记录具有相同的属性,类似于关系数据库中的表。
recordName
— 可选的 字符串 值,表示记录的特定标识符。 如果未设置,将生成一个唯一标识符。
zoneName
— 可选的 字符串 值,指示记录的区域名称。 您可以使用区域对记录进行分组,前提是该区域是通过 iCloud.recordCreateZone() 创建的。 如果未指定,则使用默认区域。
zoneOwner
— 可选的 字符串 值,指示记录的区域所有者。 如果未指定,则使用默认所有者(当前用户)。
table
— 可选的 表,包含用于初始化记录的字段名称和值。 与每个字段关联的值通常作为包含所需 type
键的 表 传递,以及 CloudKitRecord:set() 文档中概述的相关键。 但是,为了方便起见,可以直接传递 字符串 和 数字。
local recordData = { -- String and number values can be passed directly (convenience method) company = "Corona Labs", amount = 1, -- Other value types must be passed as a table where = { type="location", latitude=37.453139, longitude=122.113451 } } local record = iCloud.recordCreate( { type = "company", recordName = "Corona Labs 1", table = recordData } ) record:save()