IOS>> CircularProgressView>> 返回
项目作者： nijino

项目描述 ：
An audio circular progress view for iOS.You can customize its frame,background circle color & progress circle color,circle width as you wish. 一个iOS圆形进度条开源库，你可以定制它的大小、进度条背景色和前景色以及进度条的宽度。
高级语言： Objective-C
项目地址: git://github.com/nijino/CircularProgressView.git
创建时间： 2013-03-01T15:16:00Z
项目社区：https://github.com/nijino/CircularProgressView
开源协议：Other
下载


[object Object]

Build Status

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.
example pic

Latest Update

Now you can drag the progress to precise location to where it should to play.

Installation

1.Add AVFoundation.framework into your project.
2.Drop “CircularProgressView.h” & “CircularProgressView.m” into your project.

Usage

First in your ViewController import the header file CircularProgressView.h, and create a CircularProgressView property to keep a reference:
@property (nonatomic) CircularProgressView *circularProgressView;
Then you can create circular progress view by Interface Builder or by code.

1.To create by using Interface Builder:
Drop a UIView object into your xib or storyboard file, modify its class name to CircularProgressView:
xib example
then define circular progress view propertys in viewDidLoad method like this: 

  1.     self.circularProgressView.backColor = [UIColor colorWithRed:236.0 / 255.0
  2.                                                           green:236.0 / 255.0
  3.                                                            blue:236.0 / 255.0
  4.                                                           alpha:1.0];
  5.     self.circularProgressView.progressColor = [UIColor colorWithRed:82.0 / 255.0
  6.                                                               green:135.0 / 255.0
  7.                                                                blue:237.0 / 255.0
  8.                                                               alpha:1.0];
  9.     self.circularProgressView.audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];
  11.     self.circularProgressView.lineWidth = 20;
  13.     //set CircularProgressView delegate
  14.     self.circularProgressView.delegate = self;

2.To create the object using codes like this: 

  1.     //get a audio path
  2.     NSURL *audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];
  3.     //set back color & progress color
  4.     UIColor *backColor = [UIColor colorWithRed:236.0/255.0 
  5.                                             green:236.0/255.0 
  6.                                            blue:236.0/255.0 
  7.                                          alpha:1.0];
  8.     UIColor *progressColor = [UIColor colorWithRed:82.0/255.0 
  9.                                                green:135.0/255.0 
  10.                                              blue:237.0/255.0 
  11.                                             alpha:1.0];
  13.     //alloc CircularProgressView instance
  14.     self.circularProgressView = [[CircularProgressView alloc] initWithFrame:CGRectMake(41, 57, 238, 238) 
  15.                                                               backColor:backColor 
  16.                                                           progressColor:progressColor 
  17.                                                               lineWidth:30 
  18.                                                               audioURL:audioURL];
  19.     //set CircularProgressView delegate
  20.     self.circularProgressView.delegate = self;
  21.     //add CircularProgressView
  22.     [self.view addSubview:self.circularProgressView];

API

You can play,pause & stop audio by below methods declared in the header file CircularProgressView.h 

  1. - (void)play;
  2. - (void)pause;
  3. - (void)stop;

Demo

You can find a demo project in this repository.

Version History

  • version 1.5
    Replace NSTimer with CADisplayLink.

  • version 1.4
    Update to supporting Xcode5.
    Add animation to tap & drag gesture.

  • version 1.3
    Add response drag progress view gesture.

  • version 1.2
    Add initWithCoder method for creating instance from Interface Builder.

  • version 1.1
    Make code easy to read,add licenece and pics.

  • version 1.0
    Initial version.

Requirements

  • iOS >= 4.3
  • ARC

Contact

简介

一个iOS圆形进度条开源库，你可以定制它的大小、进度条背景色和前景色以及进度条的宽度。
example pic

最新更新内容

现在支持拖拽进度以便精确控制播放进度。

安装方法

1.在工程项目中加入AVFoundation.framework & QuartzCore.framework框架。
2.将“CircularProgressView.h”和“CircularProgressView.m”文件拖拽至工程目录。

使用方法

首先在你的ViewController中导入CircularProgressView.h头文件并且新建一个圆形进度条属性来作为一个引用:
@property (nonatomic) CircularProgressView *circularProgressView;
之后你可以通过Interface Builder方式或者写代码的方式新建一个圆形进度条。

1.通过Interface Builder建立:
在你的Xib或者故事版文件中放下一个UIView对象，修改它的类名为CircularProgressView:
xib example
之后如下方式在viewDidLoad方法中定义圆形进度条的属性:

  1.     self.circularProgressView.backColor = [UIColor colorWithRed:236.0 / 255.0
  2.                                                           green:236.0 / 255.0
  3.                                                            blue:236.0 / 255.0
  4.                                                           alpha:1.0];
  5.     self.circularProgressView.progressColor = [UIColor colorWithRed:82.0 / 255.0
  6.                                                               green:135.0 / 255.0
  7.                                                                blue:237.0 / 255.0
  8.                                                               alpha:1.0];
  9.     self.circularProgressView.audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];
  11.     self.circularProgressView.lineWidth = 20;
  13.     //set CircularProgressView delegate
  14.     self.circularProgressView.delegate = self;

2.用写代码的方式建立对象:

  1.     //get a audio path
  2.     NSURL *audioURL = [[NSBundle mainBundle] URLForResource:@"我的歌声里" withExtension:@"mp3"];
  3.     //set back color & progress color
  4.     UIColor *backColor = [UIColor colorWithRed:236.0/255.0 
  5.                                             green:236.0/255.0 
  6.                                            blue:236.0/255.0 
  7.                                          alpha:1.0];
  8.     UIColor *progressColor = [UIColor colorWithRed:82.0/255.0 
  9.                                                green:135.0/255.0 
  10.                                              blue:237.0/255.0 
  11.                                             alpha:1.0];
  13.     //alloc CircularProgressView instance
  14.     self.circularProgressView = [[CircularProgressView alloc] initWithFrame:CGRectMake(41, 57, 238, 238) 
  15.                                                               backColor:backColor 
  16.                                                           progressColor:progressColor 
  17.                                                               lineWidth:30 
  18.                                                               audioURL:audioURL];
  19.     //set CircularProgressView delegate
  20.     self.circularProgressView.delegate = self;
  21.     //add CircularProgressView
  22.     [self.view addSubview:self.circularProgressView];

提供接口

你可以通过如下方法播放、暂停或者停止音频，这些方法声明在CircularProgressView.h头文件中:

  1. - (void)play;
  2. - (void)pause;
  3. - (void)stop;

示例

你可以在这个开源库中找到一个示例工程。

版本信息

  • version 1.5
    用CADisplayLink替换NSTimer。

  • version 1.4
    升级支持到Xcode5，加入点击与拖拽的手势动画。

  • version 1.3
    加入对拖拽进度手势的响应。

  • version 1.2
    加入对通过Interface Builder建立实例的初始化方法initWithCoder方法的支持。

  • version 1.1
    让代码更易读，加入许可证和截图。

  • version 1.0
    初始版本。

系统要求

  • iOS >= 4.3
  • ARC

联系方式