DittoBase

abstract class DittoBase @JvmOverloads constructor(dependencies: DittoDependencies, identity: DittoIdentity)

Base class for accessing Ditto-related functionality in the Android and Java SDKs. Use the Ditto class for your platform to create an instance.

Parameters

dependencies

the dependencies required by the SDK to be initialised.

identity

the identity to be used to represent the connected client.

Constructors

DittoBase

@JvmOverloads

fun DittoBase(dependencies: DittoDependencies, identity: DittoIdentity = DittoIdentity.OfflinePlayground(dependencies))

Creates a Ditto instance.

Types

Companion

object Companion

Functions

allDisabledTransportsConfig

abstract fun allDisabledTransportsConfig(): DittoTransportConfig

Since transports vary by platform, subclasses must implement this to return a config appropriate for the platform.

getTransportDiagnostics

fun getTransportDiagnostics(): DittoTransportDiagnostics

Request bulk status information about the transports. This is mostly intended for statistical or debugging purposes.

observePeers

~~fun~~ ~~observePeers~~(~~handler~~: (List<DittoRemotePeer>) -> Unit): DittoPeersObserver

~~fun~~ ~~observePeers~~(~~callback~~: DittoPeersObserverCallback): DittoPeersObserver

Request information about Ditto peers connected to this device.

observePeersV2

fun observePeersV2(handler: (String) -> Unit): DittoPeersObserver

fun observePeersV2(callback: DittoPeersObserverV2Callback): DittoPeersObserver

Request information about Ditto peers in the local peer-to-peer network. The V2 observer differs from observePeers by providing not just information about the immediate peers, but also multihop information from other peers not immediately connected. V2 presence therefore offers a more complete view of the local peer-to-peer network.

runGarbageCollection

fun runGarbageCollection()

Removes all sync metadata for any remote peers which aren't currently connected. This method shouldn't usually be called. Manually running garbage collection often will result in slower sync times. Ditto automatically runs a garbage a collection process in the background at optimal times.

setOfflineOnlyLicenseToken

fun setOfflineOnlyLicenseToken(licenseToken: String)

Activate an offline Ditto instance by setting a license token. You cannot sync with Ditto before you have activated it. The offline license token is only valid for manual, offlinePlayground, and sharedKey identities.

startSync

open fun startSync()

Starts the network transports. Ditto will connect to other devices and sync with them where appropriate.

stopSync

open fun stopSync()

Stops all network transports.