You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
3.0 KiB
79 lines
3.0 KiB
/* |
|
* Copyright 2017 Google |
|
* |
|
* Licensed under the Apache License, Version 2.0 (the "License"); |
|
* you may not use this file except in compliance with the License. |
|
* You may obtain a copy of the License at |
|
* |
|
* http://www.apache.org/licenses/LICENSE-2.0 |
|
* |
|
* Unless required by applicable law or agreed to in writing, software |
|
* distributed under the License is distributed on an "AS IS" BASIS, |
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
* See the License for the specific language governing permissions and |
|
* limitations under the License. |
|
*/ |
|
|
|
#import <Foundation/Foundation.h> |
|
#if !TARGET_OS_WATCH |
|
#import <SystemConfiguration/SystemConfiguration.h> |
|
#endif |
|
|
|
/// Reachability Status |
|
typedef enum { |
|
kGULReachabilityUnknown, ///< Have not yet checked or been notified whether host is reachable. |
|
kGULReachabilityNotReachable, ///< Host is not reachable. |
|
kGULReachabilityViaWifi, ///< Host is reachable via Wifi. |
|
kGULReachabilityViaCellular, ///< Host is reachable via cellular. |
|
} GULReachabilityStatus; |
|
|
|
const NSString *GULReachabilityStatusString(GULReachabilityStatus status); |
|
|
|
@class GULReachabilityChecker; |
|
|
|
/// Google Analytics iOS Reachability Checker. |
|
@protocol GULReachabilityDelegate |
|
@required |
|
/// Called when network status has changed. |
|
- (void)reachability:(GULReachabilityChecker *)reachability |
|
statusChanged:(GULReachabilityStatus)status; |
|
@end |
|
|
|
/// Google Analytics iOS Network Status Checker. |
|
@interface GULReachabilityChecker : NSObject |
|
|
|
/// The last known reachability status, or GULReachabilityStatusUnknown if the |
|
/// checker is not active. |
|
@property(nonatomic, readonly) GULReachabilityStatus reachabilityStatus; |
|
/// The host to which reachability status is to be checked. |
|
@property(nonatomic, copy, readonly) NSString *host; |
|
/// The delegate to be notified of reachability status changes. |
|
@property(nonatomic, weak) id<GULReachabilityDelegate> reachabilityDelegate; |
|
/// `YES` if the reachability checker is active, `NO` otherwise. |
|
@property(nonatomic, readonly) BOOL isActive; |
|
|
|
/// Initialize the reachability checker. Note that you must call start to begin checking for and |
|
/// receiving notifications about network status changes. |
|
/// |
|
/// @param reachabilityDelegate The delegate to be notified when reachability status to host |
|
/// changes. |
|
/// |
|
/// @param host The name of the host. |
|
/// |
|
- (instancetype)initWithReachabilityDelegate:(id<GULReachabilityDelegate>)reachabilityDelegate |
|
withHost:(NSString *)host; |
|
|
|
- (instancetype)init NS_UNAVAILABLE; |
|
|
|
/// Start checking for reachability to the specified host. This has no effect if the status |
|
/// checker is already checking for connectivity. |
|
/// |
|
/// @return `YES` if initiating status checking was successful or the status checking has already |
|
/// been initiated, `NO` otherwise. |
|
- (BOOL)start; |
|
|
|
/// Stop checking for reachability to the specified host. This has no effect if the status |
|
/// checker is not checking for connectivity. |
|
- (void)stop; |
|
|
|
@end
|
|
|