Bonjour

Bonjour 是苹果的一套零配置网络协议，用于发现局域网内的其他设备并进行通信，比如发现打印机、手机、电视等。

一句话：发现局域网其他设备和让其他设备发现。

Bonjour 可以完成的工作

• IP 获取
• 名称解析
• 搜索服务

实际应用场景示例，HomeKit/Matter 智能设备入网后，需要通过 Bonjour 来发现设备，获取 ip，进行 http 局域网通信，获取只能设备信息，绑定用户账号等。

权限要求

Bonjour 功能需要在info.plist 开启本地网络，和指定 services。

Tips: _hap._tcp遵循了 HAP(HomeKie Accessory Protocol) 智能家居协议的硬件，会在这个服务发送数据。

类似的，Matter 配件使用服务类型为_matter._tcp

检测本地网络是否权限是否开启

苹果并没有提供本地网络权限回调和查询，所有我们并不知道用户是否拒绝了本地网络权限。

可以在StackOverflow的How to check local network permission in iOS14，iOS 14 How to trigger Local Network dialog and check user answer?中找到检测代码，还是有效的。

Bonjour 扫描服务

通过 Bonjour 发现设备的实现分为以下情况

iOS2.0 - 15.0: NSNetServiceBrowser

iOS13.0+: NWBrowser (暂不知解析 ip 方式)

虽然按照苹果的习惯，被标记过期的接口，在未来很长时间都可以使用。但是也说明苹果提供了其他方式(NWBrowser)来实现 Bonjour

流程

先搜索服务，再连接服务，最后解析ip等信息。

NSNetserviceBrowser

在 iOS2.0到 iOS15.0系统中，Bonjour 可与通过 Foundation -> Bonjour 框架中的 NetserviceBrowser 来实现扫描和服务处理。

示例代码

开始扫描

@property (nonatomic, strong) NSNetServiceBrowser *brower;- (void)startSearch {//[self.services removeAllObjects];//[self.scanDevices removeAllObjects];self.brower = [[NSNetServiceBrowser alloc] init];self.brower.delegate = self;[self.brower stop];[self.brower searchForServicesOfType:@"_hap._tcp" inDomain:@"local."];
}

NetServiceBrowserDelegate代理

/* * 即将查找服务*/
- (void)netServiceBrowserWillSearch:(NSNetServiceBrowser *)browser {NSLog(@"-----------------netServiceBrowserWillSearch");
}/* * 停止查找服务*/
- (void)netServiceBrowserDidStopSearch:(NSNetServiceBrowser *)browser {NSLog(@"-----------------netServiceBrowserDidStopSearch");
}/* * 查找服务失败*/
- (void)netServiceBrowser:(NSNetServiceBrowser *)browser didNotSearch:(NSDictionary<NSString *, NSNumber *> *)errorDict {NSLog(@"----------------netServiceBrowser didNotSearch");
}/** 发现域名服务*/
- (void)netServiceBrowser:(NSNetServiceBrowser *)browser didFindDomain:(NSString *)domainString moreComing:(BOOL)moreComing {NSLog(@"---------------netServiceBrowser didFindDomain");// 过滤服务 添加到数组中（避免服务被释放，不走代理），连接服务[self.services addObject:service];//此处添加为了避免sevice被过早释放，不走代理方法service.delegate = self;//解析服务[service resolveWithTimeout:5];
}/* * 发现客户端服务*/
- (void)netServiceBrowser:(NSNetServiceBrowser *)browser didFindService:(NSNetService *)service moreComing:(BOOL)moreComing {NSLog(@"didFindService---------=%@  =%@  =%@",service.name,service.addresses,service.hostName);[aNetService scheduleInRunLoop:[NSRunLoop currentRunLoop] forMode:NSRunLoopCommonModes];aNetService.delegate = self;[aNetService resolveWithTimeout:6];CFRunLoopRun();}/* * 域名服务移除*/
- (void)netServiceBrowser:(NSNetServiceBrowser *)browser didRemoveDomain:(NSString *)domainString moreComing:(BOOL)moreComing {NSLog(@"---------------netServiceBrowser didRemoveDomain");   
}/* * 客户端服务移除*/
- (void)netServiceBrowser:(NSNetServiceBrowser *)browser didRemoveService:(NSNetService *)service moreComing:(BOOL)moreComing {NSLog(@"---------------netServiceBrowser didRemoveService");
}

NSNetserviceDelegate

- (void)netServiceDidResolveAddress:(NSNetService *)sender{// 连接到服务,可以从 sender 中获取网络信息 比如 ip4 ip6 port 等// 进行数据通信，比如 http数据交互}

停止扫描

在业务中应该在一段时间后或者触发某些情况下关闭扫描，避免一致扫描。

[self.brower stop];

从 NSNetservice中解析网络数据

- (NSDictionary *)parsingIP:(NSNetService *)sender{int sPort = 0;NSString *ipv4;NSString *ipv6;for (NSData *address in [sender addresses]) {typedef union {struct sockaddr sa;struct sockaddr_in ipv4;struct sockaddr_in6 ipv6;} ip_socket_address;struct sockaddr *socketAddr = (struct sockaddr*)[address bytes];if(socketAddr->sa_family == AF_INET) {sPort = ntohs(((struct sockaddr_in *)socketAddr)->sin_port);struct sockaddr_in* pV4Addr = (struct sockaddr_in*)socketAddr;int ipAddr = pV4Addr->sin_addr.s_addr;char str[INET_ADDRSTRLEN];ipv4 = [NSString stringWithUTF8String:inet_ntop( AF_INET, &ipAddr, str, INET_ADDRSTRLEN )];}else if(socketAddr->sa_family == AF_INET6) {sPort = ntohs(((struct sockaddr_in6 *)socketAddr)->sin6_port);struct sockaddr_in6* pV6Addr = (struct sockaddr_in6*)socketAddr;char str[INET6_ADDRSTRLEN];ipv6 = [NSString stringWithUTF8String:inet_ntop( AF_INET6, &pV6Addr->sin6_addr, str, INET6_ADDRSTRLEN )];}else {NSLog(@"Socket Family neither IPv4 or IPv6, can't handle...");}}NSDictionary *data = @{@"type": [sender type],@"domain": [sender domain],@"name": [sender name],@"ipv4": ipv4,@"ipv6": ipv6,@"port": [NSNumber numberWithInt:sPort]};return data;
}

NWBrowser

在iOS13+在NetWork 框架中提供了 NWBrowser 类来实现 Bonjour，且只支持 Swfit.

示例代码

import Foundation
import Network
@available(iOS 13.0, *)
@objc
class BonjourManager: NSObject {@objcstatic let shared = BonjourManager()let browser = NWBrowser(for: .bonjourWithTXTRecord(type:"_hap._tcp", domain: ""), using: NWParameters())/// 搜索， 先搜索，再连接，才能解析到网络信息@objcfunc start() {browser.browseResultsChangedHandler = { (results, changes) inprint("Results:")for result in results // 建议存在数组中，注意去重{if case .service(let name,let type,let domain,let interface) = result.endpoint{// Bonjour ServicedebugPrint("Bonjour设备：\(name)")// 条件过滤let connection = NWConnection(to: result.endpoint, using: .tcp)connection.stateUpdateHandler = { state inswitch state {case .ready:if let innerEndpoint = connection.currentPath?.remoteEndpoint, case .hostPort(let host, let port) = innerEndpoint, case .ipv4(let ip4) = host {switch host {case .ipv4( let ip4):print("Bonjour \(name) ip4:\(ip4.debugDescription)")case .ipv6(let ip6):print("Bonjour ip6:\(ip6.debugDescription)")default:print("Bonjour host:\(host.debugDescription)")}}default :break}// 断开连接 connection.cancel()}connection.start(queue: .main)} else if case .hostPort(let host, let port) = result.endpoint {debugPrint("\(host)")}else{assert(false, "This nevers gets executed")}}//            print("Changes:")////            for change in changes//            {//                if case .added(let added) = change//                {//                    if case .service(let service) = added.endpoint//                    {//                        debugPrint(service)//                    }//                    else//                    {//                        assert(false, "This nevers gets executed")//                    }//                }//            }}browser.start(queue: .main)}/// 取消@objcfunc cancel() {browser.cancel()}
}

参考

官方资料

Support local network privacy in app

WWDC2020视频资料，介绍为什么需要本地网络权限，怎么设置权限，什么情况下可以不使用访问本地网络，而使用其他技术。其中以Boujour技术举例对本地网络权限的使用。

如何在你的 App 中使用组播网络

通过组播网络查看其他设备和通信。

组播在其他平台可能称为：组播DNS、mDNS 或者 DNS 服务发现

介绍本地网络权限和 Boujour info.plist 配置。以及如何利用 NWConnectionGroup 进行组播数据发送与接收。

如何获取 NWEndpoint 的 ip 信息 – stackoverflow

该问题提供了 iOS14 通过 NWBrowser 使用 Bonjour 的方式。虽然得到的是 NWEndpoint，但是可以通过 NWConnection来获取 ip 信息。