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 mais

    Declaraçã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.