DittoSyncKit  1.0.0-alpha1
Public Member Functions | Protected Member Functions | Properties | List of all members
Ditto.SyncKit.DittoSyncKit Class Reference

The entrypoint to the DittoSyncKit SDK. More...

Inheritance diagram for Ditto.SyncKit.DittoSyncKit:

Public Member Functions

unsafe DittoSyncKit (DittoIdentity identity=default, string workingDir="dittosynckit")
 Initializes a new instance of the DittoSyncKit class. More...
 
unsafe void StartTcpServer (string address)
 Starts a TCP server connection. More...
 
unsafe void StartHTTPServer (string address, bool enableWebsocket, string staticPath=null, string tlsCertPath=null, string tlsKeyPath=null)
 Starts an HTTP server that other devices will be able to connect to. More...
 
unsafe void SetAccessLicense (string license)
 Activate a DittoSyncKit instance by setting an access license. You cannot interact with DittoSyncKit before you have activated it. More...
 

Protected Member Functions

override unsafe void drop (bool disposing)
 

Properties

static DittoLogLevel MinimumLogLevel [set]
 Sets the minimum logging level to be printed in the console or stdout. For example if this is set to DittoLogLevel.Warning, then only logs that are logged with the Warning or Error log levels will be shown. More...
 
bool Activated [get]
 Gets a value indicating whether or not the SDK has been activated. More...
 
unsafe uint SiteId [get]
 Gets the unique identifier of a peer in Ditto's distributed mesh network. More...
 
DittoStore Store [get]
 Gets a reference to the embedded data store. More...
 

Detailed Description

The entrypoint to the DittoSyncKit SDK.

For a DittoSyncKit instance to continue to connect to other devices it must be kept in scope.

Constructor & Destructor Documentation

◆ DittoSyncKit()

unsafe Ditto.SyncKit.DittoSyncKit.DittoSyncKit ( DittoIdentity  identity = default,
string  workingDir = "dittosynckit" 
)
inline

Initializes a new instance of the DittoSyncKit class.

Parameters
identityProvide the identity of the entity that is interacting with DittoSyncKit.
workingDirThe directory that will be used to persist DittoSyncKit data.

Member Function Documentation

◆ SetAccessLicense()

unsafe void Ditto.SyncKit.DittoSyncKit.SetAccessLicense ( string  license)
inline

Activate a DittoSyncKit instance by setting an access license. You cannot interact with DittoSyncKit before you have activated it.

Parameters
licenseThe access license.

◆ StartHTTPServer()

unsafe void Ditto.SyncKit.DittoSyncKit.StartHTTPServer ( string  address,
bool  enableWebsocket,
string  staticPath = null,
string  tlsCertPath = null,
string  tlsKeyPath = null 
)
inline

Starts an HTTP server that other devices will be able to connect to.

Parameters
addressThe address that the WebSocket server should run at.
enableWebsocketWhether to accept Ditto sync connections on this port.
staticPathAn absolute path to a directory of static files that should be served. May be null.
tlsCertPathIf using TLS, an absolute path to a file containing this server's certificate. Otherwise null.
tlsKeyPathIf using TLS, an absolute path to a file containing this server's private key. Otherwise null.

◆ StartTcpServer()

unsafe void Ditto.SyncKit.DittoSyncKit.StartTcpServer ( string  address)
inline

Starts a TCP server connection.

Parameters
addressThe address of the server to connect to.

Property Documentation

◆ Activated

bool Ditto.SyncKit.DittoSyncKit.Activated
get

Gets a value indicating whether or not the SDK has been activated.

If false then you need to call DittoSyncKit.SetAccessLicense(string) before interacting with the SDK.

◆ MinimumLogLevel

DittoLogLevel Ditto.SyncKit.DittoSyncKit.MinimumLogLevel
staticset

Sets the minimum logging level to be printed in the console or stdout. For example if this is set to DittoLogLevel.Warning, then only logs that are logged with the Warning or Error log levels will be shown.

◆ SiteId

unsafe uint Ditto.SyncKit.DittoSyncKit.SiteId
get

Gets the unique identifier of a peer in Ditto's distributed mesh network.

IMPORTANT: This must be unique or the merging and conflict resolution will have unexpected behavior.

◆ Store

DittoStore Ditto.SyncKit.DittoSyncKit.Store
get

Gets a reference to the embedded data store.