Bắt đầu kết nối
Khi tìm thấy thiết bị lân cận, người khám phá có thể bắt đầu kết nối. Ví dụ sau đây yêu cầu kết nối với thiết bị ngay khi phát hiện thiết bị.
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.
}
}
Tuỳ thuộc vào trường hợp sử dụng, bạn nên cho người dùng xem danh sách các thiết bị đã phát hiện để cho phép họ chọn thiết bị sẽ kết nối.
Chấp nhận hoặc từ chối kết nối
Sau khi người khám phá yêu cầu kết nối với một nhà quảng cáo, nhà quảng cáo đó sẽ được thông báo về yêu cầu kết nối thông qua phương thức ủy quyền advertiser(_: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)
}
}
Sau khi nhà quảng cáo chấp nhận, cả hai bên đều được thông báo và phải xác minh
kết nối thông qua phương thức ủy quyền connectionManager(_:didReceive:from:verificationHandler:).
Ứng dụng của bạn nên xác minh kết nối bằng cách sử dụng mã xác minh do phương thức uỷ quyền cung cấp. Điều này cung cấp một cách để cho phép người dùng xác nhận rằng họ đang kết nối với thiết bị dự định. Cả hai thiết bị đều được cung cấp một mã, đó là một chuỗi ngắn ngẫu nhiên; bạn có thể quyết định cách xác minh nó. Thông thường, việc này bao gồm việc hiển thị mã thông báo trên cả hai thiết bị và yêu cầu người dùng so sánh và xác nhận theo cách thủ công, tương tự như hộp thoại ghép nối 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)
}
}
Kết nối chỉ được thiết lập đầy đủ khi cả hai bên đã chấp nhận. Nếu một hoặc cả hai từ chối, kết nối sẽ bị hủy.
Các ví dụ ở trên cho thấy kết nối được tự động chấp nhận ở cả hai bên, nhưng tuỳ thuộc vào trường hợp sử dụng, bạn có thể hiển thị lựa chọn này cho người dùng theo cách nào đó.