继承:NSObject
声明处:AFNetworkActivityIndicatorManager.h
概述
AFNetworkActivityIndicatorManager管理在状态栏上的网络活动指示器的状态。当有效时,将监听一个会话任务的开始和结束的通知指示,相应地开始或停止指示器的动画。行动请求的数量在增加或减少,像一个堆或信号量,活动指示器在数量大于0时将一直播放动画。
应该在应用完成启动后,使能共享实例AFNetworkActivityIndicatorManager. 在AppDelegate的application:didFinishLaunchWithOptions:
按以下的代码完成[[AFNetworkActivityIndicatorManager sharedManager] setEnabled:YES];
.
通过设置sharedManager的enabled为YES,网络活动指示器在请求开始和完成时将自动显示和隐藏。永远不需要自己调用incrementActivityCount或decrementActivityCount。
查看《苹果人机交互指南》的Network Activity Indicator章节了解更多细节:http://developer.apple.com/library/iOS/
任务
- enabled 属性
- networkActivityIndicatorVisible 属性
- activationDelay 属性
- completionDelay 属性
- + sharedManager
- - incrementActivityCount
- - decrementActivityCount
- - setNetworkingActivityActionWithBlock:
属性
activationDelay
@property (nonatomic, assign) NSTimeInterval activationDelay
讨论
一个时间间隔标明网络活动最小持续时间,在活动指示器被显示之前网络活动应该已经发生。默认的值为1秒。 如果网络活动发生,那么网络活动指示器应该被立即显示,这个值应该设置为0秒。
Apple的HIG描述如下:
当你的应用访问网络将持续一段时间,那么显示网络活动指示器来提供反馈。如果这个操作马上结束,你不必要显示网络活动指示器,因为指示器似乎在用户注意到它的存在就消失了。
声明处
AFNetworkActivityIndicatorManager.h
completionDelay
@property (nonatomic, assign) NSTimeInterval completionDelay
讨论
一段时间间隔表明没有网络活动的一段时间,必须是在活动指示器失效之前。这个允许连续显示网络活动指示器跨越多个请求。默认值为0.17秒。
声明处
AFNetworkActivityIndicatorManager.h
enabled
@property (nonatomic, assign, getter=isEnabled) BOOL enabled
讨论
一个布尔值表明管理者是否生效。
如果设置为YES,管理者将根据接受到的网络操作通知改变状态栏的网络活动指示器。默认值为NO。
声明处
AFNetworkActivityIndicatorManager.h
networkActivityindicatorVisible
@property (readonly, nonatomic, assign, getter=isNetworkActivityIndicatorVisible) BOOL networkActivityIndicatorVisible
讨论
一个布尔值表明网络活动指示器管理当前是否有效的。
声明处
AFNetworkActivityIndicatorManager.h
类方法
sharedManager
+ (instancetype)sharedManager
讨论
返回系统的共享网络活动指示器管理者对象。
返回值
全系统的网络活动指示器管理者。
声明处
AFNetworkActivityIndicatorManager.h
实例方法
decrementActivityCount
- (void)decrementActivityCount
讨论
渐减活动网络请求数量。当减少后这个数值为0, 状态栏上的网络活动指示器停止动画。
声明处
AFNetworkActivityIndicatorManager.h
incrementActivityCount
- (void)incrementActivityCount
讨论
增加有效的网络请求数量。如果增加之前数值为0,状态栏上的网络活动指示器将开始动画。
声明处
AFNetworkActivityIndicatorManager.h
setNetworkingActivityActionWithBlock:
- (void)setNetworkingActivityActionWithBlock:(nullable void ( ^ ) ( BOOL networkActivityIndicatorVisible ))block
讨论
设置一个自定义的方法当网络活动指示器管理者可以隐藏/显示时被执行。默认情况下,这个值为空,应用网络活动指示器将自动管理。如果这个块被设置了,调用者将负责之后的网络活动指示器。
参数
block
一个块在网络活动指示器状态改变时被执行。
声明处
AFNetworkActivityIndicatorManager.h
// END 对系统的网络活动指示器的封装啊。