Page Summary
-
After establishing connections between devices, data exchange can commence, encompassing various formats like byte arrays, files, or streams.
-
ConnectionManageroffers methods such assend(_:to:),startStream(_:to:), andsendResource(at:withName:to:)for initiating data transmission. -
To receive data, implement the
ConnectionManagerDelegateprotocol, providing methods to handle byte payloads, streams, file transfers, and transfer updates. -
While payloads of the same type maintain their sending order upon arrival, there's no guarantee of order preservation across different payload types.
Once connections are established between devices, you can start exchanging data. The exchanged data can take the form of a simple byte array, such as a short text message; a file, such as a photo or video; or a stream, such as the audio stream from the device’s microphone.
Data can be sent using the following connection manager instance methods:
-
send(_:to:) -
startStream(_:to:) -
sendResource(at:withName:to:)
The following connection manager delegate methods can be utilized when receiving data.
Swift
extension
Example
:
ConnectionManagerDelegate
{
func
connectionManager
(
_
connectionManager
:
ConnectionManager
,
didReceive
data
:
Data
,
withID
payloadID
:
PayloadID
,
from
endpointID
:
EndpointID
)
{
// A simple byte payload has been received. This will always include the full data.
}
func
connectionManager
(
_
connectionManager
:
ConnectionManager
,
didReceive
stream
:
InputStream
,
withID
payloadID
:
PayloadID
,
from
endpointID
:
EndpointID
,
cancellationToken
token
:
CancellationToken
)
{
// We have received a readable stream.
}
func
connectionManager
(
_
connectionManager
:
ConnectionManager
,
didStartReceivingResourceWithID
payloadID
:
PayloadID
,
from
endpointID
:
EndpointID
,
at
localURL
:
URL
,
withName
name
:
String
,
cancellationToken
token
:
CancellationToken
)
{
// We have started receiving a file. We will receive a separate transfer update
// event when complete.
}
func
connectionManager
(
_
connectionManager
:
ConnectionManager
,
didReceiveTransferUpdate
update
:
TransferUpdate
,
from
endpointID
:
EndpointID
,
forPayload
payloadID
:
PayloadID
)
{
// A success, failure, cancelation or progress update.
}
}
