CircularProgressView: An Objective-C repository from ZHONGHuanGit

Update Information

The origin CircularProgressView used AVAudioPlayer to play music, the defect is that it can't support the music from the Internet, it just support the local music file. Here we use MPMoviePlayerController, which support the music from the Internet to update the CircularProgressView.

原始的CircularProgressView使用AVAudioPlayer播放音乐，缺点是它不支持网络上的音乐，它仅仅支持播放本地音乐文件。这里我们使用MPMoviePlayerController 去更新CircularProgressView，它支持播放网络上的音乐。

###Introduction 简介 A custom audio circular progress view for iOS.You can customlize its frame,background circle color & progress circle color and circle width as you wish. 一个iOS圆形进度条开源库，你可以定制它的大小、进度条背景色和前景色以及进度条的宽度。

###Latest Update 最新更新内容 Now you can drag the progress to precise location to where it should to play.
现在支持拖拽进度以便精确控制播放进度。

###Installation 安装方法

Drop "CircularProgressView.h" & "CircularProgressView.m" into your project.
将“CircularProgressView.h“和”CircularProgressView.m“文件拖拽至工程目录。

###Usage 使用方法 First in your ViewController import the header file CircularProgressView.h, and create a CircularProgressView property to keep a reference:
首先在你的ViewController中导入CircularProgressView.h头文件并且新建一个圆形进度条属性来作为一个引用:
@property (nonatomic) CircularProgressView *circularProgressView;
Then you can create circular progress view by Interface Builder or by code.
之后你可以通过Interface Builder方式或者写代码的方式新建一个圆形进度条。

1.To create by using Interface Builder:
1.通过Interface Builder建立:
Drop a UIView object into your xib or storyboard file, modify its class name to CircularProgressView:
在你的Xib或者故事版文件中放下一个UIView对象，修改它的类名为CircularProgressView:

then define circular progress view propertys in viewDidLoad method like this:
之后如下方式在viewDidLoad方法中定义圆形进度条的属性:

self.circularProgressView.backColor = [UIColor colorWithRed:236.0 / 255.0
                                                      green:236.0 / 255.0
                                                       blue:236.0 / 255.0
                                                      alpha:1.0];
self.circularProgressView.progressColor = [UIColor colorWithRed:82.0 / 255.0
                                                          green:135.0 / 255.0
                                                           blue:237.0 / 255.0
                                                          alpha:1.0];
self.circularProgressView.audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];

self.circularProgressView.lineWidth = 20;

//set CircularProgressView delegate
self.circularProgressView.delegate = self;

2.To create the object using codes like this:
2.用写代码的方式建立对象:

//get a audio path
NSURL *audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];
//set back color & progress color
UIColor *backColor = [UIColor colorWithRed:236.0/255.0 
       								 green:236.0/255.0 
		     						  blue:236.0/255.0 
			    					 alpha:1.0];
UIColor *progressColor = [UIColor colorWithRed:82.0/255.0 
								       	green:135.0/255.0 
									     blue:237.0/255.0 
									    alpha:1.0];

//alloc CircularProgressView instance
self.circularProgressView = [[CircularProgressView alloc] initWithFrame:CGRectMake(41, 57, 238, 238) 
														  backColor:backColor 
													  progressColor:progressColor 
														  lineWidth:30 
														  audioURL:audioURL];
//set CircularProgressView delegate
self.circularProgressView.delegate = self;
//add CircularProgressView
[self.view addSubview:self.circularProgressView];

###Methods 方法 You can play,pause & stop audio by below methods declared in the header file CircularProgressView.h
你可以通过如下方法播放、暂停或者停止音频，这些方法声明在CircularProgressView.h头文件中:

- (void)play;
- (void)pause;
- (void)stop;

###Version History 版本信息

version 1.5
Replace NSTimer with CADisplayLink.
用CADisplayLink替换NSTimer。
version 1.4
Update to supporting Xcode5. Add animation to tap & drag gesture.
升级支持到Xcode5，加入点击与拖拽的手势动画。
version 1.3
Add response drag progress view gesture.
加入对拖拽进度手势的响应。
version 1.2
Add initWithCoder method for creating instance from Interface Builder.
加入对通过Interface Builder建立实例的初始化方法initWithCoder方法的支持。
version 1.1
Make code easy to read,add licenece and pics.
让代码更易读，加入许可证和截图。
version 1.0
Initial version.
初始版本。

##Requirements 系统要求

iOS >= 4.3
ARC-

The MIT License (MIT)

ZHONGHuanGit/CircularProgressView

Update Information