Iniciar uma conexão
Quando dispositivos por perto são encontrados, o descoberto pode iniciar conexões. O exemplo a seguir solicita uma conexão com um dispositivo assim que ele é descoberto.
Swift
extension Example: DiscovererDelegate {
func discoverer(
_ discoverer: Discoverer, didFind endpointID: EndpointID, with context: Data) {
// An endpoint was found. We request a connection to it. The endpoint info can be used
// to provide arbitrary information to the discovering device (e.g. device name or type).
discoverer.requestConnection(to: endpointID, using: "My Device".data(using: .utf8)!)
}
func discoverer(_ discoverer: Discoverer, didLose endpointID: EndpointID) {
// A previously discovered endpoint has gone away.
}
}
Dependendo do seu caso de uso, você pode exibir uma lista de dispositivos descobertos ao usuário, permitindo que escolham a quais dispositivos se conectar.
Aceitar ou rejeitar uma conexão
Após a descoberta da solicitação de conexão, o anunciante é notificado da solicitação de conexão por meio do método delegadoadvertiser(_:didReceiveConnectionRequestFrom:with:connectionRequestHandler:)
.
Swift
extension Example: AdvertiserDelegate {
func advertiser(
_ advertiser: Advertiser, didReceiveConnectionRequestFrom endpointID: EndpointID,
with context: Data, connectionRequestHandler: @escaping (Bool) -> Void) {
// Call with `true` to accept or `false` to reject the incoming connection request.
connectionRequestHandler(true)
}
}
Depois que o anunciante aceita, os dois lados são notificados e precisam verificar a
conexão por meio do método delegado
connectionManager(_:didReceive:from:verificationHandler:)
.
É recomendado que seu app verifique a conexão usando o código de verificação fornecido pelo método delegado. Isso permite que os usuários confirmem que estão se conectando ao dispositivo pretendido. Os dois dispositivos recebem o mesmo código, que é uma string aleatória curta. Cabe a você decidir como verificá-lo. Normalmente, isso envolve mostrar o token nos dois dispositivos e pedir aos usuários para comparar e confirmar manualmente, de forma semelhante a uma caixa de diálogo de pareamento Bluetooth.
Swift
extension Example: ConnectionManagerDelegate {
func connectionManager(
_ connectionManager: ConnectionManager, didReceive verificationCode: String,
from endpointID: EndpointID, verificationHandler: @escaping (Bool) -> Void) {
// Optionally show the user the verification code. Your app should call this handler
// with a value of `true` if the nearby endpoint should be trusted, or `false`
// otherwise.
verificationHandler(true)
}
}
A conexão é totalmente estabelecida apenas quando ambos os lados a aceitam. Se um ou ambos forem rejeitados, a conexão será descartada.
Os exemplos acima mostram a conexão sendo aceita automaticamente pelos dois lados, mas, dependendo do seu caso de uso, você pode apresentar essa escolha ao usuário de alguma forma.