Eventos
public struct Events
Realm event recording can be used to record all reads and writes performed on a Realm and report them to the server. Habilite a gravação de eventos definindo a propriedade eventConfiguration
do Realm.Configuration
usado para abrir um Realm e, em seguida, obtenha uma instância Events
com a propriedade events
no Realm
.
-
Comece a gravar eventos com o nome da atividade fornecido.
Todas as query executadas e todos os objeto instanciados dentro de um evento serão relatados automaticamente como evento de "leitura" quando o evento for encerrado. Todos os objetos modificados dentro de um escopo de evento produzirão eventos de "gravação" que relatam o estado inicial do objeto e os novos valores de todas as propriedades que foram alteradas.
Declaração
Swift
public func beginScope(activity: String) -> Scope
Valor de retorno
Um objeto de escopo usado para confirmar ou cancelar o escopo.
-
Grave um evento personalizado.
Essa função salva o evento no disco localmente e, em seguida, os envia de forma assíncrona para o servidor. A função de conclusão opcional é chamada quando os dados do evento persistem com êxito, e não quando o upload real é concluído.
Esta função não interage com escopos de eventos e pode ser chamada sem escopo ativo.
Declaração
Swift
public func recordEvent(activity: String, eventType: String? = nil, data: String? = nil, completion: ((Swift.Error?) -> Void)? = nil)
Parâmetros
activity
O nome da atividade. Esta é uma string arbitrária armazenada como na propriedade de evento
activity
.eventType
The type of event. Esta é uma string arbitrária armazenada como na propriedade de evento
eventType
.data
A carga útil de dados para este evento. If supplied, the string stored in the
data
event property. Observe que, embora todos os eventos gerados automaticamente armazenem JSON nesse campo, os eventos personalizados não são necessários para isso.completion
Um manipulador de conclusão opcional que será chamado assim que o evento for salvo no Realm do evento (mas não necessariamente carregado no servidor) ou ocorra um erro. Um erro de valor null indica o sucesso.
-
Substitua os metadados fornecidos na configuração do evento por novos valores.
Se chamados enquanto um escopo de evento estiver ativo, os novos metadados não serão utilizados até que o próximo escopo de evento seja iniciado.
Consulte
EventConfiguration.metadata
para obter mais detalhes sobre metadados de eventos.Declaração
Swift
public func updateMetadata(_ newMetadata: [String : String])
-
Um objeto que representa um escopo de evento ativo que pode ser usado para confirmar ou cancelar o escopo.
Veja maisDeclaração
Swift
public class Scope
-
Grave um evento personalizado.
Essa função salva os eventos no disco localmente e, em seguida, os envia de forma assíncrona para o servidor. O futuro retornado é preenchido quando os dados do evento persistem com êxito, e não quando o upload real é concluído.
Esta função não interage com escopos de eventos e pode ser chamada sem escopo ativo.
Declaração
Swift
@_disfavoredOverload func recordEvent(activity: String, eventType: String? = nil, data: String? = nil) -> Future<Void, Error>
Parâmetros
activity
O nome da atividade. Esta é uma string arbitrária armazenada como na propriedade de evento
activity
.eventType
The type of event. Esta é uma string arbitrária armazenada como na propriedade de evento
eventType
.data
A carga útil de dados para este evento. If supplied, the string stored in the
data
event property. Observe que, embora todos os eventos gerados automaticamente armazenem JSON nesse campo, os eventos personalizados não são necessários para isso.