Handling Connection Requests

​

Overview

Using the connectionRequestHandler API method, you can intercept new peer connections and make decisions to accept or reject them based on the peer metadata set for a given device. (See Setting the Connection Request Handler)

Within the connectionRequestHandler you can use the connectionRequest parameter to access information about the peer connection request. (See Reading Connection Parameter)

• Peer key string — The identifier encoded as a string that uniquely identifies the requesting peer once discovered within the mesh.

• Connection type — The type of connection the peer is requesting.

• Peer metadata — The information provided by the end user associated with the peer making the request. (For more information on peer metadata, see Using Mesh Presence)

​

Setting the Connection Request Handler

To accept or reject an incoming connection request:

ditto.presence.connectionRequestHandler = { connectionRequest in
    if (true) {
        return .allow
    } else {
        return .deny
    }
}

​

Reading Connection Parameter

To see specific information associated with a requesting peer connection

ditto.presence.connectionRequestHandler = { connectionRequest in

    print(connectionRequest.peerKeyString)
    print(connectionRequest.connectionType)
    print(connectionRequest.peerMetadata)

    return .allow
}