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