2015-01-13 09:16 by KenshinCui, 26990 阅读, 35 评论, 收藏, 编辑html
--系统应用与系统服务ios
iOS开发过程当中有时候不免会使用iOS内置的一些应用软件和服务,例如QQ通信录、微信电话本会使用iOS的通信录,一些第三方软件会在应用内发送短信等。今天将和你们一块儿学习如何使用系统应用、使用系统服务:git
在开发某些应用时可能但愿可以调用iOS系统内置的电话、短信、邮件、浏览器应用,此时你能够直接使用UIApplication的OpenURL:方法指定特定的协议来打开不一样的系统应用。经常使用的协议以下:算法
打电话:tel:或者tel://、telprompt:或telprompt://(拨打电话前有提示)数据库
发短信:sms:或者sms://编程
发送邮件:mailto:或者mailto://json
启动浏览器:http:或者http://数组
下面以一个简单的demo演示如何调用上面几种系统应用:浏览器
//
// ViewController.m
// iOSSystemApplication
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//打电话
- (IBAction)callClicK:(UIButton *)sender {
NSString *phoneNumber=@"18500138888";
// NSString *url=[NSString stringWithFormat:@"tel://%@",phoneNumber];//这种方式会直接拨打电话
NSString *url=[NSString stringWithFormat:@"telprompt://%@",phoneNumber];//这种方式会提示用户确认是否拨打电话
[self openUrl:url];
}
//发送短信
- (IBAction)sendMessageClick:(UIButton *)sender {
NSString *phoneNumber=@"18500138888";
NSString *url=[NSString stringWithFormat:@"sms://%@",phoneNumber];
[self openUrl:url];
}
//发送邮件
- (IBAction)sendEmailClick:(UIButton *)sender {
NSString *mailAddress=@"kenshin@hotmail.com";
NSString *url=[NSString stringWithFormat:@"mailto://%@",mailAddress];
[self openUrl:url];
}
//浏览网页
- (IBAction)browserClick:(UIButton *)sender {
NSString *url=@"http://www.cnblogs.com/kenshincui";
[self openUrl:url];
}
#pragma mark - 私有方法
-(void)openUrl:(NSString *)urlStr{
//注意url中包含协议名称,iOS根据协议肯定调用哪一个应用,例如发送邮件是“sms://”其中“//”能够省略写成“sms:”(其余协议也是如此)
NSURL *url=[NSURL URLWithString:urlStr];
UIApplication *application=[UIApplication sharedApplication];
if(![application canOpenURL:url]){
NSLog(@"没法打开\"%@\",请确保此应用已经正确安装.",url);
return;
}
[[UIApplication sharedApplication] openURL:url];
}
@end
不难发现当openURL:方法只要指定一个URL Schame而且已经安装了对应的应用程序就能够打开此应用。固然,若是是本身开发的应用也能够调用openURL方法来打开。假设你如今开发了一个应用 A,若是用户机器上已经安装了此应用,而且在应用B中但愿可以直接打开A。那么首先须要确保应用A已经配置了Url Types,具体方法就是在plist文件中添加URL types节点并配置URL Schemas做为具体协议,配置URL identifier做为这个URL的惟一标识,以下图:安全
而后就能够调用openURL方法像打开系统应用同样打开第三方应用程序了:
//打开第三方应用
- (IBAction)thirdPartyApplicationClick:(UIButton *)sender {
NSString *url=@"cmj://myparams";
[self openUrl:url];
}
就像调用系统应用同样,协议后面能够传递一些参数(例如上面传递的myparams),这样一来在应用中能够在AppDelegate的 -(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation代理方法中接收参数并解析。
-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
NSString *str=[NSString stringWithFormat:@"url:%@,source application:%@,params:%@",url,sourceApplication,[url host]];
NSLog(@"%@",str);
return YES;//是否打开
}
调用系统内置的应用来发送短信、邮件至关简单,可是这么操做也存在着一些弊端:当你点击了发送短信(或邮件)操做以后直接启动了系统的短信(或邮 件)应用程序,咱们的应用其实此时已经处于一种挂起状态,发送完(短信或邮件)以后没法自动回到应用界面。若是想要在应用程序内部完成这些操做则能够利用 iOS中的MessageUI.framework,它提供了关于短信和邮件的UI接口供开发者在应用程序内部调用。从框架名称不难看出这是一套UI接 口,提供有现成的短信和邮件的编辑界面,开发人员只须要经过编程的方式给短信和邮件控制器设置对应的参数便可。
在MessageUI.framework中主要有两个控制器类分别用于发送短信 (MFMessageComposeViewController)和邮件(MFMailComposeViewController),它们均继承于 UINavigationController。因为两个类使用方法十分相似,这里主要介绍一下 MFMessageComposeViewController使用步骤:
下面自定义一个发送短信的界面演示MFMessageComposeViewController的使用:
用户经过在此界面输入短信信息点击“发送信息”调用MFMessageComposeViewController界面来展现或进一步编辑信息,点 击MFMessageComposeViewController中的“发送”来完成短信发送工做,固然用户也可能点击“取消”按钮回到前一个短信编辑页 面。
实现代码:
//
// KCSendMessageViewController.m
// iOSSystemApplication
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCSendMessageViewController.h"
#import <MessageUI/MessageUI.h>
@interface KCSendMessageViewController ()<MFMessageComposeViewControllerDelegate>
@property (weak, nonatomic) IBOutlet UITextField *receivers;
@property (weak, nonatomic) IBOutlet UITextField *body;
@property (weak, nonatomic) IBOutlet UITextField *subject;
@property (weak, nonatomic) IBOutlet UITextField *attachments;
@end
@implementation KCSendMessageViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)sendMessageClick:(UIButton *)sender {
//若是能发送文本信息
if([MFMessageComposeViewController canSendText]){
MFMessageComposeViewController *messageController=[[MFMessageComposeViewController alloc]init];
//收件人
messageController.recipients=[self.receivers.text componentsSeparatedByString:@","];
//信息正文
messageController.body=self.body.text;
//设置代理,注意这里不是delegate而是messageComposeDelegate
messageController.messageComposeDelegate=self;
//若是运行商支持主题
if([MFMessageComposeViewController canSendSubject]){
messageController.subject=self.subject.text;
}
//若是运行商支持附件
if ([MFMessageComposeViewController canSendAttachments]) {
/*第一种方法*/
//messageController.attachments=...;
/*第二种方法*/
NSArray *attachments= [self.attachments.text componentsSeparatedByString:@","];
if (attachments.count>0) {
[attachments enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
NSString *path=[[NSBundle mainBundle]pathForResource:obj ofType:nil];
NSURL *url=[NSURL fileURLWithPath:path];
[messageController addAttachmentURL:url withAlternateFilename:obj];
}];
}
/*第三种方法*/
// NSString *path=[[NSBundle mainBundle]pathForResource:@"photo.jpg" ofType:nil];
// NSURL *url=[NSURL fileURLWithPath:path];
// NSData *data=[NSData dataWithContentsOfURL:url];
/**
* attatchData:文件数据
* uti:统一类型标识,标识具体文件类型,详情查看:帮助文档中System-Declared Uniform Type Identifiers
* fileName:展示给用户看的文件名称
*/
// [messageController addAttachmentData:data typeIdentifier:@"public.image" filename:@"photo.jpg"];
}
[self presentViewController:messageController animated:YES completion:nil];
}
}
#pragma mark - MFMessageComposeViewController代理方法
//发送完成,无论成功与否
-(void)messageComposeViewController:(MFMessageComposeViewController *)controller didFinishWithResult:(MessageComposeResult)result{
switch (result) {
case MessageComposeResultSent:
NSLog(@"发送成功.");
break;
case MessageComposeResultCancelled:
NSLog(@"取消发送.");
break;
default:
NSLog(@"发送失败.");
break;
}
[self dismissViewControllerAnimated:YES completion:nil];
}
@end
这里须要强调一下:
其实只要熟悉了 MFMessageComposeViewController以后,那么用于发送邮件的MFMailComposeViewController用法和 步骤彻底一致,只是功能不一样。下面看一下MFMailComposeViewController的使用:
//
// KCSendEmailViewController.m
// iOSSystemApplication
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCSendEmailViewController.h"
#import <MessageUI/MessageUI.h>
@interface KCSendEmailViewController ()<MFMailComposeViewControllerDelegate>
@property (weak, nonatomic) IBOutlet UITextField *toTecipients;//收件人
@property (weak, nonatomic) IBOutlet UITextField *ccRecipients;//抄送人
@property (weak, nonatomic) IBOutlet UITextField *bccRecipients;//密送人
@property (weak, nonatomic) IBOutlet UITextField *subject; //主题
@property (weak, nonatomic) IBOutlet UITextField *body;//正文
@property (weak, nonatomic) IBOutlet UITextField *attachments;//附件
@end
@implementation KCSendEmailViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)sendEmailClick:(UIButton *)sender {
//判断当前是否可以发送邮件
if ([MFMailComposeViewController canSendMail]) {
MFMailComposeViewController *mailController=[[MFMailComposeViewController alloc]init];
//设置代理,注意这里不是delegate,而是mailComposeDelegate
mailController.mailComposeDelegate=self;
//设置收件人
[mailController setToRecipients:[self.toTecipients.text componentsSeparatedByString:@","]];
//设置抄送人
if (self.ccRecipients.text.length>0) {
[mailController setCcRecipients:[self.ccRecipients.text componentsSeparatedByString:@","]];
}
//设置密送人
if (self.bccRecipients.text.length>0) {
[mailController setBccRecipients:[self.bccRecipients.text componentsSeparatedByString:@","]];
}
//设置主题
[mailController setSubject:self.subject.text];
//设置内容
[mailController setMessageBody:self.body.text isHTML:YES];
//添加附件
if (self.attachments.text.length>0) {
NSArray *attachments=[self.attachments.text componentsSeparatedByString:@","] ;
[attachments enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
NSString *file=[[NSBundle mainBundle] pathForResource:obj ofType:nil];
NSData *data=[NSData dataWithContentsOfFile:file];
[mailController addAttachmentData:data mimeType:@"image/jpeg" fileName:obj];//第二个参数是mimeType类型,jpg图片对应image/jpeg
}];
}
[self presentViewController:mailController animated:YES completion:nil];
}
}
#pragma mark - MFMailComposeViewController代理方法
-(void)mailComposeController:(MFMailComposeViewController *)controller didFinishWithResult:(MFMailComposeResult)result error:(NSError *)error{
switch (result) {
case MFMailComposeResultSent:
NSLog(@"发送成功.");
break;
case MFMailComposeResultSaved://若是存储为草稿(点取消会提示是否存储为草稿,存储后能够到系统邮件应用的对应草稿箱找到)
NSLog(@"邮件已保存.");
break;
case MFMailComposeResultCancelled:
NSLog(@"取消发送.");
break;
default:
NSLog(@"发送失败.");
break;
}
if (error) {
NSLog(@"发送邮件过程当中发生错误,错误信息:%@",error.localizedDescription);
}
[self dismissViewControllerAnimated:YES completion:nil];
}
@end
运行效果:
iOS中带有一个Contacts应用程序来管理联系人,可是有些时候咱们但愿本身的应用可以访问或者修改这些信息,这个时候就要用到 AddressBook.framework框架。iOS中的通信录是存储在数据库中的,因为iOS的权限设计,开发人员是不容许直接访问通信录数据库 的,必须依靠AddressBook提供的标准API来实现通信录操做。经过AddressBook.framework开发者能够从底层去操做 AddressBook.framework的全部信息,可是须要注意的是这个框架是基于C语言编写的,没法使用ARC来管理内存,开发者须要本身管理内 存。下面大体介绍一下通信录操做中经常使用的类型:
因为通信录操做的关键是对ABRecordRef的操做,首先看一下经常使用的操做通信录记录的方法:
ABPersonCreate():建立一个类型为“kABPersonType”的ABRecordRef。
ABRecordCopyValue():取得指定属性的值。
ABRecordCopyCompositeName():取得联系人(或群组)的复合信息(对于联系人则包括:姓、名、公司等信息,对于群组则返回组名称)。
ABRecordSetValue():设置ABRecordRef的属性值。注意在设置ABRecordRef的值时又分为单值属性和多值属性: 单值属性设置只要经过ABRecordSetValue()方法指定属性名和值便可;多值属性则要先经过建立一个 ABMutableMultiValueRef类型的变量,而后经过ABMultiValueAddValueAndLabel()方法依次添加属性值, 最后经过ABRecordSetValue()方法将ABMutableMultiValueRef类型的变量设置为记录值。
ABRecordRemoveValue():删除指定的属性值。
注意:
因为联系人访问时(读取、设置、删除时)牵扯到大量联系人属性,能够到ABPerson.h中查询或者直接到帮助文档“Personal Information Properties”
通信录的访问步骤通常以下:
下面就经过一个示例演示一下如何经过ABAddressBook.framework访问通信录,这个例子中经过一个UITableViewController模拟一下通信录的查看、删除、添加操做。
主控制器视图,用于显示联系人,修改删除联系人:
KCContactViewController.h
//
// KCTableViewController.h
// AddressBook
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import <UIKit/UIKit.h>
/**
* 定义一个协议做为代理
*/
@protocol KCContactDelegate
//新增或修改联系人
-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber;
//取消修改或新增
-(void)cancelEdit;
@end
@interface KCContactTableViewController : UITableViewController
@end
KCContactViewController.m
//
// KCTableViewController.m
// AddressBook
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCContactTableViewController.h"
#import <AddressBook/AddressBook.h>
#import "KCAddPersonViewController.h"
@interface KCContactTableViewController ()<KCContactDelegate>
@property (assign,nonatomic) ABAddressBookRef addressBook;//通信录
@property (strong,nonatomic) NSMutableArray *allPerson;//通信录全部人员
@property (assign,nonatomic) int isModify;//标识是修改仍是新增,经过选择cell进行导航则认为是修改,不然视为新增
@property (assign,nonatomic) UITableViewCell *selectedCell;//当前选中的单元格
@end
@implementation KCContactTableViewController
#pragma mark - 控制器视图
- (void)viewDidLoad {
[super viewDidLoad];
//请求访问通信录并初始化数据
[self requestAddressBook];
}
//因为在整个视图控制器周期内addressBook都驻留在内存中,全部当控制器视图销毁时销毁该对象
-(void)dealloc{
if (self.addressBook!=NULL) {
CFRelease(self.addressBook);
}
}
#pragma mark - UI事件
//点击删除按钮
- (IBAction)trashClick:(UIBarButtonItem *)sender {
self.tableView.editing=!self.tableView.editing;
}
#pragma mark - UITableView数据源方法
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.allPerson.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
}
//取得一条人员记录
ABRecordRef recordRef=(__bridge ABRecordRef)self.allPerson[indexPath.row];
//取得记录中得信息
NSString *firstName=(__bridge NSString *) ABRecordCopyValue(recordRef, kABPersonFirstNameProperty);//注意这里进行了强转,不用本身释放资源
NSString *lastName=(__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonLastNameProperty);
ABMultiValueRef phoneNumbersRef= ABRecordCopyValue(recordRef, kABPersonPhoneProperty);//获取手机号,注意手机号是ABMultiValueRef类,有可能有多条
// NSArray *phoneNumbers=(__bridge NSArray *)ABMultiValueCopyArrayOfAllValues(phoneNumbersRef);//取得CFArraryRef类型的手机记录并转化为NSArrary
long count= ABMultiValueGetCount(phoneNumbersRef);
// for(int i=0;i<count;++i){
// NSString *phoneLabel= (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(phoneNumbersRef, i));
// NSString *phoneNumber=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, i));
// NSLog(@"%@:%@",phoneLabel,phoneNumber);
// }
cell.textLabel.text=[NSString stringWithFormat:@"%@ %@",firstName,lastName];
if (count>0) {
cell.detailTextLabel.text=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, 0));
}
if(ABPersonHasImageData(recordRef)){//若是有照片数据
NSData *imageData= (__bridge NSData *)(ABPersonCopyImageData(recordRef));
cell.imageView.image=[UIImage imageWithData:imageData];
}else{
cell.imageView.image=[UIImage imageNamed:@"avatar"];//没有图片使用默认头像
}
//使用cell的tag存储记录id
cell.tag=ABRecordGetRecordID(recordRef);
return cell;
}
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
ABRecordRef recordRef=(__bridge ABRecordRef )self.allPerson[indexPath.row];
[self removePersonWithRecord:recordRef];//从通信录删除
[self.allPerson removeObjectAtIndex:indexPath.row];//从数组移除
[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationFade];//从列表删除
} else if (editingStyle == UITableViewCellEditingStyleInsert) {
// Create a new instance of the appropriate class, insert it into the array, and add a new row to the table view
}
}
#pragma mark - UITableView代理方法
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
self.isModify=1;
self.selectedCell=[tableView cellForRowAtIndexPath:indexPath];
[self performSegueWithIdentifier:@"AddPerson" sender:self];
}
#pragma mark - Navigation
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
if([segue.identifier isEqualToString:@"AddPerson"]){
UINavigationController *navigationController=(UINavigationController *)segue.destinationViewController;
//根据导航控制器取得添加/修改人员的控制器视图
KCAddPersonViewController *addPersonController=(KCAddPersonViewController *)navigationController.topViewController;
addPersonController.delegate=self;
//若是是经过选择cell进行的导航操做说明是修改,不然为添加
if (self.isModify) {
UITableViewCell *cell=self.selectedCell;
addPersonController.recordID=(ABRecordID)cell.tag;//设置
NSArray *array=[cell.textLabel.text componentsSeparatedByString:@" "];
if (array.count>0) {
addPersonController.firstNameText=[array firstObject];
}
if (array.count>1) {
addPersonController.lastNameText=[array lastObject];
}
addPersonController.workPhoneText=cell.detailTextLabel.text;
}
}
}
#pragma mark - KCContact代理方法
-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
if (self.isModify) {
UITableViewCell *cell=self.selectedCell;
NSIndexPath *indexPath= [self.tableView indexPathForCell:cell];
[self modifyPersonWithRecordID:(ABRecordID)cell.tag firstName:firstName lastName:lastName workNumber:workNumber];
[self.tableView reloadRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationRight];
}else{
[self addPersonWithFirstName:firstName lastName:lastName workNumber:workNumber];//通信簿中添加信息
[self initAllPerson];//从新初始化数据
[self.tableView reloadData];
}
self.isModify=0;
}
-(void)cancelEdit{
self.isModify=0;
}
#pragma mark - 私有方法
/**
* 请求访问通信录
*/
-(void)requestAddressBook{
//建立通信录对象
self.addressBook=ABAddressBookCreateWithOptions(NULL, NULL);
//请求访问用户通信录,注意不管成功与否block都会调用
ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) {
if (!granted) {
NSLog(@"未得到通信录访问权限!");
}
[self initAllPerson];
});
}
/**
* 取得全部通信录记录
*/
-(void)initAllPerson{
//取得通信录访问受权
ABAuthorizationStatus authorization= ABAddressBookGetAuthorizationStatus();
//若是未得到受权
if (authorization!=kABAuthorizationStatusAuthorized) {
NSLog(@"还没有得到通信录访问受权!");
return ;
}
//取得通信录中全部人员记录
CFArrayRef allPeople= ABAddressBookCopyArrayOfAllPeople(self.addressBook);
self.allPerson=(__bridge NSMutableArray *)allPeople;
//释放资源
CFRelease(allPeople);
}
/**
* 删除指定的记录
*
* @param recordRef 要删除的记录
*/
-(void)removePersonWithRecord:(ABRecordRef)recordRef{
ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//删除
ABAddressBookSave(self.addressBook, NULL);//删除以后提交更改
}
/**
* 根据姓名删除记录
*/
-(void)removePersonWithName:(NSString *)personName{
CFStringRef personNameRef=(__bridge CFStringRef)(personName);
CFArrayRef recordsRef= ABAddressBookCopyPeopleWithName(self.addressBook, personNameRef);//根据人员姓名查找
CFIndex count= CFArrayGetCount(recordsRef);//取得记录数
for (CFIndex i=0; i<count; ++i) {
ABRecordRef recordRef=CFArrayGetValueAtIndex(recordsRef, i);//取得指定的记录
ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//删除
}
ABAddressBookSave(self.addressBook, NULL);//删除以后提交更改
CFRelease(recordsRef);
}
/**
* 添加一条记录
*
* @param firstName 名
* @param lastName 姓
* @param iPhoneName iPhone手机号
*/
-(void)addPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
//建立一条记录
ABRecordRef recordRef= ABPersonCreate();
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名
ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓
ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);//添加设置多值属性
ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);//添加工做电话
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
//添加记录
ABAddressBookAddRecord(self.addressBook, recordRef, NULL);
//保存通信录,提交更改
ABAddressBookSave(self.addressBook, NULL);
//释放资源
CFRelease(recordRef);
CFRelease(multiValueRef);
}
/**
* 根据RecordID修改联系人信息
*
* @param recordID 记录惟一ID
* @param firstName 姓
* @param lastName 名
* @param homeNumber 工做电话
*/
-(void)modifyPersonWithRecordID:(ABRecordID)recordID firstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
ABRecordRef recordRef=ABAddressBookGetPersonWithRecordID(self.addressBook,recordID);
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名
ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓
ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);
ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
//保存记录,提交更改
ABAddressBookSave(self.addressBook, NULL);
//释放资源
CFRelease(multiValueRef);
}
@end
新增或修改控制器视图,用于显示一个联系人的信息或者新增一个联系人:
KCAddPersonViewController.h
//
// KCAddPersonViewController.h
// AddressBook
//
// kABPersonFirstNameProperty
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import <UIKit/UIKit.h>
@protocol KCContactDelegate;
@interface KCAddPersonViewController : UIViewController
@property (assign,nonatomic) int recordID;//通信录记录id,若是ID不为0则表明修改不然认为是新增
@property (strong,nonatomic) NSString *firstNameText;
@property (strong,nonatomic) NSString *lastNameText;
@property (strong,nonatomic) NSString *workPhoneText;
@property (strong,nonatomic) id<KCContactDelegate> delegate;
@end
KCAddPersonViewController.m
//
// KCAddPersonViewController.m
// AddressBook
//
// kABPersonFirstNameProperty
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCAddPersonViewController.h"
#import "KCContactTableViewController.h"
@interface KCAddPersonViewController ()
@property (weak, nonatomic) IBOutlet UITextField *firstName;
@property (weak, nonatomic) IBOutlet UITextField *lastName;
@property (weak, nonatomic) IBOutlet UITextField *workPhone;
@end
@implementation KCAddPersonViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self setupUI];
}
#pragma mark - UI事件
- (IBAction)cancelClick:(UIBarButtonItem *)sender {
[self.delegate cancelEdit];
[self dismissViewControllerAnimated:YES completion:nil];
}
- (IBAction)doneClick:(UIBarButtonItem *)sender {
//调用代理方法
[self.delegate editPersonWithFirstName:self.firstName.text lastName:self.lastName.text workNumber:self.workPhone.text];
[self dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark - 私有方法
-(void)setupUI{
if (self.recordID) {//若是ID不为0则认为是修改,此时须要初始化界面
self.firstName.text=self.firstNameText;
self.lastName.text=self.lastNameText;
self.workPhone.text=self.workPhoneText;
}
}
@end
运行效果:
备注:
1.上文中所指的以Ref结尾的对象事实上是该对象的指针(或引用),在C语言的框架中多数类型会以Ref结尾,这个类型自己就是一个指针,定义时不须要加“*”。
2.一般方法中包含copy、create、new、retain等关键字的方法建立的变量使用以后须要调用对应的release方法释放。例如:使用ABPersonCreate();建立完ABRecordRef变量后使用CFRelease()方法释放。
3.在与不少C语言框架交互时能够都存在Obj-C和C语言类型之间的转化(特别是Obj-C和Core Foundation框架中的一些转化),此时可能会用到桥接,只要在强转以后前面加上”__bridge”便可,通过桥接转化后的类型不须要再去手动维 护内存,也就不须要使用对应的release方法释放内存。
4.AddressBook框架中不少类型的建立、属性设置等都是以这个类型名开发头的方法来建立的,事实上若是你们熟悉了其余框架会发现也都是类 似的,这是Apple开发中约定俗成的命名规则(特别是C语言框架)。例如:要给ABRecordRef类型的变量设置属性则能够经过 ABRecordSetValue()方法完成。
使用AddressBook.framework来操做通信录特色就是能够对通信录有更加精确的控制,可是缺点就是面对大量C语言API稍嫌麻烦, 因而Apple官方提供了另外一套框架供开发者使用,那就是AddressBookUI.framework。例如前面查看、新增、修改人员的界面这个框架 就提供了现成的控制器视图供开发者使用。下面是这个框架中提供的控制器视图:
以上三个控制器视图均继承于UIViewController,在使用过程当中必须使用一个UINavigationController进行包装, 不然只能看到视图内容没法进行操做(例如对于ABNewPersonViewController若是不使用 UINavigationController进行包装则没有新增和取消按钮),同时注意包装后的控制器视图不须要处理具体新增、修改逻辑(增长和修改的 处理逻辑对应的控制器视图内部已经完成),可是必须处理控制器的关闭操做(调用dismissViewControllerAnimated::方法), 而且能够经过代理方法得到新增、修改的联系人。下面看一下三个控制器视图的代理方法:
1.ABPersonViewController的displayViewDelegate代理方法:
-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:此方法会在选择了一个联系人属性后触发,四个参数分别表明:使用的控制器视图、所查看的联系人、所选则的联系人属性、该属性是不是多值属性。
2.ABNewPersonViewController的newPersonViewDelegate代理方法:
-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person:点击取消或完成后触发,若是参数中的person为NULL说明点击了取消,不然说明点击了完成。不管是取消仍是完成操做,此方法调用时保存操做已经进行完毕,不须要在此方法中本身保存联系人信息。
3.ABUnkownPersonViewcontroller的unkownPersonViewDelegate代理方法:
-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person:保存此联系人时调用,调用后将此联系人返回。
-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:选择一个位置联系人属性以后执行,返回值表明是否执行默认的选择操做(例如若是是手机号,默认操做会拨打此电话)
除了上面三类控制器视图在AddressBookUI中还提供了另一个控制器视图 ABPeoplePickerNavigationController,它与以前介绍的UIImagePickerController、 MPMediaPickerController相似,只是他是用来选择一个联系人的。这个控制器视图自己继承于 UINavigationController,视图自身的“组”、“取消”按钮操做不须要开发者来完成(例如开发者不用在点击取消是关闭当前控制器视 图,它自身已经实现了关闭方法),固然这里主要说一下这个控制器视图的peoplePickerDelegate代理方法:
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person: 选择一个联系人后执行。此代理方法实现后代理方法“-(void)peoplePickerNavigationController: (ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier”不会再执行。而且一旦实现了这个代理方法用户只能选择到 联系人视图,没法查看具体联系人的信息。
-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker:用户点击取消后执行。
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:选择联系人具体的属性后执行,注意如 果要执行此方法则不能实现-(void)peoplePickerNavigationController: (ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person代理方法,此时若是点击一个具体联系人会导航到联系人详细信息界面,用户点击具 体的属性后触发此方法。
下面就看一下上面四个控制器视图的使用方法,在下面的程序中定义了四个按钮,点击不一样的按钮调用不一样的控制器视图用于演示:
//
// ViewController.m
// AddressBookUI
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <AddressBookUI/AddressBookUI.h>
@interface ViewController ()<ABNewPersonViewControllerDelegate,ABUnknownPersonViewControllerDelegate,ABPeoplePickerNavigationControllerDelegate,ABPersonViewControllerDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//添加联系人
- (IBAction)addPersonClick:(UIButton *)sender {
ABNewPersonViewController *newPersonController=[[ABNewPersonViewController alloc]init];
//设置代理
newPersonController.newPersonViewDelegate=self;
//注意ABNewPersonViewController必须包装一层UINavigationController才能使用,不然不会出现取消和完成按钮,没法进行保存等操做
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:newPersonController];
[self presentViewController:navigationController animated:YES completion:nil];
}
//
- (IBAction)unknownPersonClick:(UIButton *)sender {
ABUnknownPersonViewController *unknownPersonController=[[ABUnknownPersonViewController alloc]init];
//设置未知人员
ABRecordRef recordRef=ABPersonCreate();
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, @"Kenshin", NULL);
ABRecordSetValue(recordRef, kABPersonLastNameProperty, @"Cui", NULL);
ABMultiValueRef multiValueRef=ABMultiValueCreateMutable(kABStringPropertyType);
ABMultiValueAddValueAndLabel(multiValueRef, @"18500138888", kABHomeLabel, NULL);
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
unknownPersonController.displayedPerson=recordRef;
//设置代理
unknownPersonController.unknownPersonViewDelegate=self;
//设置其余属性
unknownPersonController.allowsActions=YES;//显示标准操做按钮
unknownPersonController.allowsAddingToAddressBook=YES;//是否容许将联系人添加到地址簿
CFRelease(multiValueRef);
CFRelease(recordRef);
//使用导航控制器包装
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:unknownPersonController];
[self presentViewController:navigationController animated:YES completion:nil];
}
- (IBAction)showPersonClick:(UIButton *)sender {
ABPersonViewController *personController=[[ABPersonViewController alloc]init];
//设置联系人
ABAddressBookRef addressBook=ABAddressBookCreateWithOptions(NULL, NULL);
ABRecordRef recordRef= ABAddressBookGetPersonWithRecordID(addressBook, 1);//取得id为1的联系人记录
personController.displayedPerson=recordRef;
//设置代理
personController.personViewDelegate=self;
//设置其余属性
personController.allowsActions=YES;//是否显示发送信息、共享联系人等按钮
personController.allowsEditing=YES;//容许编辑
// personController.displayedProperties=@[@(kABPersonFirstNameProperty),@(kABPersonLastNameProperty)];//显示的联系人属性信息,默认显示全部信息
//使用导航控制器包装
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:personController];
[self presentViewController:navigationController animated:YES completion:nil];
}
- (IBAction)selectPersonClick:(UIButton *)sender {
ABPeoplePickerNavigationController *peoplePickerController=[[ABPeoplePickerNavigationController alloc]init];
//设置代理
peoplePickerController.peoplePickerDelegate=self;
[self presentViewController:peoplePickerController animated:YES completion:nil];
}
#pragma mark - ABNewPersonViewController代理方法
//完成新增(点击取消和完成按钮时调用),注意这里不用作实际的通信录增长工做,此代理方法调用时已经完成新增,当保存成功的时候参数中得person会返回保存的记录,若是点击取消person为NULL
-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person{
//若是有联系人信息
if (person) {
NSLog(@"%@ 信息保存成功.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}else{
NSLog(@"点击了取消.");
}
//关闭模态视图窗口
[self dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark - ABUnknownPersonViewController代理方法
//保存未知联系人时触发
-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person{
if (person) {
NSLog(@"%@ 信息保存成功!",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}
[self dismissViewControllerAnimated:YES completion:nil];
}
//选择一我的员属性后触发,返回值YES表示触发默认行为操做,不然执行代理中自定义的操做
-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
if (person) {
NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
}
return NO;
}
#pragma mark - ABPersonViewController代理方法
//选择一我的员属性后触发,返回值YES表示触发默认行为操做,不然执行代理中自定义的操做
-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
if (person) {
NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
}
return NO;
}
#pragma mark - ABPeoplePickerNavigationController代理方法
//选择一个联系人后,注意这个代理方法实现后属性选择的方法将不会再调用
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person{
if (person) {
NSLog(@"选择了%@.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}
}
//选择属性以后,注意若是上面的代理方法实现后此方法不会被调用
//-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
// if (person && property) {
// NSLog(@"选择了属性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
// }
//}
//点击取消按钮
-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker{
NSLog(@"取消选择.");
}
@end
运行效果:
注意:
为了让你们能够更加清楚的看到几个控制器视图的使用,这里并无结合前面的UITableViewController来使用,事实上你们结合前面UITableViewController能够作一个完善的通信录应用。
随着蓝牙低功耗技术BLE(Bluetooth Low Energy)的发展,蓝牙技术正在一步步成熟,现在的大部分移动设备都配备有蓝牙4.0,相比以前的蓝牙技术耗电量大大下降。从iOS的发展史也不难看 出苹果目前对蓝牙技术也是愈来愈关注,例如苹果于2013年9月发布的iOS7就配备了iBeacon技术,这项技术彻底基于蓝牙传输。可是众所周知苹果 的设备对于权限要求也是比较高的,所以在iOS中并不能像Android同样随意使用蓝牙进行文件传输(除非你已经越狱)。在iOS中进行蓝牙传输应用开 发经常使用的框架有以下几种:
GameKit.framework:iOS7以前的蓝牙通信框架,从iOS7开始过时,可是目前多数应用仍是基于此框架。
MultipeerConnectivity.framework:iOS7开始引入的新的蓝牙通信开发框架,用于取代GameKit。
CoreBluetooth.framework:功能强大的蓝牙开发框架,要求设备必须支持蓝牙4.0。
前两个框架使用起来比较简单,可是缺点也比较明显:仅仅支持iOS设备,传输内容仅限于沙盒或者照片库中用户选择的文件,而且第一个框架只能在同一 个应用之间进行传输(一个iOS设备安装应用A,另外一个iOS设备上安装应用B是没法传输的)。固然CoreBluetooth就摆脱了这些束缚,它再也不 局限于iOS设备之间进行传输,你能够经过iOS设备向Android、Windows Phone以及其余安装有蓝牙4.0芯片的智能设备传输,所以也是目前智能家居、无线支付等热门智能设备所推崇的技术。
其实从名称来看这个框架并非专门为了支持蓝牙传输而设计的,它是为游戏设计的。而不少游戏中会用到基于蓝牙的点对点信息传输,所以这个框架中集成 了蓝牙传输模块。前面也说了这个框架自己有不少限制,可是在iOS7以前的不少蓝牙传输都是基于此框架的,因此有必要对它进行了解。GameKit中的蓝 牙使用设计很简单,并无给开发者留有太多的复杂接口,而多数链接细节开发者是不须要关注的。GameKit中提供了两个关键类来操做蓝牙链接:
GKPeerPickerController:蓝牙查找、链接用的视图控制器,一般状况下应用程序A打开后会调用此控制器的show方法来展现一 个蓝牙查找的视图,一旦发现了另外一个一样在查找蓝牙链接的客户客户端B就会出如今视图列表中,此时若是用户点击链接B,B客户端就会询问用户是否容许A连 接B,若是容许后A和B之间创建一个蓝牙链接。
GKSession:链接会话,主要用于发送和接受传输数据。一旦A和B创建链接GKPeerPickerController的代理方法会将A、B二者创建的会话(GKSession)对象传递给开发人员,开发人员拿到此对象能够发送和接收数据。
其实理解了上面两个类以后,使用起来就比较简单了,下面就以一个图片发送程序来演示GameKit中蓝牙的使用。此程序一个客户端运行在模拟器上做 为客户端A,另外一个运行在iPhone真机上做为客户端B(注意A、B必须运行同一个程序,GameKit蓝牙开发是不支持两个不一样的应用传输数据的)。 两个程序运行以后均调用GKPeerPickerController来发现周围蓝牙设备,一旦A发现了B以后就开始链接B,而后iOS会询问用户是否接 受链接,一旦接受以后就会调用GKPeerPickerController的-(void)peerPickerController:(GKPeerPickerController *)picker didConnectPeer:(NSString *)peerID toSession:(GKSession *)session代理方法,在此方法中能够得到链接的设备id(peerID)和链接会话(session);此时能够设置会话的数据接收句柄(至关于一个代理)并保存会话以便发送数据时使用;一旦一端(假设是A)调用会话的sendDataToAllPeers: withDataMode: error:方法发送数据,此时另外一端(假设是B)就会调用句柄的- (void) receiveData:(NSData *)data fromPeer:(NSString *)peer inSession: (GKSession *)session context:(void *)context方法,在此方法能够得到发送数据并处理。下面是程序代码:
//
// ViewController.m
// GameKit
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <GameKit/GameKit.h>
@interface ViewController ()<GKPeerPickerControllerDelegate,UIImagePickerControllerDelegate,UINavigationBarDelegate>
@property (weak, nonatomic) IBOutlet UIImageView *imageView;//照片显示视图
@property (strong,nonatomic) GKSession *session;//蓝牙链接会话
@end
@implementation ViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
GKPeerPickerController *pearPickerController=[[GKPeerPickerController alloc]init];
pearPickerController.delegate=self;
[pearPickerController show];
}
#pragma mark - UI事件
- (IBAction)selectClick:(UIBarButtonItem *)sender {
UIImagePickerController *imagePickerController=[[UIImagePickerController alloc]init];
imagePickerController.delegate=self;
[self presentViewController:imagePickerController animated:YES completion:nil];
}
- (IBAction)sendClick:(UIBarButtonItem *)sender {
NSData *data=UIImagePNGRepresentation(self.imageView.image);
NSError *error=nil;
[self.session sendDataToAllPeers:data withDataMode:GKSendDataReliable error:&error];
if (error) {
NSLog(@"发送图片过程当中发生错误,错误信息:%@",error.localizedDescription);
}
}
#pragma mark - GKPeerPickerController代理方法
/**
* 链接到某个设备
*
* @param picker 蓝牙点对点链接控制器
* @param peerID 链接设备蓝牙传输ID
* @param session 链接会话
*/
-(void)peerPickerController:(GKPeerPickerController *)picker didConnectPeer:(NSString *)peerID toSession:(GKSession *)session{
self.session=session;
NSLog(@"已链接客户端设备:%@.",peerID);
//设置数据接收处理句柄,至关于代理,一旦数据接收完成调用它的-receiveData:fromPeer:inSession:context:方法处理数据
[self.session setDataReceiveHandler:self withContext:nil];
[picker dismiss];//一旦链接成功关闭窗口
}
#pragma mark - 蓝牙数据接收方法
- (void) receiveData:(NSData *)data fromPeer:(NSString *)peer inSession: (GKSession *)session context:(void *)context{
UIImage *image=[UIImage imageWithData:data];
self.imageView.image=image;
UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
NSLog(@"数据发送成功!");
}
#pragma mark - UIImagePickerController代理方法
-(void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info{
self.imageView.image=[info objectForKey:UIImagePickerControllerOriginalImage];
[self dismissViewControllerAnimated:YES completion:nil];
}
-(void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{
[self dismissViewControllerAnimated:YES completion:nil];
}
@end
运行效果(左侧是真机,右侧是模拟器,程序演示了两个客户端互发图片的场景:首先是模拟器发送图片给真机,而后真机发送图片给模拟器):
前面已经说了GameKit相关的蓝牙操做类从iOS7已经所有过时,苹果官方推荐使用MultipeerConnectivity代替。可是应该 了解,MultipeerConnectivity.framework并不只仅支持蓝牙链接,准确的说它是一种支持Wi-Fi网络、P2P Wi-Fi已经蓝牙我的局域网的通讯框架,它屏蔽了具体的链接技术,让开发人员有统一的接口编程方法。经过MultipeerConnectivity连 接的节点之间能够安全的传递信息、流或者其余文件资源而没必要经过网络服务。此外使用MultipeerConnectivity进行近场通讯也再也不局限于 同一个应用之间传输,而是能够在不一样的应用之间进行数据传输(固然若是有必要的话你仍然能够选择在一个应用程序之间传输)。
要了解MultipeerConnectivity的使用必需要清楚一个概念:广播(Advertisting)和发现 (Disconvering),这很相似于一种Client-Server模式。假设有两台设备A、B,B做为广播去发送自身服务,A做为发现的客户端。 一旦A发现了B就试图创建链接,通过B赞成两者创建链接就能够相互发送数据。在使用GameKit框架时,A和B既做为广播又做为发现,固然这种状况在 MultipeerConnectivity中也很常见。
A.广播
不管是做为服务器端去广播仍是做为客户端去发现广播服务,那么两个(或更多)不一样的设备之间必需要有区分,一般状况下使用MCPeerID对象来区 分一台设备,在这个设备中能够指定显示给对方查看的名称(display name)。另外无论是哪一方,还必须创建一个会话MCSession用于发送和接受数据。一般状况下会在会话的-(void)session:(MCSession *)session peer:(MCPeerID *)peerID didChangeState:(MCSessionState)state代理方法中跟踪会话状态(已链接、正在链接、未链接);在会话的-(void)session:(MCSession *)session didReceiveData:(NSData *)data fromPeer:(MCPeerID *)peerID代理方法中接收数据;同时还会调用会话的-(void)sendData: toPeers:withMode: error:方法去发送数据。
广播做为一个服务器去发布自身服务,供周边设备发现链接。在MultipeerConnectivity中使用 MCAdvertiserAssistant来表示一个广播,一般建立广播时指定一个会话MCSession对象将广播服务和会话关联起来。一旦调用广播 的start方法周边的设备就能够发现该广播并能够链接到此服务。在MCSession的代理方法中能够随时更新链接状态,一旦创建了链接以后就能够经过 MCSession的connectedPeers得到已经链接的设备。
B.发现
前面已经说过做为发现的客户端一样须要一个MCPeerID来标志一个客户端,同时会拥有一个MCSession来监听链接状态并发送、接受数据。 除此以外,要发现广播服务,客户端就必需要随时查找服务来链接,在MultipeerConnectivity中提供了一个控制器 MCBrowserViewController来展现可链接和已链接的设备(这相似于GameKit中的 GKPeerPickerController),固然若是想要本身定制一个界面来展现设备链接的状况你能够选择本身开发一套UI界面。一旦经过 MCBroserViewController选择一个节点去链接,那么做为广播的节点就会收到通知,询问用户是否容许链接。因为初始化 MCBrowserViewController的过程已经指定了会话MCSession,因此链接过程当中会随时更新会话状态,一旦创建了链接,就能够通 过会话的connected属性得到已链接设备而且可使用会话发送、接受数据。
下面用两个不一样的应用程序来演示使用MultipeerConnectivity的使用过程,其中一个应用运行在模拟器中做为广播节点,另外一个运行在iPhone真机上做为发现节点,而且实现两个节点的图片互传。
首先看一下做为广播节点的程序:
界面:
点击“开始广播”来发布服务,一旦有节点链接此服务就可使用“选择照片”来从照片库中选取一张图片并发送到全部已链接节点。
程序:
//
// ViewController.m
// MultipeerConnectivity_Advertiser
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <MultipeerConnectivity/MultipeerConnectivity.h>
@interface ViewController ()<MCSessionDelegate,MCAdvertiserAssistantDelegate, UIImagePickerControllerDelegate,UINavigationControllerDelegate>
@property (strong,nonatomic) MCSession *session;
@property (strong,nonatomic) MCAdvertiserAssistant *advertiserAssistant;
@property (strong,nonatomic) UIImagePickerController *imagePickerController;
@property (weak, nonatomic) IBOutlet UIImageView *photo;
@end
@implementation ViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
//建立节点,displayName是用于提供给周边设备查看和区分此服务的
MCPeerID *peerID=[[MCPeerID alloc]initWithDisplayName:@"KenshinCui_Advertiser"];
_session=[[MCSession alloc]initWithPeer:peerID];
_session.delegate=self;
//建立广播
_advertiserAssistant=[[MCAdvertiserAssistant alloc]initWithServiceType:@"cmj-stream" discoveryInfo:nil session:_session];
_advertiserAssistant.delegate=self;
}
#pragma mark - UI事件
- (IBAction)advertiserClick:(UIBarButtonItem *)sender {
//开始广播
[self.advertiserAssistant start];
}
- (IBAction)selectClick:(UIBarButtonItem *)sender {
_imagePickerController=[[UIImagePickerController alloc]init];
_imagePickerController.delegate=self;
[self presentViewController:_imagePickerController animated:YES completion:nil];
}
#pragma mark - MCSession代理方法
-(void)session:(MCSession *)session peer:(MCPeerID *)peerID didChangeState:(MCSessionState)state{
NSLog(@"didChangeState");
switch (state) {
case MCSessionStateConnected:
NSLog(@"链接成功.");
break;
case MCSessionStateConnecting:
NSLog(@"正在链接...");
break;
default:
NSLog(@"链接失败.");
break;
}
}
//接收数据
-(void)session:(MCSession *)session didReceiveData:(NSData *)data fromPeer:(MCPeerID *)peerID{
NSLog(@"开始接收数据...");
UIImage *image=[UIImage imageWithData:data];
[self.photo setImage:image];
//保存到相册
UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
}
#pragma mark - MCAdvertiserAssistant代理方法
#pragma mark - UIImagePickerController代理方法
-(void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info{
UIImage *image=[info objectForKey:UIImagePickerControllerOriginalImage];
[self.photo setImage:image];
//发送数据给全部已链接设备
NSError *error=nil;
[self.session sendData:UIImagePNGRepresentation(image) toPeers:[self.session connectedPeers] withMode:MCSessionSendDataUnreliable error:&error];
NSLog(@"开始发送数据...");
if (error) {
NSLog(@"发送数据过程当中发生错误,错误信息:%@",error.localizedDescription);
}
[self.imagePickerController dismissViewControllerAnimated:YES completion:nil];
}
-(void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{
[self.imagePickerController dismissViewControllerAnimated:YES completion:nil];
}
@end
再看一下做为发现节点的程序:
界面:
点击“查找设备”浏览可用服务,点击服务创建链接;一旦创建了链接以后就能够点击“选择照片”会从照片库中选择一张图片并发送给已链接的节点。
程序:
//
// ViewController.m
// MultipeerConnectivity
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <MultipeerConnectivity/MultipeerConnectivity.h>
@interface ViewController ()<MCSessionDelegate,MCBrowserViewControllerDelegate,UIImagePickerControllerDelegate,UINavigationControllerDelegate>
@property (strong,nonatomic) MCSession *session;
@property (strong,nonatomic) MCBrowserViewController *browserController;
@property (strong,nonatomic) UIImagePickerController *imagePickerController;
@property (weak, nonatomic) IBOutlet UIImageView *photo;
@end
@implementation ViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
//建立节点
MCPeerID *peerID=[[MCPeerID alloc]initWithDisplayName:@"KenshinCui"];
//建立会话
_session=[[MCSession alloc]initWithPeer:peerID];
_session.delegate=self;
}
#pragma mark- UI事件
- (IBAction)browserClick:(UIBarButtonItem *)sender {
_browserController=[[MCBrowserViewController alloc]initWithServiceType:@"cmj-stream" session:self.session];
_browserController.delegate=self;
[self presentViewController:_browserController animated:YES completion:nil];
}
- (IBAction)selectClick:(UIBarButtonItem *)sender {
_imagePickerController=[[UIImagePickerController alloc]init];
_imagePickerController.delegate=self;
[self presentViewController:_imagePickerController animated:YES completion:nil];
}
#pragma mark - MCBrowserViewController代理方法
-(void)browserViewControllerDidFinish:(MCBrowserViewController *)browserViewController{
NSLog(@"已选择");
[self.browserController dismissViewControllerAnimated:YES completion:nil];
}
-(void)browserViewControllerWasCancelled:(MCBrowserViewController *)browserViewController{
NSLog(@"取消浏览.");
[self.browserController dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark - MCSession代理方法
-(void)session:(MCSession *)session peer:(MCPeerID *)peerID didChangeState:(MCSessionState)state{
NSLog(@"didChangeState");
switch (state) {
case MCSessionStateConnected:
NSLog(@"链接成功.");
[self.browserController dismissViewControllerAnimated:YES completion:nil];
break;
case MCSessionStateConnecting:
NSLog(@"正在链接...");
break;
default:
NSLog(@"链接失败.");
break;
}
}
//接收数据
-(void)session:(MCSession *)session didReceiveData:(NSData *)data fromPeer:(MCPeerID *)peerID{
NSLog(@"开始接收数据...");
UIImage *image=[UIImage imageWithData:data];
[self.photo setImage:image];
//保存到相册
UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
}
#pragma mark - UIImagePickerController代理方法
-(void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info{
UIImage *image=[info objectForKey:UIImagePickerControllerOriginalImage];
[self.photo setImage:image];
//发送数据给全部已链接设备
NSError *error=nil;
[self.session sendData:UIImagePNGRepresentation(image) toPeers:[self.session connectedPeers] withMode:MCSessionSendDataUnreliable error:&error];
NSLog(@"开始发送数据...");
if (error) {
NSLog(@"发送数据过程当中发生错误,错误信息:%@",error.localizedDescription);
}
[self.imagePickerController dismissViewControllerAnimated:YES completion:nil];
}
-(void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{
[self.imagePickerController dismissViewControllerAnimated:YES completion:nil];
}
@end
在两个程序中不管是MCBrowserViewController仍是MCAdvertiserAssistant在初始化的时候都指定了一个服 务类型“cmj-photo”,这是惟一标识一个服务类型的标记,能够按照官方的要求命名,应该尽量表达服务的做用。须要特别指出的是,若是广播命名为 “cmj-photo”那么发现节点只有在MCBrowserViewController中指定为“cmj-photo”才能发现此服务。
运行效果:
不管是GameKit仍是MultipeerConnectivity,都只能在iOS设备之间进行数据传输,这就大大下降了蓝牙的使用范围,因而 从iOS6开始苹果推出了CoreBluetooth.framework,这个框架最大的特色就是彻底基于BLE4.0标准而且支持非iOS设备。当前 BLE应用至关普遍,再也不仅仅是两个设备之间的数据传输,它还有不少其余应用市场,例如室内定位、无线支付、智能家居等等,这也使得 CoreBluetooth成为当前最热门的蓝牙技术。
CoreBluetooth设计一样也是相似于客户端-服务器端的设计,做为服务器端的设备称为外围设备(Peripheral),做为客户端的设备叫作中央设备(Central),CoreBlueTooth整个框架就是基于这两个概念来设计的。
外围设备和中央设备在CoreBluetooth中使用CBPeripheralManager和CBCentralManager表示。
CBPeripheralManager:外围设备一般用于发布服务、生成数据、保存数据。外围设备发布并广播服务,告诉周围的中央设备它的可用服务和特征。
CBCentralManager:中央设备使用外围设备的数据。中央设备扫描到外围设备后会就会试图创建链接,一旦链接成功就可使用这些服务和特征。
外围设备和中央设备之间交互的桥梁是服务(CBService)和特征(CBCharacteristic),两者都有一个惟一的标识UUID(CBUUID类型)来惟一肯定一个服务或者特征,每一个服务能够拥有多个特征,下面是他们之间的关系:
一台iOS设备(注意iPhone4如下设备不支持BLE,另外iOS7.0、8.0模拟器也没法模拟BLE)既能够做为外围设备又能够做为中央设 备,可是不能同时便是外围设备又是中央设备,同时注意创建链接的过程不须要用户手动选择容许,这一点和前面两个框架是不一样的,这主要是由于BLE应用场景 再也不局限于两台设备之间资源共享了。
A.外围设备
建立一个外围设备一般分为如下几个步骤:
下面是简单的程序示例,程序有两个按钮“启动”和“更新”,点击启动按钮则建立外围设备、添加服务和特征并开始广播,一旦发现有中央设备链接并订阅了此服务的特征则经过更新按钮更新特征数据,此时已订阅的中央设备就会收到更新数据。
界面设计:
程序设计:
//
// ViewController.m
// PeripheralApp
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
// 外围设备(周边设备)
#import "ViewController.h"
#import <CoreBluetooth/CoreBluetooth.h>
#define kPeripheralName @"Kenshin Cui's Device" //外围设备名称
#define kServiceUUID @"C4FB2349-72FE-4CA2-94D6-1F3CB16331EE" //服务的UUID
#define kCharacteristicUUID @"6A3E4B28-522D-4B3B-82A9-D5E2004534FC" //特征的UUID
@interface ViewController ()<CBPeripheralManagerDelegate>
@property (strong,nonatomic) CBPeripheralManager *peripheralManager;//外围设备管理器
@property (strong,nonatomic) NSMutableArray *centralM;//订阅此外围设备特征的中心设备
@property (strong,nonatomic) CBMutableCharacteristic *characteristicM;//特征
@property (weak, nonatomic) IBOutlet UITextView *log; //日志记录
@end
@implementation ViewController
#pragma mark - 视图控制器方法
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//建立外围设备
- (IBAction)startClick:(UIBarButtonItem *)sender {
_peripheralManager=[[CBPeripheralManager alloc]initWithDelegate:self queue:nil];
}
//更新数据
- (IBAction)transferClick:(UIBarButtonItem *)sender {
[self updateCharacteristicValue];
}
#pragma mark - CBPeripheralManager代理方法
//外围设备状态发生变化后调用
-(void)peripheralManagerDidUpdateState:(CBPeripheralManager *)peripheral{
switch (peripheral.state) {
case CBPeripheralManagerStatePoweredOn:
NSLog(@"BLE已打开.");
[self writeToLog:@"BLE已打开."];
//添加服务
[self setupService];
break;
default:
NSLog(@"此设备不支持BLE或未打开蓝牙功能,没法做为外围设备.");
[self writeToLog:@"此设备不支持BLE或未打开蓝牙功能,没法做为外围设备."];
break;
}
}
//外围设备添加服务后调用
-(void)peripheralManager:(CBPeripheralManager *)peripheral didAddService:(CBService *)service error:(NSError *)error{
if (error) {
NSLog(@"向外围设备添加服务失败,错误详情:%@",error.localizedDescription);
[self writeToLog:[NSString stringWithFormat:@"向外围设备添加服务失败,错误详情:%@",error.localizedDescription]];
return;
}
//添加服务后开始广播
NSDictionary *dic=@{CBAdvertisementDataLocalNameKey:kPeripheralName};//广播设置
[self.peripheralManager startAdvertising:dic];//开始广播
NSLog(@"向外围设备添加了服务并开始广播...");
[self writeToLog:@"向外围设备添加了服务并开始广播..."];
}
-(void)peripheralManagerDidStartAdvertising:(CBPeripheralManager *)peripheral error:(NSError *)error{
if (error) {
NSLog(@"启动广播过程当中发生错误,错误信息:%@",error.localizedDescription);
[self writeToLog:[NSString stringWithFormat:@"启动广播过程当中发生错误,错误信息:%@",error.localizedDescription]];
return;
}
NSLog(@"启动广播...");
[self writeToLog:@"启动广播..."];
}
//订阅特征
-(void)peripheralManager:(CBPeripheralManager *)peripheral central:(CBCentral *)central didSubscribeToCharacteristic:(CBCharacteristic *)characteristic{
NSLog(@"中心设备:%@ 已订阅特征:%@.",central,characteristic);
[self writeToLog:[NSString stringWithFormat:@"中心设备:%@ 已订阅特征:%@.",central.identifier.UUIDString,characteristic.UUID]];
//发现中心设备并存储
if (![self.centralM containsObject:central]) {
[self.centralM addObject:central];
}
/*中心设备订阅成功后外围设备能够更新特征值发送到中心设备,一旦更新特征值将会触发中心设备的代理方法:
-(void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error
*/
// [self updateCharacteristicValue];
}
//取消订阅特征
-(void)peripheralManager:(CBPeripheralManager *)peripheral central:(CBCentral *)central didUnsubscribeFromCharacteristic:(CBCharacteristic *)characteristic{
NSLog(@"didUnsubscribeFromCharacteristic");
}
-(void)peripheralManager:(CBPeripheralManager *)peripheral didReceiveWriteRequests:(CBATTRequest *)request{
NSLog(@"didReceiveWriteRequests");
}
-(void)peripheralManager:(CBPeripheralManager *)peripheral willRestoreState:(NSDictionary *)dict{
NSLog(@"willRestoreState");
}
#pragma mark -属性
-(NSMutableArray *)centralM{
if (!_centralM) {
_centralM=[NSMutableArray array];
}
return _centralM;
}
#pragma mark - 私有方法
//建立特征、服务并添加服务到外围设备
-(void)setupService{
/*1.建立特征*/
//建立特征的UUID对象
CBUUID *characteristicUUID=[CBUUID UUIDWithString:kCharacteristicUUID];
//特征值
// NSString *valueStr=kPeripheralName;
// NSData *value=[valueStr dataUsingEncoding:NSUTF8StringEncoding];
//建立特征
/** 参数
* uuid:特征标识
* properties:特征的属性,例如:可通知、可写、可读等
* value:特征值
* permissions:特征的权限
*/
CBMutableCharacteristic *characteristicM=[[CBMutableCharacteristic alloc]initWithType:characteristicUUID properties:CBCharacteristicPropertyNotify value:nil permissions:CBAttributePermissionsReadable];
self.characteristicM=characteristicM;
// CBMutableCharacteristic *characteristicM=[[CBMutableCharacteristic alloc]initWithType:characteristicUUID properties:CBCharacteristicPropertyRead value:nil permissions:CBAttributePermissionsReadable];
// characteristicM.value=value;
/*建立服务而且设置特征*/
//建立服务UUID对象
CBUUID *serviceUUID=[CBUUID UUIDWithString:kServiceUUID];
//建立服务
CBMutableService *serviceM=[[CBMutableService alloc]initWithType:serviceUUID primary:YES];
//设置服务的特征
[serviceM setCharacteristics:@[characteristicM]];
/*将服务添加到外围设备*/
[self.peripheralManager addService:serviceM];
}
//更新特征值
-(void)updateCharacteristicValue{
//特征值
NSString *valueStr=[NSString stringWithFormat:@"%@ --%@",kPeripheralName,[NSDate date]];
NSData *value=[valueStr dataUsingEncoding:NSUTF8StringEncoding];
//更新特征值
[self.peripheralManager updateValue:value forCharacteristic:self.characteristicM onSubscribedCentrals:nil];
[self writeToLog:[NSString stringWithFormat:@"更新特征值:%@",valueStr]];
}
/**
* 记录日志
*
* @param info 日志信息
*/
-(void)writeToLog:(NSString *)info{
self.log.text=[NSString stringWithFormat:@"%@\r\n%@",self.log.text,info];
}
@end
上面程序运行的流程以下(图中蓝色表明外围设备操做,绿色部分表示中央设备操做):
B.中央设备
中央设备的建立通常能够分为以下几个步骤:
下面是一个简单的中央服务器端实现,点击“启动”按钮则开始扫描周围的外围设备,一旦发现了可用的外围设备则创建链接并设置外围设备的代理,以后开始查找其服务和特征。一旦外围设备的特征值作了更新,则能够在代理方法中读取更新后的特征值。
界面设计:
程序设计:
//
// ViewController.m
// CentralApp
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
// 中心设备
#import "ViewController.h"
#import <CoreBluetooth/CoreBluetooth.h>
#define kServiceUUID @"C4FB2349-72FE-4CA2-94D6-1F3CB16331EE" //服务的UUID
#define kCharacteristicUUID @"6A3E4B28-522D-4B3B-82A9-D5E2004534FC" //特征的UUID
@interface ViewController ()<CBCentralManagerDelegate,CBPeripheralDelegate>
@property (strong,nonatomic) CBCentralManager *centralManager;//中心设备管理器
@property (strong,nonatomic) NSMutableArray *peripherals;//链接的外围设备
@property (weak, nonatomic) IBOutlet UITextView *log;//日志记录
@end
@implementation ViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)startClick:(UIBarButtonItem *)sender {
//建立中心设备管理器并设置当前控制器视图为代理
_centralManager=[[CBCentralManager alloc]initWithDelegate:self queue:nil];
}
#pragma mark - CBCentralManager代理方法
//中心服务器状态更新后
-(void)centralManagerDidUpdateState:(CBCentralManager *)central{
switch (central.state) {
case CBPeripheralManagerStatePoweredOn:
NSLog(@"BLE已打开.");
[self writeToLog:@"BLE已打开."];
//扫描外围设备
// [central scanForPeripheralsWithServices:@[[CBUUID UUIDWithString:kServiceUUID]] options:@{CBCentralManagerScanOptionAllowDuplicatesKey:@YES}];
[central scanForPeripheralsWithServices:nil options:@{CBCentralManagerScanOptionAllowDuplicatesKey:@YES}];
break;
default:
NSLog(@"此设备不支持BLE或未打开蓝牙功能,没法做为外围设备.");
[self writeToLog:@"此设备不支持BLE或未打开蓝牙功能,没法做为外围设备."];
break;
}
}
/**
* 发现外围设备
*
* @param central 中心设备
* @param peripheral 外围设备
* @param advertisementData 特征数据
* @param RSSI 信号质量(信号强度)
*/
-(void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber *)RSSI{
NSLog(@"发现外围设备...");
[self writeToLog:@"发现外围设备..."];
//中止扫描
[self.centralManager stopScan];
//链接外围设备
if (peripheral) {
//添加保存外围设备,注意若是这里不保存外围设备(或者说peripheral没有一个强引用,没法到达链接成功(或失败)的代理方法,由于在此方法调用完就会被销毁
if(![self.peripherals containsObject:peripheral]){
[self.peripherals addObject:peripheral];
}
NSLog(@"开始链接外围设备...");
[self writeToLog:@"开始链接外围设备..."];
[self.centralManager connectPeripheral:peripheral options:nil];
}
}
//链接到外围设备
-(void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral{
NSLog(@"链接外围设备成功!");
[self writeToLog:@"链接外围设备成功!"];
//设置外围设备的代理为当前视图控制器
peripheral.delegate=self;
//外围设备开始寻找服务
[peripheral discoverServices:@[[CBUUID UUIDWithString:kServiceUUID]]];
}
//链接外围设备失败
-(void)centralManager:(CBCentralManager *)central didFailToConnectPeripheral:(CBPeripheral *)peripheral error:(NSError *)error{
NSLog(@"链接外围设备失败!");
[self writeToLog:@"链接外围设备失败!"];
}
#pragma mark - CBPeripheral 代理方法
//外围设备寻找到服务后
-(void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(NSError *)error{
NSLog(@"已发现可用服务...");
[self writeToLog:@"已发现可用服务..."];
if(error){
NSLog(@"外围设备寻找服务过程当中发生错误,错误信息:%@",error.localizedDescription);
[self writeToLog:[NSString stringWithFormat:@"外围设备寻找服务过程当中发生错误,错误信息:%@",error.localizedDescription]];
}
//遍历查找到的服务
CBUUID *serviceUUID=[CBUUID UUIDWithString:kServiceUUID];
CBUUID *characteristicUUID=[CBUUID UUIDWithString:kCharacteristicUUID];
for (CBService *service in peripheral.services) {
if([service.UUID isEqual:serviceUUID]){
//外围设备查找指定服务中的特征
[peripheral discoverCharacteristics:@[characteristicUUID] forService:service];
}
}
}
//外围设备寻找到特征后
-(void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(NSError *)error{
NSLog(@"已发现可用特征...");
[self writeToLog:@"已发现可用特征..."];
if (error) {
NSLog(@"外围设备寻找特征过程当中发生错误,错误信息:%@",error.localizedDescription);
[self writeToLog:[NSString stringWithFormat:@"外围设备寻找特征过程当中发生错误,错误信息:%@",error.localizedDescription]];
}
//遍历服务中的特征
CBUUID *serviceUUID=[CBUUID UUIDWithString:kServiceUUID];
CBUUID *characteristicUUID=[CBUUID UUIDWithString:kCharacteristicUUID];
if ([service.UUID isEqual:serviceUUID]) {
for (CBCharacteristic *characteristic in service.characteristics) {
if ([characteristic.UUID isEqual:characteristicUUID]) {
//情景一:通知
/*找到特征后设置外围设备为已通知状态(订阅特征):
*1.调用此方法会触发代理方法:-(void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error
*2.调用此方法会触发外围设备的订阅代理方法
*/
[peripheral setNotifyValue:YES forCharacteristic:characteristic];
//情景二:读取
// [peripheral readValueForCharacteristic:characteristic];
// if(characteristic.value){
// NSString *value=[[NSString alloc]initWithData:characteristic.value encoding:NSUTF8StringEncoding];
// NSLog(@"读取到特征值:%@",value);
// }
}
}
}
}
//特征值被更新后
-(void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error{
NSLog(@"收到特征更新通知...");
[self writeToLog:@"收到特征更新通知..."];
if (error) {
NSLog(@"更新通知状态时发生错误,错误信息:%@",error.localizedDescription);
}
//给特征值设置新的值
CBUUID *characteristicUUID=[CBUUID UUIDWithString:kCharacteristicUUID];
if ([characteristic.UUID isEqual:characteristicUUID]) {
if (characteristic.isNotifying) {
if (characteristic.properties==CBCharacteristicPropertyNotify) {
NSLog(@"已订阅特征通知.");
[self writeToLog:@"已订阅特征通知."];
return;
}else if (characteristic.properties ==CBCharacteristicPropertyRead) {
//从外围设备读取新值,调用此方法会触发代理方法:-(void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error
[peripheral readValueForCharacteristic:characteristic];
}
}else{
NSLog(@"中止已中止.");
[self writeToLog:@"中止已中止."];
//取消链接
[self.centralManager cancelPeripheralConnection:peripheral];
}
}
}
//更新特征值后(调用readValueForCharacteristic:方法或者外围设备在订阅后更新特征值都会调用此代理方法)
-(void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error{
if (error) {
NSLog(@"更新特征值时发生错误,错误信息:%@",error.localizedDescription);
[self writeToLog:[NSString stringWithFormat:@"更新特征值时发生错误,错误信息:%@",error.localizedDescription]];
return;
}
if (characteristic.value) {
NSString *value=[[NSString alloc]initWithData:characteristic.value encoding:NSUTF8StringEncoding];
NSLog(@"读取到特征值:%@",value);
[self writeToLog:[NSString stringWithFormat:@"读取到特征值:%@",value]];
}else{
NSLog(@"未发现特征值.");
[self writeToLog:@"未发现特征值."];
}
}
#pragma mark - 属性
-(NSMutableArray *)peripherals{
if(!_peripherals){
_peripherals=[NSMutableArray array];
}
return _peripherals;
}
#pragma mark - 私有方法
/**
* 记录日志
*
* @param info 日志信息
*/
-(void)writeToLog:(NSString *)info{
self.log.text=[NSString stringWithFormat:@"%@\r\n%@",self.log.text,info];
}
@end
上面程序运行的流程图以下:
有了上面两个程序就能够分别运行在两台支持BLE的iOS设备上,当两个应用创建链接后,一旦外围设备更新特征以后,中央设备就能够当即获取到更新 后的值。须要强调的是使用CoreBluetooth开发的应用不只仅能够和其余iOS设备进行蓝牙通讯,还能够同其余第三方遵循BLE规范的设备进行蓝 牙通信,这里就再也不赘述。
注意:本节部分图片来自于互联网,版权归原做者全部。
如今不少应用都内置“社交分享”功能,能够将看到的新闻、博客、广告等内容分享到微博、微信、QQ、空间等,其实从iOS6.0开始苹果官方就内置 了Social.framework专门来实现社交分享功能,利用这个框架开发者只须要几句代码就能够实现内容分享。下面就以一个分享到新浪微博的功能为 例来演示Social框架的应用,整个过程分为:建立内容编辑控制器,设置分享内容(文本内容、图片、超连接等),设置发送(或取消)后的回调事件,展现 控制器。
程序代码:
//
// ViewController.m
// Social
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <Social/Social.h>
@interface ViewController ()
@end
@implementation ViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)shareClick:(UIBarButtonItem *)sender {
[self shareToSina];
}
#pragma mark - 私有方法
-(void)shareToSina{
//检查新浪微博服务是否可用
if(![SLComposeViewController isAvailableForServiceType:SLServiceTypeSinaWeibo]){
NSLog(@"新浪微博服务不可用.");
return;
}
//初始化内容编写控制器,注意这里指定分享类型为新浪微博
SLComposeViewController *composeController=[SLComposeViewController composeViewControllerForServiceType:SLServiceTypeSinaWeibo];
//设置默认信息
[composeController setInitialText:@"Kenshin Cui's Blog..."];
//添加图片
[composeController addImage:[UIImage imageNamed:@"stevenChow"]];
//添加链接
[composeController addURL:[NSURL URLWithString:@"http://www.cnblogs.com/kenshincui"]];
//设置发送完成后的回调事件
__block SLComposeViewController *composeControllerForBlock=composeController;
composeController.completionHandler=^(SLComposeViewControllerResult result){
if (result==SLComposeViewControllerResultDone) {
NSLog(@"开始发送...");
}
[composeControllerForBlock dismissViewControllerAnimated:YES completion:nil];
};
//显示编辑视图
[self presentViewController:composeController animated:YES completion:nil];
}
@end
运行效果:
发送成功以后:
在这个过程当中开发人员不须要知道新浪微博的更多分享细节,Social框架中已经统一了分享的接口,你能够经过ServiceType设置是分享到 Facebook、Twitter、新浪微博、腾讯微博,而不关心具体的细节实现。那么当运行上面的示例时它是怎么知道用哪一个帐户来发送微博呢?其实在 iOS的设置中有专门设置Facebook、Twitter、微博的地方:
必须首先在这里设置微博帐户才能完成上面的发送,否则Social框架也不可能知道具体使用哪一个帐户来发送。
固然,经过上面的设置界面应该能够看到,苹果官方默认支持的分享并不太多,特别是对于国内的应用只支持新浪微博和腾讯微博(事实上从iOS7苹果才 考虑支持腾讯微博),那么若是要分享到微信、人人、开心等等国内较为知名的社交网络怎么办呢?目前最好的选择就是使用第三方框架,由于若是要本身实现各个 应用的接口仍是比较复杂的。当前使用较多的就是友盟社会化组件、ShareSDK,并且如今百度也出了社会化分享组件。今天没法对全部组件都进行一一介绍,这里就以友盟社交化组件为例简单作一下介绍:
下面是一个简单的示例:
//
// ViewController.m
// Social_UM
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import "UMSocial.h"
#import "UMSocialWechatHandler.h"
@interface ViewController ()<UMSocialUIDelegate>
@end
@implementation ViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)shareClick:(UIBarButtonItem *)sender {
//设置微信AppId、appSecret,分享url
// [UMSocialWechatHandler setWXAppId:@"wx30dbea5d5a258ed3" appSecret:@"cd36a9829e4b49a0dcac7b4162da5a5" url:@"http://www.cmj.com/social-UM"];
//微信好友、微信朋友圈、微信收藏、QQ空间、QQ好友、来往好友等都必须通过各自的平台集成不然不会出如今分享列表,例如上面是设置微信的AppId和appSecret
[UMSocialSnsService presentSnsIconSheetView:self appKey:@"54aa0a0afd98c5209f000efa" shareText:@"Kenshin Cui's Blog..." shareImage:[UIImage imageNamed:@"stevenChow"] shareToSnsNames:@[UMShareToSina,UMShareToTencent,UMShareToRenren,UMShareToDouban] delegate:self];
}
#pragma mark - UMSocialSnsService代理
//分享完成
-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response{
//分享成功
if(response.responseCode==UMSResponseCodeSuccess){
NSLog(@"分享成功");
}
}
@end
运行效果:
注意:在第一次使用某个分享服务是须要输入相应的帐号得到受权才能分享。
Game Center是由苹果发布的在线多人游戏社交网络,经过它游戏玩家能够邀请好友进行多人游戏,它也会记录玩家的成绩并在排行榜中展现,同时玩家每通过必定 的阶段会得到不一样的成就。这里就简单介绍一下如何在本身的应用中集成Game Center服务来让用户得到积分、成就以及查看游戏排行和已得到成就。
因为Game Center是苹果推出的一项重要服务,苹果官方对于它的控制至关严格,所以使用Game Center以前必需要作许多准备工做。一般须要通过如下几个步骤(下面的准备工做主要是针对真机的,模拟器省略Provisioning Profile配置过程):
有了以上准备就能够在应用程序中增长积分、添加成就了,固然在实际开发过程积分和成就都是基于玩家所经过的关卡来完成的,为了简化这个过程这里就直接经过几个按钮手动触发这些事件。Game Center开发须要使用GameKit框架,首先熟悉一下经常使用的几个类:
GKLocalPlayer:表示本地玩家,在GameKit中还有一个GKPlayer表示联机玩家,为了保证非联网用户也能够正常使用游戏功能,通常使用GKLocalPlayer。
GKScore:管理游戏积分,例如设置积分、排名等。
GKLeaderboard:表示游戏排行榜,主用用于管理玩家排名,例如加载排行榜、设置默认排行榜、加载排行榜图片等。
GKAchievement:表示成就,主用用于管理玩家成就,例如加载成就、提交成就,重置成就等。
GKAchievementDescription:成就描述信息,包含成就的标题、得到前描述、得到后描述、是否可重复得到成就等信息。
GKGameCenterViewController:排行榜、成就查看视图控制器。若是应用自己不须要本身开发排行榜、成就查看试图能够直接调用此控制器。
下面就以一个简单的示例来完成排行榜、成就设置和查看,在这个演示程序中经过两种方式来查看排行和成就:一种是直接使用框架自带的 GKGameCenterViewContrller调用系统视图查看,另外一种是经过API本身读取排行榜、成就信息并显示。此外在应用中有两个添加按钮 分别用于设置得分和成就。应用大体布局以下(图片较大可点击查看大图):
1.首先看一下主视图控制器KCMainTableViewController:
主视图控制器调用GKLeaderboard的loadLeaderboardsWithCompletionHandler:方法加载了全部排行榜,这个过程须要注意每一个排行榜(GKLeaderboard)中的scores属性是没有值的,若是要让每一个排行榜的scores属性有值必须调用一次排行榜的loadScoresWithCompletionHandler:方法。
调用GKAchievement的loadAchievementsWithCompletionHandler:方法加载加载成就,注意这个方法只能得到完成度不为0的成就,若是完成度为0是得到不到的;而后调用GKAchievementDesciption的loadAchievementDescriptionsWithCompletionHandler:方法加载了全部成就描述,这里加载的是全部成就描述(无论完成度是否为0);紧接着调用了每一个成就描述的loadImageWithCompletionHandler:方法加载成就图片。
将得到的排行榜、成就、成就描述、成就图片信息保存,并在导航到详情视图时传递给排行榜视图控制器和成就视图控制器以便在子控制器视图中展现。
在主视图控制器左上方添加查看游戏中心控制按钮,点击按钮调用GKGameCenterViewController来展现排行榜、成就、玩家信息,这是系统自带的一个游戏中心视图方便和后面咱们本身得到的信息对比。
程序以下
//
// KCMainTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
// 静态表格
#import "KCMainTableViewController.h"
#import <GameKit/GameKit.h>
#import "KCLeaderboardTableViewController.h"
#import "KCAchievementTableViewController.h"
@interface KCMainTableViewController ()<GKGameCenterControllerDelegate>
@property (strong,nonatomic) NSArray *leaderboards;//排行榜对象数组
@property (strong,nonatomic) NSArray *achievements;//成就
@property (strong,nonatomic) NSArray *achievementDescriptions;//成就描述
@property (strong,nonatomic) NSMutableDictionary *achievementImages;//成就图片
@property (weak, nonatomic) IBOutlet UILabel *leaderboardLabel; //排行个数
@property (weak, nonatomic) IBOutlet UILabel *achievementLable; //成就个数
@end
@implementation KCMainTableViewController
#pragma mark - 控制器视图事件
- (void)viewDidLoad {
[super viewDidLoad];
[self authorize];
}
#pragma mark - UI事件
- (IBAction)viewGameCenterClick:(UIBarButtonItem *)sender {
[self viewGameCenter];
}
#pragma mark - GKGameCenterViewController代理方法
//点击完成
-(void)gameCenterViewControllerDidFinish:(GKGameCenterViewController *)gameCenterViewController{
NSLog(@"完成.");
[gameCenterViewController dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark -导航
-(void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender{
//若是是导航到排行榜,则将当前排行榜传递到排行榜视图
if ([segue.identifier isEqualToString:@"leaderboard"]) {
UINavigationController *navigationController=segue.destinationViewController;
KCLeaderboardTableViewController *leaderboardController=[navigationController.childViewControllers firstObject];
leaderboardController.leaderboards=self.leaderboards;
}else if ([segue.identifier isEqualToString:@"achievement"]) {
UINavigationController *navigationController=segue.destinationViewController;
KCAchievementTableViewController *achievementController=[navigationController.childViewControllers firstObject];
achievementController.achievements=self.achievements;
achievementController.achievementDescriptions=self.achievementDescriptions;
achievementController.achievementImages=self.achievementImages;
}
}
#pragma mark - 私有方法
//检查是否通过认证,若是没通过认证则弹出Game Center登陆界面
-(void)authorize{
//建立一个本地用户
GKLocalPlayer *localPlayer= [GKLocalPlayer localPlayer];
//检查用于受权,若是没有登陆则让用户登陆到GameCenter(注意此事件设置以后或点击登陆界面的取消按钮都会被调用)
[localPlayer setAuthenticateHandler:^(UIViewController * controller, NSError *error) {
if ([[GKLocalPlayer localPlayer] isAuthenticated]) {
NSLog(@"已受权.");
[self setupUI];
}else{
//注意:在设置中找到Game Center,设置其容许沙盒,不然controller为nil
[self presentViewController:controller animated:YES completion:nil];
}
}];
}
//UI布局
-(void)setupUI{
//更新排行榜个数
[GKLeaderboard loadLeaderboardsWithCompletionHandler:^(NSArray *leaderboards, NSError *error) {
if (error) {
NSLog(@"加载排行榜过程当中发生错误,错误信息:%@",error.localizedDescription);
}
self.leaderboards=leaderboards;
self.leaderboardLabel.text=[NSString stringWithFormat:@"%i",leaderboards.count];
//获取得分,注意只有调用了loadScoresWithCompletionHandler:方法以后leaderboards中的排行榜中的scores属性才有值,不然为nil
[leaderboards enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
GKLeaderboard *leaderboard=obj;
[leaderboard loadScoresWithCompletionHandler:^(NSArray *scores, NSError *error) {
}];
}];
}];
//更新得到成就个数,注意这个个数不必定等于iTunes Connect中的总成就个数,此方法只能获取到成就完成进度不为0的成就
[GKAchievement loadAchievementsWithCompletionHandler:^(NSArray *achievements, NSError *error) {
if (error) {
NSLog(@"加载成就过程当中发生错误,错误信息:%@",error.localizedDescription);
}
self.achievements=achievements;
self.achievementLable.text=[NSString stringWithFormat:@"%i",achievements.count];
//加载成就描述(注意,即便没有得到此成就也能获取到)
[GKAchievementDescription loadAchievementDescriptionsWithCompletionHandler:^(NSArray *descriptions, NSError *error) {
if (error) {
NSLog(@"加载成就描述信息过程当中发生错误,错误信息:%@",error.localizedDescription);
return ;
}
self.achievementDescriptions=descriptions;
//加载成就图片
_achievementImages=[NSMutableDictionary dictionary];
[descriptions enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
GKAchievementDescription *description=(GKAchievementDescription *)obj;
[description loadImageWithCompletionHandler:^(UIImage *image, NSError *error) {
[_achievementImages setObject:image forKey:description.identifier];
}];
}];
}];
}];
}
//查看Game Center
-(void)viewGameCenter{
if (![GKLocalPlayer localPlayer].isAuthenticated) {
NSLog(@"未得到用户受权.");
return;
}
//Game Center视图控制器
GKGameCenterViewController *gameCenterController=[[GKGameCenterViewController alloc]init];
//设置代理
gameCenterController.gameCenterDelegate=self;
//显示
[self presentViewController:gameCenterController animated:YES completion:nil];
}
@end
2.而后看一下排行榜控制器视图KCLeaderboardTableViewController:
在排行榜控制器视图中定义一个leaderboards属性用于接收主视图控制器传递的排行榜信息而且经过一个UITableView展现排行榜名称、得分等。
在排行榜控制器视图中经过GKScore的reportScores: withCompletionHandler:设置排行榜得分,注意每一个GKScore对象必须设置value属性来表示得分(GKScore是经过identifier来和排行榜关联起来的)。
程序以下
//
// KCLeaderboardTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCLeaderboardTableViewController.h"
#import <GameKit/GameKit.h>
//排行榜标识,就是iTunes Connect中配置的排行榜ID
#define kLeaderboardIdentifier1 @"Goals"
@interface KCLeaderboardTableViewController ()
@end
@implementation KCLeaderboardTableViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//添加得分(这里指的是进球数)
- (IBAction)addScoreClick:(UIBarButtonItem *)sender {
[self addScoreWithIdentifier:kLeaderboardIdentifier1 value:100];
}
#pragma mark - UITableView数据源方法
-(NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index{
return 1;
}
-(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
return self.leaderboards.count;
}
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[self.tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
}
GKLeaderboard *leaderboard=self.leaderboards[indexPath.row];
GKScore *score=[leaderboard.scores firstObject];
NSLog(@"scores:%@",leaderboard.scores);
cell.textLabel.text=leaderboard.title;//排行榜标题
cell.detailTextLabel.text=[NSString stringWithFormat:@"%lld",score.value]; //排行榜得分
return cell;
}
#pragma mark - 属性
#pragma mark - 私有方法
/**
* 设置得分
*
* @param identifier 排行榜标识
* @param value 得分
*/
-(void)addScoreWithIdentifier:(NSString *)identifier value:(int64_t)value{
if (![GKLocalPlayer localPlayer].isAuthenticated) {
NSLog(@"未得到用户受权.");
return;
}
//建立积分对象
GKScore *score=[[GKScore alloc]initWithLeaderboardIdentifier:identifier];
//设置得分
score.value=value;
//提交积分到Game Center服务器端,注意保存是异步的,而且支持离线提交
[GKScore reportScores:@[score] withCompletionHandler:^(NSError *error) {
if(error){
NSLog(@"保存积分过程当中发生错误,错误信息:%@",error.localizedDescription);
return ;
}
NSLog(@"添加积分红功.");
}];
}
@end
3.最后就是成就视图控制器KCAchievementTableViewController:
在成就视图控制器定义achievements、achievementDescriptions、achievementImages三个属性分 别表示成就、成就描述、成就图片,这三个属性均从主视图控制器中传递进来,而后使用UITableView展现成就、成就图片、成就进度。
建立GKAchievemnt对象(经过identifier属性来表示具体的成就)并指定完成度,经过调用GKAchievement的reportAchievements: withCompletionHandler:方法提交完成度到Game Center服务器。
程序以下
//
// KCAchievementTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCAchievementTableViewController.h"
#import <GameKit/GameKit.h>
//成就标识,就是iTunes Connect中配置的成就ID
#define kAchievementIdentifier1 @"AdidasGoldenBall"
#define kAchievementIdentifier2 @"AdidasGoldBoot"
@interface KCAchievementTableViewController ()
@end
@implementation KCAchievementTableViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//添加成就
- (IBAction)addAchievementClick:(UIBarButtonItem *)sender {
[self addAchievementWithIdentifier:kAchievementIdentifier1];
}
#pragma mark - UITableView数据源方法
-(NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index{
return 1;
}
-(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
return self.achievementDescriptions.count;
}
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[self.tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
}
GKAchievementDescription *desciption=[self.achievementDescriptions objectAtIndex:indexPath.row];
cell.textLabel.text=desciption.title ;//成就标题
//若是已经得到成就则加载进度,不然为0
double percent=0.0;
GKAchievement *achievement=[self getAchievementWithIdentifier:desciption.identifier];
if (achievement) {
percent=achievement.percentComplete;
}
cell.detailTextLabel.text=[NSString stringWithFormat:@"%3.2f%%",percent]; //成就完成度
//设置成就图片
cell.imageView.image=[self.achievementImages valueForKey:desciption.identifier];
return cell;
}
#pragma mark - 私有方法
//添加指定类别的成就
-(void)addAchievementWithIdentifier:(NSString *)identifier{
if (![GKLocalPlayer localPlayer].isAuthenticated) {
NSLog(@"未得到用户受权.");
return;
}
//建立成就
GKAchievement *achievement=[[GKAchievement alloc]initWithIdentifier:identifier];
achievement.percentComplete=100;//设置此成就完成度,100表明得到此成就
NSLog(@"%@",achievement);
//保存成就到Game Center服务器,注意保存是异步的,而且支持离线提交
[GKAchievement reportAchievements:@[achievement] withCompletionHandler:^(NSError *error) {
if(error){
NSLog(@"保存成就过程当中发生错误,错误信息:%@",error.localizedDescription);
return ;
}
NSLog(@"添加成就成功.");
}];
}
//根据标识得到已取得的成就
-(GKAchievement *)getAchievementWithIdentifier:(NSString *)identifier{
for (GKAchievement *achievement in self.achievements) {
if ([achievement.identifier isEqualToString:identifier]) {
return achievement;
}
}
return nil;
}
@end
运行效果:
注意首次使用游戏时因为没有对Game Center受权,会提示用户登陆Game Center。
你们都知道作iOS开发自己的收入有三种来源:出售应用、内购和广告。国内用户一般不多直接购买应用,所以对于开发者而言(特别是我的开发者),内 购和广告收入就成了主要的收入来源。内购营销模式,一般软件自己是不收费的,可是要得到某些特权就必须购买一些道具,而内购的过程是由苹果官方统一来管理 的,因此和Game Center同样,在开发内购程序以前要作一些准备工做(下面的准备工做主要是针对真机的,模拟器省略Provisioning Profile配置过程):
开发内购应用时须要使用StoreKit.framework,下面是这个框架中经常使用的几个类:
SKProduct:可购买的产品(例如上面设置的能量瓶、强力手套等),其productIdentifier属性对应iTunes Connect中配置的“产品ID“,可是此类不建议直接初始化使用,而是要经过SKProductRequest来加载可用产品(避免出现购买到无效的 产品)。
SKProductRequest:产品请求类,主要用于加载产品列表(包括可用产品和不可用产品),一般加载完以后会经过其-(void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response代理方法得到响应,拿到响应中的可用产品。
SKPayment:产品购买支付类,保存了产品ID、购买数量等信息(注意与其对应的有一个SKMutablePayment对象,此对象能够修改产品数量等信息)。
SKPaymentQueue:产品购买支付队列,一旦将一个SKPayment添加到此队列就会向苹果服务器发送请求完成这次交易。注意交易的状 态反馈不是经过代理完成的,而是经过一个交易监听者(相似于代理,能够经过队列的addTransactionObserver来设置)。
SKPaymentTransaction:一次产品购买交易,一般交易完成后支付队列会调用交易监听者的-(void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transaction方法反馈交易状况,并在此方法中将交易对象返回。
SKStoreProductViewController:应用程序商店产品展现视图控制器,用于在应用程序内部展现此应用在应用商店的状况。 (例如可使用它让用户在应用内完成评价,注意因为本次演示的示例程序没有正式提交到应用商店,因此在此暂不演示此控制器视图的使用)。
了解了以上几个经常使用的开发API以后,下面看一下应用内购买的流程:
下面经过一个示例程序演示内购和恢复的整个过程,程序界面大体以下:
主界面中展现了全部可购买产品和售价,以及购买状况。
选择一个产品点”购买“能够购买此商品,购买完成后刷新购买状态(若是是非消耗品则显示已购买,若是是消耗品则显示购买个数)。
程序卸载后从新安装能够点击”恢复购买“来恢复已购买的非消耗品。
程序代码:
//
// KCMainTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCMainTableViewController.h"
#import <StoreKit/StoreKit.h>
#define kAppStoreVerifyURL @"https://buy.itunes.apple.com/verifyReceipt" //实际购买验证URL
#define kSandboxVerifyURL @"https://sandbox.itunes.apple.com/verifyReceipt" //开发阶段沙盒验证URL
//定义能够购买的产品ID,必须和iTunes Connect中设置的一致
#define kProductID1 @"ProtectiveGloves" //强力手套,非消耗品
#define kProductID2 @"GoldenGlobe" //金球,非消耗品
#define kProductID3 @"EnergyBottle" //能量瓶,消耗品
@interface KCMainTableViewController ()<SKProductsRequestDelegate,SKPaymentTransactionObserver>
@property (strong,nonatomic) NSMutableDictionary *products;//有效的产品
@property (assign,nonatomic) int selectedRow;//选中行
@end
@implementation KCMainTableViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
[self loadProducts];
[self addTransactionObjserver];
}
#pragma mark - UI事件
//购买产品
- (IBAction)purchaseClick:(UIBarButtonItem *)sender {
NSString *productIdentifier=self.products.allKeys[self.selectedRow];
SKProduct *product=self.products[productIdentifier];
if (product) {
[self purchaseProduct:product];
}else{
NSLog(@"没有可用商品.");
}
}
//恢复购买
- (IBAction)restorePurchaseClick:(UIBarButtonItem *)sender {
[self restoreProduct];
}
#pragma mark - UITableView数据源方法
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.products.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[self.tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
}
cell.accessoryType=UITableViewCellAccessoryNone;
NSString *key=self.products.allKeys[indexPath.row];
SKProduct *product=self.products[key];
NSString *purchaseString;
NSUserDefaults *defaults=[NSUserDefaults standardUserDefaults];
if ([product.productIdentifier isEqualToString:kProductID3]) {
purchaseString=[NSString stringWithFormat:@"已购买%i个",[defaults integerForKey:product.productIdentifier]];
}else{
if([defaults boolForKey:product.productIdentifier]){
purchaseString=@"已购买";
}else{
purchaseString=@"还没有购买";
}
}
cell.textLabel.text=[NSString stringWithFormat:@"%@(%@)",product.localizedTitle,purchaseString] ;
cell.detailTextLabel.text=[NSString stringWithFormat:@"%@",product.price];
return cell;
}
#pragma mark - UITableView代理方法
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
UITableViewCell *currentSelected=[tableView cellForRowAtIndexPath:indexPath];
currentSelected.accessoryType=UITableViewCellAccessoryCheckmark;
self.selectedRow=indexPath.row;
}
-(void)tableView:(UITableView *)tableView didDeselectRowAtIndexPath:(NSIndexPath *)indexPath{
UITableViewCell *currentSelected=[tableView cellForRowAtIndexPath:indexPath];
currentSelected.accessoryType=UITableViewCellAccessoryNone;
}
#pragma mark - SKProductsRequestd代理方法
/**
* 产品请求完成后的响应方法
*
* @param request 请求对象
* @param response 响应对象,其中包含产品信息
*/
-(void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response{
//保存有效的产品
_products=[NSMutableDictionary dictionary];
[response.products enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
SKProduct *product=obj;
[_products setObject:product forKey:product.productIdentifier];
}];
//因为这个过程是异步的,加载成功后从新刷新表格
[self.tableView reloadData];
}
-(void)requestDidFinish:(SKRequest *)request{
NSLog(@"请求完成.");
}
-(void)request:(SKRequest *)request didFailWithError:(NSError *)error{
if (error) {
NSLog(@"请求过程当中发生错误,错误信息:%@",error.localizedDescription);
}
}
#pragma mark - SKPaymentQueue监听方法
/**
* 交易状态更新后执行
*
* @param queue 支付队列
* @param transactions 交易数组,里面存储了本次请求的全部交易对象
*/
-(void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions{
[transactions enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
SKPaymentTransaction *paymentTransaction=obj;
if (paymentTransaction.transactionState==SKPaymentTransactionStatePurchased){//已购买成功
NSLog(@"交易\"%@\"成功.",paymentTransaction.payment.productIdentifier);
//购买成功后进行验证
[self verifyPurchaseWithPaymentTransaction];
//结束支付交易
[queue finishTransaction:paymentTransaction];
}else if(paymentTransaction.transactionState==SKPaymentTransactionStateRestored){//恢复成功,对于非消耗品才能恢复,若是恢复成功则transaction中记录的恢复的产品交易
NSLog(@"恢复交易\"%@\"成功.",paymentTransaction.payment.productIdentifier);
[queue finishTransaction:paymentTransaction];//结束支付交易
//恢复后从新写入偏好配置,从新加载UITableView
[[NSUserDefaults standardUserDefaults]setBool:YES forKey:paymentTransaction.payment.productIdentifier];
[self.tableView reloadData];
}else if(paymentTransaction.transactionState==SKPaymentTransactionStateFailed){
if (paymentTransaction.error.code==SKErrorPaymentCancelled) {//若是用户点击取消
NSLog(@"取消购买.");
}
NSLog(@"ErrorCode:%i",paymentTransaction.error.code);
}
}];
}
//恢复购买完成
-(void)paymentQueueRestoreCompletedTransactionsFinished:(SKPaymentQueue *)queue{
NSLog(@"恢复完成.");
}
#pragma mark - 私有方法
/**
* 添加支付观察者监控,一旦支付后则会回调观察者的状态更新方法:
-(void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
*/
-(void)addTransactionObjserver{
//设置支付观察者(相似于代理),经过观察者来监控购买状况
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
}
/**
* 加载全部产品,注意产品必定是从服务器端请求得到,由于有些产品可能开发人员知道其存在性,可是不通过审核是无效的;
*/
-(void)loadProducts{
//定义要获取的产品标识集合
NSSet *sets=[NSSet setWithObjects:kProductID1,kProductID2,kProductID3, nil];
//定义请求用于获取产品
SKProductsRequest *productRequest=[[SKProductsRequest alloc]initWithProductIdentifiers:sets];
//设置代理,用于获取产品加载状态
productRequest.delegate=self;
//开始请求
[productRequest start];
}
/**
* 购买产品
*
* @param product 产品对象
*/
-(void)purchaseProduct:(SKProduct *)product{
//若是是非消耗品,购买过则提示用户
NSUserDefaults *defaults=[NSUserDefaults standardUserDefaults];
if ([product.productIdentifier isEqualToString:kProductID3]) {
NSLog(@"当前已经购买\"%@\" %i 个.",kProductID3,[defaults integerForKey:product.productIdentifier]);
}else if([defaults boolForKey:product.productIdentifier]){
NSLog(@"\"%@\"已经购买过,无需购买!",product.productIdentifier);
return;
}
//建立产品支付对象
SKPayment *payment=[SKPayment paymentWithProduct:product];
//支付队列,将支付对象加入支付队列就造成一次购买请求
if (![SKPaymentQueue canMakePayments]) {
NSLog(@"设备不支持购买.");
return;
}
SKPaymentQueue *paymentQueue=[SKPaymentQueue defaultQueue];
//添加都支付队列,开始请求支付
// [self addTransactionObjserver];
[paymentQueue addPayment:payment];
}
/**
* 恢复购买,对于非消耗品若是应用从新安装或者机器重置后能够恢复购买
* 注意恢复时只能一次性恢复全部非消耗品
*/
-(void)restoreProduct{
SKPaymentQueue *paymentQueue=[SKPaymentQueue defaultQueue];
//设置支付观察者(相似于代理),经过观察者来监控购买状况
// [paymentQueue addTransactionObserver:self];
//恢复全部非消耗品
[paymentQueue restoreCompletedTransactions];
}
/**
* 验证购买,避免越狱软件模拟苹果请求达到非法购买问题
*
*/
-(void)verifyPurchaseWithPaymentTransaction{
//从沙盒中获取交易凭证而且拼接成请求体数据
NSURL *receiptUrl=[[NSBundle mainBundle] appStoreReceiptURL];
NSData *receiptData=[NSData dataWithContentsOfURL:receiptUrl];
NSString *receiptString=[receiptData base64EncodedStringWithOptions:NSDataBase64EncodingEndLineWithLineFeed];//转化为base64字符串
NSString *bodyString = [NSString stringWithFormat:@"{\"receipt-data\" : \"%@\"}", receiptString];//拼接请求数据
NSData *bodyData = [bodyString dataUsingEncoding:NSUTF8StringEncoding];
//建立请求到苹果官方进行购买验证
NSURL *url=[NSURL URLWithString:kSandboxVerifyURL];
NSMutableURLRequest *requestM=[NSMutableURLRequest requestWithURL:url];
requestM.HTTPBody=bodyData;
requestM.HTTPMethod=@"POST";
//建立链接并发送同步请求
NSError *error=nil;
NSData *responseData=[NSURLConnection sendSynchronousRequest:requestM returningResponse:nil error:&error];
if (error) {
NSLog(@"验证购买过程当中发生错误,错误信息:%@",error.localizedDescription);
return;
}
NSDictionary *dic=[NSJSONSerialization JSONObjectWithData:responseData options:NSJSONReadingAllowFragments error:nil];
NSLog(@"%@",dic);
if([dic[@"status"] intValue]==0){
NSLog(@"购买成功!");
NSDictionary *dicReceipt= dic[@"receipt"];
NSDictionary *dicInApp=[dicReceipt[@"in_app"] firstObject];
NSString *productIdentifier= dicInApp[@"product_id"];//读取产品标识
//若是是消耗品则记录购买数量,非消耗品则记录是否购买过
NSUserDefaults *defaults=[NSUserDefaults standardUserDefaults];
if ([productIdentifier isEqualToString:kProductID3]) {
int purchasedCount=[defaults integerForKey:productIdentifier];//已购买数量
[[NSUserDefaults standardUserDefaults] setInteger:(purchasedCount+1) forKey:productIdentifier];
}else{
[defaults setBool:YES forKey:productIdentifier];
}
[self.tableView reloadData];
//在此处对购买记录进行存储,能够存储到开发商的服务器端
}else{
NSLog(@"购买失败,未经过验证!");
}
}
@end
运行效果(这是程序在卸载后从新安装的运行效果,卸载前已经购买”强力手套“,所以程序运行后点击了”恢复购买“):
上面也提到作iOS开发另外一收益来源就是广告,在iOS上有不少广告服务能够集成,使用比较多的就是苹果的iAd、谷歌的Admob,下面简单演示 一下如何使用iAd来集成广告。使用iAd集成广告的过程比较简单,首先引入iAd.framework框架,而后建立ADBannerView来展现广 告,一般会设置ADBannerView的代理方法来监听广告点击并在广告加载失败时隐藏广告展现控件。下面的代码简单的演示了这个过程:
//
// ViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <iAd/iAd.h>
@interface ViewController ()<ADBannerViewDelegate>
@property (weak, nonatomic) IBOutlet ADBannerView *advertiseBanner;//广告展现视图
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
//设置代理
self.advertiseBanner.delegate=self;
}
#pragma mark - ADBannerView代理方法
//广告加载完成
-(void)bannerViewDidLoadAd:(ADBannerView *)banner{
NSLog(@"广告加载完成.");
}
//点击Banner后离开以前,返回NO则不会展开全屏广告
-(BOOL)bannerViewActionShouldBegin:(ADBannerView *)banner willLeaveApplication:(BOOL)willLeave{
NSLog(@"点击Banner后离开以前.");
return YES;
}
//点击banner后全屏显示,关闭后调用
-(void)bannerViewActionDidFinish:(ADBannerView *)banner{
NSLog(@"广告已关闭.");
}
//获取广告失败
-(void)bannerView:(ADBannerView *)banner didFailToReceiveAdWithError:(NSError *)error{
NSLog(@"加载广告失败.");
self.advertiseBanner.hidden=YES;
}
@end
运行效果:
iCloud是苹果提供的云端服务,用户能够将通信录、备忘录、邮件、照片、音乐、视频等备份到云服务器并在各个苹果设备间直接进行共享而无需关心 数据同步问题,甚至即便你的设备丢失后在一台新的设备上也能够经过Apple ID登陆同步。固然这些内容都是iOS内置的功能,那么对于开放者如何利用iCloud呢?苹果已经将云端存储功能开放给开发者,利用iCloud开发者 能够存储两类数据:用户文档和应用数据、应用配置项。前者主要用于一些用户文档、文件的存储,后者更相似于平常开放中的偏好设置,只是这些配置信息会同步 到云端。
要进行iCloud开发一样须要一些准备工做(下面的准备工做主要是针对真机的,模拟器省略Provisioning Profile配置过程):
一、2步骤仍然是建立App ID启用iCloud服务、生成对应的配置(Provisioning Profile),这个过程当中Bundle ID可使用通配符(Data Protection、iCloud、Inter-App Audio、Passbook服务在建立App ID时其中的Bundle ID是可使用通配ID的)。
3.在Xcode中建立项目(假设项目名称为“kctest”)并在项目的Capabilities中找到iCloud并打开。这里须要注意的就是 因为在此应用中要演示文档存储和首选项存储,所以在Service中勾选“Key-value storae”和“iCloud Documents”:
在项目中会自动生成一个”kctest.entitlements”配置文件,这个文档配置了文档存储容器标识、键值对存储容器标识等信息。
4.不管是真机仍是模拟器都必须在iOS“设置”中找到iCloud设置登陆帐户,注意这个帐户没必要是沙盒测试用户。
A.首先看一下如何进行文档存储。文档存储主要是使用UIDocument类来完成,这个类提供了新建、修改(其实在API中是覆盖操做)、查询文档、打开文档、删除文档的功能。
UIDocument对文档的新增、修改、删除、读取所有基于一个云端URL来完成(事实上在开发过程当中新增、修改只是一步简单的保存操做),对于开发者而言没有本地和云端之分,这样大大简化了开发过程。这个URL能够经过NSFileManager的URLForUbiquityContainerIdentifier:方 法获取,identifier是云端存储容器的惟一标识,若是传入nil则表明第一个容器(事实上这个容器能够经过前面生成的 “kctest.entiements”中的Ubiquity Container Identifiers来获取。如上图能够看到这是一个数组,能够配置多个容器,例如咱们的第一个容器标识是 “iCloud.$(CFBundleIdentifier)”,其中$(CFBundleIdentifier)是Bundle ID,那么根据应用的Bundle ID就能够得知第一个容器的标识是“iCloud.com.cmjstudio.kctest”。)。下面是经常使用的文档操做方法:
-(void)saveToURL:forSaveOperation:completionHandler::将指定URL的文档保存到iCloud(能够是新增或者覆盖,经过saveOperation参数设定)。
-(void)openWithCompletionHandler::打开当前文档。
注意:删除一个iCloud文档是使用NSFileManager的removeItemAtURL:error:方法来完成的。
因为实际开发过程当中数据的存储和读取状况是复杂的,所以UIDocument在设计时并无提供统一的存储方式来保存数据,而是但愿开发者本身继承UIDocument类并重写-(id)contentsForType:(NSString *)typeName error:(NSError *__autoreleasing *)outError和-(BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError *__autoreleasing *)outError方 法来根据不一样的文档类型本身来操做数据(contents)。这两个方法分别在保存文档 (-(void)saveToURL:forSaveOperation:completionHandler:)和打开文档 (-(void)openWithCompletionHandler:)时调用。一般在子类中会定义一个属性A来存储文档数据,当保存文档时,会经过 -(id)contentsForType:(NSString *)typeName error:(NSError *__autoreleasing *)outError方法将A转化为NSData或者NSFileWrapper(UIDocument保存数据的本质就是保存转化获得的NSData或 者NSFileWrapper);当打开文档时,会经过-(BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError *__autoreleasing *)outError方法将云端下载的NSData或者NSFileWrapper数据转化为A对应类型的数据。为了方便演示下面简单定义一个继承自 UIDocument的KCDocument类,在其中定义一个data属性存储数据:
//
// KCDocument.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCDocument.h"
@interface KCDocument()
@end
@implementation KCDocument
#pragma mark - 重写父类方法
/**
* 保存时调用
*
* @param typeName <#typeName description#>
* @param outError <#outError description#>
*
* @return <#return value description#>
*/
-(id)contentsForType:(NSString *)typeName error:(NSError *__autoreleasing *)outError{
if (self.data) {
return [self.data copy];
}
return [NSData data];
}
/**
* 读取数据时调用
*
* @param contents <#contents description#>
* @param typeName <#typeName description#>
* @param outError <#outError description#>
*
* @return <#return value description#>
*/
-(BOOL)loadFromContents:(id)contents ofType:(NSString *)typeName error:(NSError *__autoreleasing *)outError{
self.data=[contents copy];
return true;
}
@end
若是要加载iCloud中的文档列表就须要使用另外一个类NSMetadataQuery,一般考虑到网络的缘由并不会一次性加载全部数据,而利用 NSMetadataQuery并指定searchScopes为NSMetadataQueryUbiquitousDocumentScope来限制 查找iCloud文档数据。使用NSMetadataQuery还能够经过谓词限制搜索关键字等信息,并在搜索完成以后经过通知的形式通知客户端搜索的情 况。
你们都知道微软的OneNote云笔记本软件,经过它能够实现多种不一样设置间的笔记同步,这里就简单实现一个基于iCloud服务的笔记软件。在下 面的程序中实现笔记的新增、修改、保存、读取等操做。程序界面大体以下,点击界面右上方增长按钮增长一个笔记,点击某个笔记能够查看并编辑。
在主视图控制器首先查询全部iCloud保存的文档并在查询通知中遍历查询结果保存文档名称和建立日期到UITableView展现;其次当用户点击了增长按钮会调用KCDocument完成文档添加并导航到文档详情界面编辑文档内容。
//
// KCMainTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCMainTableViewController.h"
#import "KCDocument.h"
#import "KCDetailViewController.h"
#define kContainerIdentifier @"iCloud.com.cmjstudio.kctest" //容器id,能够从生产的entitiements文件中查看Ubiquity Container Identifiers(注意其中的$(CFBundleIdentifier)替换为BundleID)
@interface KCMainTableViewController ()
@property (strong,nonatomic) KCDocument *document;//当前选中的管理对象
@property (strong,nonatomic) NSMutableDictionary *files; //现有文件名、建立日期集合
@property (strong,nonatomic) NSMetadataQuery *dataQuery;//数据查询对象,用于查询iCloud文档
@end
@implementation KCMainTableViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
[self loadDocuments];
}
#pragma mark - UI事件
//新建文档
- (IBAction)addDocumentClick:(UIBarButtonItem *)sender {
UIAlertController *promptController=[UIAlertController alertControllerWithTitle:@"KCTest" message:@"请输入笔记名称" preferredStyle:UIAlertControllerStyleAlert];
[promptController addTextFieldWithConfigurationHandler:^(UITextField *textField) {
textField.placeholder=@"笔记名称";
}];
UIAlertAction *okAction=[UIAlertAction actionWithTitle:@"肯定" style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
UITextField *textField= promptController.textFields[0];
[self addDocument:textField.text];
}];
[promptController addAction:okAction];
UIAlertAction *cancelAction=[UIAlertAction actionWithTitle:@"取消" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
}];
[promptController addAction:cancelAction];
[self presentViewController:promptController animated:YES completion:nil];
}
#pragma mark - 导航
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
if ([segue.identifier isEqualToString:@"noteDetail"]) {
KCDetailViewController *detailController= segue.destinationViewController;
detailController.document=self.document;
}
}
#pragma mark - 属性
-(NSMetadataQuery *)dataQuery{
if (!_dataQuery) {
//建立一个iCloud查询对象
_dataQuery=[[NSMetadataQuery alloc]init];
_dataQuery.searchScopes=@[NSMetadataQueryUbiquitousDocumentsScope];
//注意查询状态是经过通知的形式告诉监听对象的
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(metadataQueryFinish:) name:NSMetadataQueryDidFinishGatheringNotification object:_dataQuery];//数据获取完成通知
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(metadataQueryFinish:) name:NSMetadataQueryDidUpdateNotification object:_dataQuery];//查询更新通知
}
return _dataQuery;
}
#pragma mark - 私有方法
/**
* 取得云端存储文件的地址
*
* @param fileName 文件名,若是文件名为nil则从新建立一个url
*
* @return 文件地址
*/
-(NSURL *)getUbiquityFileURL:(NSString *)fileName{
//取得云端URL基地址(参数中传入nil则会默认获取第一个容器)
NSURL *url= [[NSFileManager defaultManager] URLForUbiquityContainerIdentifier:kContainerIdentifier];
//取得Documents目录
url=[url URLByAppendingPathComponent:@"Documents"];
//取得最终地址
url=[url URLByAppendingPathComponent:fileName];
return url;
}
/**
* 添加文档到iCloud
*
* @param fileName 文件名称(不包括后缀)
*/
-(void)addDocument:(NSString *)fileName{
//取得保存URL
fileName=[NSString stringWithFormat:@"%@.txt",fileName];
NSURL *url=[self getUbiquityFileURL:fileName];
/**
建立云端文档操做对象
*/
KCDocument *document= [[KCDocument alloc]initWithFileURL:url];
[document saveToURL:url forSaveOperation:UIDocumentSaveForCreating completionHandler:^(BOOL success) {
if (success) {
NSLog(@"保存成功.");
[self loadDocuments];
[self.tableView reloadData];
self.document=document;
[self performSegueWithIdentifier:@"noteDetail" sender:self];
}else{
NSLog(@"保存失败.");
}
}];
}
/**
* 加载文档列表
*/
-(void)loadDocuments{
[self.dataQuery startQuery];
}
/**
* 获取数据完成后的通知执行方法
*
* @param notification 通知对象
*/
-(void)metadataQueryFinish:(NSNotification *)notification{
NSLog(@"数据获取成功!");
NSArray *items=self.dataQuery.results;//查询结果集
self.files=[NSMutableDictionary dictionary];
//变量结果集,存储文件名称、建立日期
[items enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
NSMetadataItem *item=obj;
NSString *fileName=[item valueForAttribute:NSMetadataItemFSNameKey];
NSDate *date=[item valueForAttribute:NSMetadataItemFSContentChangeDateKey];
NSDateFormatter *dateformate=[[NSDateFormatter alloc]init];
dateformate.dateFormat=@"YY-MM-dd HH:mm";
NSString *dateString= [dateformate stringFromDate:date];
[self.files setObject:dateString forKey:fileName];
}];
[self.tableView reloadData];
}
-(void)removeDocument:(NSString *)fileName{
NSURL *url=[self getUbiquityFileURL:fileName];
NSError *error=nil;
//删除文件
[[NSFileManager defaultManager] removeItemAtURL:url error:&error];
if (error) {
NSLog(@"删除文档过程当中发生错误,错误信息:%@",error.localizedDescription);
}
[self.files removeObjectForKey:fileName];//从集合中删除
}
#pragma mark - Table view data source
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.files.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[self.tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
cell.accessoryType=UITableViewCellAccessoryDisclosureIndicator;
}
NSArray *fileNames=self.files.allKeys;
NSString *fileName=fileNames[indexPath.row];
cell.textLabel.text=fileName;
cell.detailTextLabel.text=[self.files valueForKey:fileName];
return cell;
}
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
UITableViewCell *cell=[self.tableView cellForRowAtIndexPath:indexPath];
[self removeDocument:cell.textLabel.text];
[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationFade];
} else if (editingStyle == UITableViewCellEditingStyleInsert) {
// Create a new instance of the appropriate class, insert it into the array, and add a new row to the table view
}
}
#pragma mark - UITableView 代理方法
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
UITableViewCell *cell=[self.tableView cellForRowAtIndexPath:indexPath];
NSURL *url=[self getUbiquityFileURL:cell.textLabel.text];
self.document=[[KCDocument alloc]initWithFileURL:url];
[self performSegueWithIdentifier:@"noteDetail" sender:self];
}
@end
当新增一个笔记或选择一个已存在的笔记后能够查看、保存笔记内容。
//
// ViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCDetailViewController.h"
#import "KCDocument.h"
#define kSettingAutoSave @"com.cmjstudio.kctest.settings.autosave"
@interface KCDetailViewController ()
@property (weak, nonatomic) IBOutlet UITextView *textView;
@end
@implementation KCDetailViewController
#pragma mark - 控制器视图方法
- (void)viewDidLoad {
[super viewDidLoad];
[self setupUI];
}
-(void)viewWillDisappear:(BOOL)animated{
[super viewWillDisappear:animated];
//根据首选项来肯定离开当前控制器视图是否自动保存
BOOL autoSave=[[NSUbiquitousKeyValueStore defaultStore] boolForKey:kSettingAutoSave];
if (autoSave) {
[self saveDocument];
}
}
#pragma mark - 私有方法
-(void)setupUI{
UIBarButtonItem *rightButtonItem=[[UIBarButtonItem alloc]initWithBarButtonSystemItem:UIBarButtonSystemItemSave target:self action:@selector(saveDocument)];
self.navigationItem.rightBarButtonItem=rightButtonItem;
if (self.document) {
//打开文档,读取文档
[self.document openWithCompletionHandler:^(BOOL success) {
if(success){
NSLog(@"读取数据成功.");
NSString *dataText=[[NSString alloc]initWithData:self.document.data encoding:NSUTF8StringEncoding];
self.textView.text=dataText;
}else{
NSLog(@"读取数据失败.");
}
}];
}
}
/**
* 保存文档
*/
-(void)saveDocument{
if (self.document) {
NSString *dataText=self.textView.text;
NSData *data=[dataText dataUsingEncoding:NSUTF8StringEncoding];
self.document.data=data;
[self.document saveToURL:self.document.fileURL forSaveOperation:UIDocumentSaveForOverwriting completionHandler:^(BOOL success) {
NSLog(@"保存成功!");
}];
}
}
@end
到目前为止都是关于如何使用iCloud来保存文档的内容,上面也提到过还可使用iCloud来保存首选项,这在不少状况下一般颇有用,特别是对 于开发了iPhone版又开发了iPad版的应用,若是用户在一台设备上进行了首选项配置以后到另外一台设备上也能使用是多么优秀的体验啊。相比文档存储, 首选项存储要简单的多,在上面“kctest.entitlements”中能够看到首选项配置并不是像文档同样能够包含多个容器,这里只有一个Key- Value Store,一般使用NSUbiquitousKeyValueStore的defaultStore来获取,它的使用方法和 NSUserDefaults几乎彻底同样,当键值对存储发生变化后能够经过 NSUbiquitousKeyValueStoreDidChangeExternallyNotification等得到对应的通知。在上面的笔记应 用中有一个”设置“按钮用于设置退出笔记详情视图后是否自动保存,这个选项就是经过iCloud的首选项来存储的。
//
// KCSettingTableViewController.m
// kctest
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "KCSettingTableViewController.h"
#define kSettingAutoSave @"com.cmjstudio.kctest.settings.autosave"
@interface KCSettingTableViewController ()
@property (weak, nonatomic) IBOutlet UISwitch *autoSaveSetting;
@end
@implementation KCSettingTableViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self setupUI];
}
#pragma mark - UI事件
- (IBAction)autoSaveClick:(UISwitch *)sender {
[self setSetting:sender.on];
}
#pragma mark - 私有方法
-(void)setupUI{
//设置iCloud中的首选项值
NSUbiquitousKeyValueStore *defaults=[NSUbiquitousKeyValueStore defaultStore];
self.autoSaveSetting.on= [defaults boolForKey:kSettingAutoSave];
//添加存储变化通知
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(
keyValueStoreChange:) name:NSUbiquitousKeyValueStoreDidChangeExternallyNotification object:defaults];
}
/**
* key-value store发生变化或存储空间不足
*
* @param notification 通知对象
*/
-(void)keyValueStoreChange:(NSNotification *)notification{
NSLog(@"Key-value store change...");
}
/**
* 设置首选项
*
* @param value 是否自动保存
*/
-(void)setSetting:(BOOL)value{
//iCloud首选项设置
NSUbiquitousKeyValueStore *defaults=[NSUbiquitousKeyValueStore defaultStore];
[defaults setBool:value forKey:kSettingAutoSave];
[defaults synchronize];//同步
}
@end
运行效果:
注意:全部的存储到iCloud的文档、首选项都是首先存储到本地,而后经过daemon进程同步到iCloud的,保存、读取的文件都是本地同步副本并不必定是真实的iCloud存储文件。
Passbook是苹果推出的一个管理登机牌、会员卡、电影票、优惠券等信息的工具。Passbook就像一个卡包,用于存放你的购物卡、积分卡、 电影票、礼品卡等,而这些票据就是一个“Pass”。和物理票据不一样的是你能够动态更新Pass的信息,提醒用户优惠券即将过时;甚至若是你的Pass中 包含地理位置信息的话当你到达某个商店还能够动态提示用户最近商店有何种优惠活动;当用户将一张团购券添加到Passbook以后,用户到了商店以后 Passbook能够自动弹出团购券,店员扫描以后进行消费、积分等等都是Passbook的应用场景。Passbook能够管理多类票据,苹果将其划分 为五类:
苹果的划分一方面出于不一样票据功能及展现信息不一样,另外一方面也是为了统一票据的设计,下面是苹果官方关于五种票据的布局设计布局:
既然一个票据就是一个Pass,那么什么是Pass呢?在iOS中一个Pass其实就是一个.pkpass文件,事实上它是一个Zip压缩包,只是这个压缩包要按照必定的目录结构来设计,下面是一个Pass包的目录结构(注意不一样的票据类型会适当删减):
Pass Package
├── icon.png
├── icon@2x.png
├── logo.png
├── logo@2x.png
├── thumbnail.png
├── thumbnail@2x.png
├── background.png
├── background@2x.png
├── strip.png
├── strip@2x.png
├── manifest.json
├── fr.lproj
│ └── pass.strings
├── de.lproj
│ └── pass.strings
├── pass.json
└── signature
也就是说在Passbook应用中显示的内容其实就是一个按照上面文件列表来组织的一个压缩包。在.pkpass文件中除了图标icon、缩略图thumbnail和logo外最重要的就是pass.json、manifest.json和signature。
1.pass.json
这个文件描述了Pass的布局、颜色设置、文本描述信息等,也就是说具体Pass包如何展现其实就是经过这个JSON文件来配置的,关于pass.json的具体配置项在此再也不一一介绍,你们能够查看苹果官方帮助文档“Pass Design and Creation”。这里主要说一下其中关键的几个配置项:
passTypeIdentifier:pass惟一标识,这个值相似于App ID,须要从开发者中心建立,而且这个标识必须以“pass”开头(例以下面的示例中取名为“pass.com.cmjstudio.mypassbook”)。
teamIdentifier:团队标识,申请苹果开发者帐号时会分配一个惟一的团队标识(能够在苹果开发者中心--查看帐户信息中查看”Team ID“)。
barcode:二维码信息配置,主要指定二维码内容、类型、编码格式。
locations:地理位置信息,能够配置相关位置的文本信息。
2.manifest.json
manifest.json从名称能够看出这个文件主要用来描述当前Pass包中的文件目录组织结构。这个文件记录了除“manifest.json”、“signature”外的文件和对应的sha1哈希值(注意:哈希值能够经过”openssl sha1 [ 文件路径]“命令得到)。
3.signature
signature是一个签名文件。虽然manifest.json存储了哈希值,可是你们都知道hash算法是公开的,如何保证一个pass包是合法的,未经修改的呢?那就是使用一个签名文件来验证。
了解了以上内容后基本上对于如何定义一个pass包有了简单的概念。有了pass包以后对于添加pass到passbook应用是比较简单的。但事 实上一般你们看到的passbook应用中添加的pass包并非手动组织的,而是经过程序来完成pass包制做的。举例来讲:若是你在美团上购买一张电 影票以后,会告诉你一个优惠码,这个优惠码会显示到pass中。因为这个优惠码是动态生成的,因此直接手动制做出一个pass包是不现实的。一般状况下 pass包的生成都是经过后台服务器动态生成,而后返回给iOS客户端来读取和添加的,手动制做pass包的状况是比较少的,除非你的票据信息是一成不变 的。固然为了演示Passbook应用,这里仍是会以手动方式演示一个pass包的生成过程,了解了这个过程以后相信在服务器端经过一些后台程序生成一个 pass包也不在话下(下面的生成过程都可经过服务器端编程来实现)。
同其余Apple服务开发相似,作Passbook开发一样须要一些准备工做:
下载证书后,将此证书导入Mac中(此处配置的Pass Type ID对应pass.json中的”passTypeIdentitifier“,此证书用于生成签名文件signature。)。
有了上面的准备工做,下面看一下如何制做一个Pass:
{
"formatVersion":1,
"passTypeIdentifier":"pass.com.cmjstudio.mypassbook",
"serialNumber":"54afe978584e3",
"teamIdentifier":"JB74M3J7RY",
"authenticationToken":"bc83dde3304d766d5b1aea631827f84c",
"barcode":{"message":"userName KenshinCui","altText":"会员详情见背面","format":"PKBarcodeFormatQR","messageEncoding":"iso-8859-1"},
"locations":[
{"longitude":-122.3748889,"latitude":37.6189722},{"longitude":-122.03118,"latitude":37.33182}],
"organizationName":"CMJ Coffee",
"logoText":"CMJ Coffee",
"description":"",
"foregroundColor":"rgb(2,2,4)",
"backgroundColor":"rgb(244,244,254)",
"storeCard":{
"headerFields":[{"key":"date","label":"余额","value":"¥8888.50"}],
"secondaryFields":[{"key":"more","label":"VIP会员","value":"Kenshin Cui"}],
"backFields":[
{"key":"records","label":"消费记录(最近10次)","value":" 9/23 ¥107.00 无糖冰美式\n 9/21 ¥58.00 黑魔卡\n 8/25 ¥44.00 魔卡\n 8/23 ¥107.00 无糖冰美式\n 8/18 ¥107.00 无糖冰美式\n 7/29 ¥58.00 黑魔卡\n 7/26 ¥44.00 魔卡\n 7/13 ¥58.00 黑魔卡\n 7/11 ¥44.00 魔卡\n 6/20 ¥44.00 魔卡\n"},
{"key":"phone","label":"联系方式","value":"4008-888-88"},
{"key":"terms","label":"会员规则","value":"(1)本电子票涉及多个环节,均为人工操做,用户下单后,1-2个工做日内下发,电子票并不必定能当即收到,建议千品用户提早1天购买,如急需使用,请谨慎下单; \n(2)此劵为电子劵,属特殊产品,一经购买不支持退款(敬请谅解); \n(3)特别注意:下单时请将您须要接收电子票的手机号码,填入收件人信息,如号码填写错误,损失自负;购买成功后,商家于周一至周五天天中午11点和下午17点发2维码/短信到您手机(周六至周日当天晚上发1次),请用户提早购买,凭此信息前往影院前台兑换便可; \n(4)订购成功后,(您在购买下单后的当天,给您发送电子券,系统会自动识别;若是您的手机能接收二维码,那收到的就是彩信,不能接收二维码的话,系统将会自动转成短信发送给您),短信为16位数,如:1028**********; 每一个手机号码只可购买6张,如需购买6张以上的请在订单附言填写不一样的手机号码,并注明张数(例如团购10张,1350755****号码4张,1860755****号码6张);\n(5)电子票有效期至2016年2月30日,不与其余优惠券同时使用"},
{"key":"support","label":"技术支持","value":"http://www.cmjstudio.com\n\n \n \n "}]
},
"labelColor":"rgb(87,88,93)"
}
{
"pass.json":"3292f96c4676aefe7122abb47f86be0d95a6faaf",
"icon@2x.png":"83438c13dfd7c4a5819a12f6df6dc74b71060289",
"icon.png":"83438c13dfd7c4a5819a12f6df6dc74b71060289",
"logo@2x.png":"83438c13dfd7c4a5819a12f6df6dc74b71060289",
"logo.png":"83438c13dfd7c4a5819a12f6df6dc74b71060289",
"strip@2x.png":"885ff9639c90147a239a7a77e7adc870d5e047e2",
"strip.png":"885ff9639c90147a239a7a77e7adc870d5e047e2"
}
openssl pkcs12 -in mypassbook.p12 -clcerts -nokeys -out mypassbook.pem -passin pass:456789
d.从.p12导出秘钥文件mypassbookkey.pem(这里设置密码为123456): openssl pkcs12 -in mypassbook.p12 -nocerts -out mypassbookkey.pem -passin pass:456789 -passout pass:123456
openssl smime -binary -sign -certfile AWDRCA.pem -signer mypassbook.pem -inkey mypassbookkey.pem -in manifest.json -out signature -outform DER
zip -r mypassbook.pkpass manifest.json pass.json signature logo.png logo@2x.png icon.png icon@2x.png strip.png strip@2x.png
到这里一个pass制做完成了,此处能够在mac中打开预览:
到这里一个Pass就只作完成了,下面就看一下在iOS中如何添加这个Pass到Passbook,这里直接将上面制做完成的Pass放到 Bundle中完成添加。固然这些都是一步步手动完成的,前面也说了实际开发中这个Pass是服务器端来动态生成的,在添加时会从服务器端下载,这个过程 在示例中就再也不演示。iOS中提供了PassKit.framework框架来进行Passbook开发,下面的代码演示了添加Pass到 Passbook应用的过程:
//
// ViewController.m
// Passbook
//
// Created by Kenshin Cui on 14/4/5.
// Copyright (c) 2015年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import <PassKit/PassKit.h>
@interface ViewController ()<PKAddPassesViewControllerDelegate>
@property (strong,nonatomic) PKPass *pass;//票据
@property (strong,nonatomic) PKAddPassesViewController *addPassesController;//票据添加控制器
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
- (IBAction)addPassClick:(UIBarButtonItem *)sender {
//确保pass合法,不然没法添加
[self addPass];
}
#pragma mark - 属性
/**
* 建立Pass对象
*
* @return Pass对象
*/
-(PKPass *)pass{
if (!_pass) {
NSString *passPath=[[NSBundle mainBundle] pathForResource:@"mypassbook.pkpass" ofType:nil];
NSData *passData=[NSData dataWithContentsOfFile:passPath];
NSError *error=nil;
_pass=[[PKPass alloc]initWithData:passData error:&error];
if (error) {
NSLog(@"建立Pass过程当中发生错误,错误信息:%@",error.localizedDescription);
return nil;
}
}
return _pass;
}
/**
* 建立添加Pass的控制器
*
* @return <#return value description#>
*/
-(PKAddPassesViewController *)addPassesController{
if (!_addPassesController) {
_addPassesController=[[PKAddPassesViewController alloc]initWithPass:self.pass];
_addPassesController.delegate=self;//设置代理
}
return _addPassesController;
}
#pragma mark - 私有方法
-(void)addPass{
if (![PKAddPassesViewController canAddPasses]) {
NSLog(@"没法添加Pass.");
return;
}
[self presentViewController:self.addPassesController animated:YES completion:nil];
}
#pragma mark - PKAddPassesViewController代理方法
-(void)addPassesViewControllerDidFinish:(PKAddPassesViewController *)controller{
NSLog(@"添加成功.");
[self.addPassesController dismissViewControllerAnimated:YES completion:nil];
//添加成功后转到Passbook应用并展现添加的Pass
NSLog(@"%@",self.pass.passURL);
[[UIApplication sharedApplication] openURL:self.pass.passURL];
}
@end
运行效果:
注意:若是你们对于Pass不是太熟悉,刚开始可使用一些制做工具来完成Pass制做,例如:PassSource、国内的PassQuan等都支持在线制做Pass包。
文章来源:http://www.cnblogs.com/kenshincui/p/4220402.html