secureConnect

Deprecated

Please use secureConnectDevice(smsn) instead for simpler Amazon Sidewalk device management with consistent SMSN value.

Replace with

secureConnectDevice(sidewalkDevice.truncatedSmsn)

Note: This method is being deprecated in the near future, please use secureConnectDevice(smsn) instead for simpler Amazon Sidewalk device management with consistent SMSN value.

Securely connects to a given Amazon Sidewalk device.

You can establish a secure connect by given SidewalkDevice received from scan;

val device = sidewalk.scan()
.filter { it is SidewalkResult.Success }
.map { (it as SidewalkResult.Success).value }
.first()
val result = sidewalk.secureConnect(device)
val connection = when (result) {
is SidewalkResult.Success -> result.value
is RegisterResult.Failure -> throw result.exception
}

or provide a SidewalkDeviceDescriptor, containing device name, or endpointId. Amazon Sidewalk Mobile SDK would scan peripherals by given descriptor, and connect to the device if one found.

val result = sidewalk.secureConnect(
SidewalkDeviceDescriptor.create(
nameFilter = "MyDevice"
)
)
val connection = when (result) {
is SidewalkResult.Success -> result.value
is RegisterResult.Failure -> throw result.exception
}

Return

The result after completing establishing the connection, it returns a SidewalkConnection object when succeeds, otherwise Throwable.

Parameters

descriptor

The device to attempt to connect to.