官方文件:https://developer.apple.com/library/ios/#samplecode/Reachability/Introduction/Intro.html
我下載的是 version 2.2 版本。
在開發 Web 等需要連網的應用程式時,往往需要確認目前的網路環境與連線狀況。如果沒有妥善處理這些情況,應用程式將無法通過 Apple 的審核。
Apple 的 Reachability 範例提供了取得與偵測網路狀態的方法。
要在專案中使用,只需兩個步驟:
1、將範例中的 Reachability.h 和 Reachability.m 複製到你的專案裡;
2、把 SystemConfiguration.framework 加入專案。
Reachability 定義了三種網路狀態:
typedef enum {
NotReachable = 0, // 無連線
ReachableViaWiFi, // 使用 WiFi 網路
ReachableViaWWAN // 使用 3G/GPRS 行動網路
} NetworkStatus;幾個簡單的判斷範例:
// 是否為 WiFi
+ (BOOL)IsEnableWIFI {
return ([[Reachability reachabilityForLocalWiFi] currentReachabilityStatus] != NotReachable);
}
// 是否有網路連線
+ (BOOL)IsEnableConnection {
return ([[Reachability reachabilityForInternetConnection] currentReachabilityStatus] != NotReachable);
}
// 是否為 3G
+ (BOOL)IsEnable3G {
return ([[Reachability reachabilityForInternetConnection] currentReachabilityStatus] == ReachableViaWWAN);
}
以下是監聽整個專案網路狀態變化的範例:
/* File: ReachabilityAppDelegate.m
Abstract: The application's controller.
Version: 2.2
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Inc. ("Apple")
in consideration of your agreement to the following terms. */
#import "ReachabilityAppDelegate.h"
#import "Reachability.h"
@implementation ReachabilityAppDelegate
- (void)configureTextField:(UITextField *)textField
imageView:(UIImageView *)imageView
reachability:(Reachability *)curReach {
NetworkStatus netStatus = [curReach currentReachabilityStatus];
BOOL connectionRequired = [curReach connectionRequired];
NSString *statusString = @"";
switch (netStatus) {
case NotReachable: {
statusString = @"Access Not Available";
imageView.image = [UIImage imageNamed:@"stop-32.png"];
connectionRequired = NO;
break;
}
case ReachableViaWWAN: {
statusString = @"Reachable WWAN";
imageView.image = [UIImage imageNamed:@"WWAN5.png"];
break;
}
case ReachableViaWiFi: {
statusString = @"Reachable WiFi";
imageView.image = [UIImage imageNamed:@"Airport.png"];
break;
}
}
if (connectionRequired) {
statusString = [NSString stringWithFormat:@"%@, Connection Required", statusString];
}
textField.text = statusString;
}
- (void)updateInterfaceWithReachability:(Reachability *)curReach {
if (curReach == hostReach) {
[self configureTextField:remoteHostStatusField
imageView:remoteHostIcon
reachability:curReach];
NetworkStatus netStatus = [curReach currentReachabilityStatus];
BOOL connectionRequired = [curReach connectionRequired];
summaryLabel.hidden = (netStatus != ReachableViaWWAN);
}
if (curReach == internetReach) {
[self configureTextField:internetConnectionStatusField
imageView:internetConnectionIcon
reachability:curReach];
}
if (curReach == wifiReach) {
[self configureTextField:localWiFiConnectionStatusField
imageView:localWiFiConnectionIcon
reachability:curReach];
}
}
// 當網路狀態改變時,Reachability 會呼叫此方法
- (void)reachabilityChanged:(NSNotification *)note {
Reachability *curReach = [note object];
NSParameterAssert([curReach isKindOfClass:[Reachability class]]);
[self updateInterfaceWithReachability:curReach];
}
- (void)applicationDidFinishLaunching:(UIApplication *)application {
contentView.backgroundColor = [UIColor groupTableViewBackgroundColor];
summaryLabel.hidden = YES;
// 註冊通知,狀態改變時會呼叫 reachabilityChanged:
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(reachabilityChanged:)
name:kReachabilityChangedNotification
object:nil];
hostReach = [[Reachability reachabilityWithHostName:@"www.apple.com"] retain];
[hostReach startNotifier];
[self updateInterfaceWithReachability:hostReach];
internetReach = [[Reachability reachabilityForInternetConnection] retain];
[internetReach startNotifier];
[self updateInterfaceWithReachability:internetReach];
wifiReach = [[Reachability reachabilityForLocalWiFi] retain];
[wifiReach startNotifier];
[self updateInterfaceWithReachability:wifiReach];
[window makeKeyAndVisible];
}
@end透過 startNotifier 啟動監聽,並註冊 kReachabilityChangedNotification 通知,即可在網路狀態切換時即時更新介面。