前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >iOS开发中活动视图控制器UIActivityViewController的应用

iOS开发中活动视图控制器UIActivityViewController的应用

作者头像
珲少
发布2018-08-15 15:01:12
3.2K1
发布2018-08-15 15:01:12
举报
文章被收录于专栏:一“技”之长一“技”之长

iOS开发中活动视图控制器UIActivityViewController的应用

    在iOS开发中,UIActivityViewController常用来弹出分享面板,其实除了用来社会化分享,UIActivityViewController还有一大应用是用来进行自定义行为。先看如下示例代码:

代码语言:javascript
复制
    //活动内容
    NSString * content = @"活动的内容";
    //活动的url
    NSURL * url = [NSURL URLWithString:@"https://www.baidu.com"];
    //活动的图片
    UIImage * image = [UIImage imageNamed:@"ios"];
    UIActivityViewController * con = [[UIActivityViewController alloc]initWithActivityItems:@[content,url,image] applicationActivities:nil];
    //活动行为结束后回调的block
    con.completionWithItemsHandler = ^(UIActivityType activityType, BOOL completed, NSArray * returnedItems, NSError * __nullable activityError){
        NSLog(@"%@\n%@",activityType,returnedItems);
    };
    [self presentViewController:con animated:YES completion:nil];

活动面板如下图:

需要注意,活动面板可以分为3个部分,最上面为AirDrop传输功能,中间为分享相关功能,最下面为数据处理功能。UIActivityViewController继承自UIViewController,类解析如下:

代码语言:javascript
复制
//初始化方法
- (instancetype)init;
- (instancetype)initWithNibName:(nullable NSString *)nibNameOrNil bundle:(nullable NSBundle *)nibBundleOrNil;
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder;
/*
activityItems参数用来设置活动数据数组,其中可以是任意类型的对象,但是只有可以处理这些数据的行为会被展示出来
applicationActivitie参数可以设置自定义的操作行为,后面会介绍
*/
- (instancetype)initWithActivityItems:(NSArray *)activityItems applicationActivities:(nullable NSArray<__kindof UIActivity *> *)applicationActivitie;
/*
活动行为结束后执行的回调block,其中参数如下:
typedef void (^UIActivityViewControllerCompletionWithItemsHandler)(UIActivityType __nullable activityType, BOOL completed, NSArray * __nullable returnedItems, NSError * __nullable activityError);
activityType:活动的类型
completed:活动是否完成
returnItems:扩展程序返回的数据
*/
@property(nullable, nonatomic, copy) UIActivityViewControllerCompletionWithItemsHandler completionWithItemsHandler;
//这个参数可以设置不被显示的活动类型
@property(nullable, nonatomic, copy) NSArray<UIActivityType> *excludedActivityTypes;

//下面这些方法在iOS8后被弃用 在iOS6-iOS8之前可用
//设置活动行为结束后回调的block
/*
typedef void (^UIActivityViewControllerCompletionHandler)(UIActivityType __nullable activityType, BOOL completed);
*/
@property(nullable, nonatomic, copy) UIActivityViewControllerCompletionHandler completionHandler;

上面初始化方法中有提到activityItems这个参数,系统提供的一些分享与活动行为可支持的数据类型列表如下:

    系统提供了一些活动类型,例如分享到微博、脸书、进行添加提示、发送信息等,系统提供的活动类型列举如下(UIActivityType实际上就是NSString*):

代码语言:javascript
复制
UIActivityType const UIActivityTypePostToFacebook;//脸书
UIActivityType const UIActivityTypePostToTwitter;//推特
UIActivityType const UIActivityTypePostToWeibo;  // 微博
UIActivityType const UIActivityTypeMessage;//发送信息
UIActivityType const UIActivityTypeMail;//发送邮件
UIActivityType const UIActivityTypePrint;//打印
UIActivityType const UIActivityTypeCopyToPasteboard;//复制
UIActivityType const UIActivityTypeAssignToContact;//关联到联系人
UIActivityType const UIActivityTypeSaveToCameraRoll;//存照片
UIActivityType const UIActivityTypeAddToReadingList;//添加到提醒列表
UIActivityType const UIActivityTypePostToFlickr;//Flickr
UIActivityType const UIActivityTypePostToVimeo;//Vimeo
UIActivityType const UIActivityTypePostToTencentWeibo;//腾讯微博
UIActivityType const UIActivityTypeAirDrop;//AirDrop
UIActivityType const UIActivityTypeOpenInIBooks;//在IBooks中打开

    自定义活动行为需要创建继承于UIActivity类的子类,示例如下:

代码语言:javascript
复制
#import "CustomActivity.h"

@implementation CustomActivity
//设置活动类别
+(UIActivityCategory)activityCategory{
    return UIActivityCategoryShare;
}
//设置活动类型
-(UIActivityType)activityType{
    return @"Custom";
}
//设置活动标题
-(NSString *)activityTitle{
    return @"title";
}
//设置活动图标
-(UIImage *)activityImage{
    return [UIImage imageNamed:@"ios"];
}
//设置是否可以对指定的数据进行响应
-(BOOL)canPerformWithActivityItems:(NSArray *)activityItems{
    NSLog(@"%@",activityItems);
    return YES;
}
//为要响应的活动进行准备工作
- (void)prepareWithActivityItems:(NSArray *)activityItems{
    
}
//响应互动
-(void)performActivity{
    NSLog(@"=========");
    //活动处理完成后 必须调用activityDidFinish函数
    [self activityDidFinish:YES];
}

@end

用自定义的活动对UIActivityViewController进行初始化:

代码语言:javascript
复制
    NSString * content = @"活动的内容";
    NSURL * url = [NSURL URLWithString:@"https://www.baidu.com"];
    UIImage * image = [UIImage imageNamed:@"ios"];
    CustomActivity * activity = [[CustomActivity alloc]init];
    UIActivityViewController * con = [[UIActivityViewController alloc]initWithActivityItems:@[content,url,image] applicationActivities:@[activity]];
    con.completionWithItemsHandler = ^(UIActivityType activityType, BOOL completed, NSArray * returnedItems, NSError * __nullable activityError){
        NSLog(@"%@\n%@",activityType,returnedItems);
    };
    [self presentViewController:con animated:YES completion:nil];

效果如下图所示:

    UIActivity类解析如下:

代码语言:javascript
复制
//子类实现,设置自定义活动的类别
/*
typedef NS_ENUM(NSInteger, UIActivityCategory) {
    UIActivityCategoryAction,//行为类别 显示在活动面板下面
    UIActivityCategoryShare,//分享类别,显示在活动面板中间
};
*/
+ (UIActivityCategory)activityCategory;
//子类实现 设置自定义活动的类型 返回字符串
- (nullable UIActivityType)activityType;
//子类实现 设置自定义活动的标题 返回字符串 
- (nullable NSString *)activityTitle;
//子类实现 设置自定义活动的图标 UIImage  
- (nullable UIImage *)activityImage; 
//子类实现 activityItems为活动数据数组 返回布尔值决定此活动是否可以响应这些数据
- (BOOL)canPerformWithActivityItems:(NSArray *)activityItems;
//子类实现 如果上面的方法返回YES,会接着执行这个方法,开发者可以做些活动处理的准备
- (void)prepareWithActivityItems:(NSArray *)activityItems;
//子类实现 返回一个视图控制器作为处理活动的模态视图 活动处理完成后需要调用activityDidFinish方法 
- (nullable UIViewController *)activityViewController; 
//子类实现 如果子类没有实现上一个方法 或者返回nil,则会执行这个方法来处理活动 活动处理完成后需要调用activityDidFinish方法
- (void)performActivity; 
//活动处理完成后需要调用这个方法 之后会通知UIActivityViewController执行活动完成后的回调block
- (void)activityDidFinish:(BOOL)completed;
本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2017/05/15 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • iOS开发中活动视图控制器UIActivityViewController的应用
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档