UIActivityViewController

系统分享功能使用实现UIActivityViewController,可以分享文字,图片,音视频到其它平台。

// 1. 初始化,创建分享控制器(系统服务对象)
let activityViewController = UIActivityViewController(activityItems: activityItems, applicationActivities:nil)
present(activityViewController, animated: true, completion: nil)

UIActivityViewController有2个参数
activityItems:设置分享的内容,可以是任意类型
applicationActivities:表示应用程序支持的自定义服务对象数组,一般我们写nil;如果需要我们自定义服务对象时,官方文档解释,UIActivity必须通过继承的方式来使用,重写方法,本文下面会有介绍。

// 2. 设定分享内容
let textShare = "我和春天有个约定"
let url = URL(string: "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1606315513868&di=8331cfcbb4880907431b3d70f8433858&imgtype=0&src=http%3A%2F%2Fimage.biaobaiju.com%2Fuploads%2F20180801%2F23%2F1533137895-AicBmZsTWl.jpg")
let data = try? Data(contentsOf: url!)
let imageShare = UIImage(data: data!)

let urlShare = URL(string: "http://www.baidu.com")
let activityItems = [textShare,imageShare as Any,urlShare as Any]

// 3.设置操作回调,用户点击 菜单按钮后事件执行完成会回调这个block
activityViewController.completionWithItemsHandler = {(_ activityType: UIActivity.ActivityType?, _ completed: Bool, _ returnedItems: [Any]?, _ activityError: Error?) -> Void in
    print(completed ? "成功" : "失败")
}

// 4.设定不想显示的平台和功能
activityViewController.excludedActivityTypes = [
    .addToReadingList,
    .postToFacebook,
    .postToTwitter,
    .copyToPasteboard,
    .assignToContact,
    .postToVimeo,
    .openInIBooks,
    .postToFlickr
]

以下是支持分享到的平台,我们可以自定义设置想要分享到的平台。
typedef NSString * UIActivityType NS_TYPED_EXTENSIBLE_ENUM;
该对象将提供的内容发布到Facebook上的用户墙上。(↓)
UIKIT_EXTERN UIActivityType const UIActivityTypePostToFacebook     API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
该对象将提供的内容发布到用户的Twitter提要。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToTwitter      API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
该对象将提供的内容发布到用户的微博上。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToWeibo        API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;    // SinaWeibo
该对象将提供的内容发布到消息应用程序。
UIKIT_EXTERN UIActivityType const UIActivityTypeMessage            API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
该对象将提供的内容发布到新的电子邮件中。
UIKIT_EXTERN UIActivityType const UIActivityTypeMail               API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
对象打印提供的内容。
UIKIT_EXTERN UIActivityType const UIActivityTypePrint              API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
对象将提供的内容复制到粘贴板。
UIKIT_EXTERN UIActivityType const UIActivityTypeCopyToPasteboard   API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
对象将图像分配给联系人。
UIKIT_EXTERN UIActivityType const UIActivityTypeAssignToContact    API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
对象将图像或视频分配给用户的照相机卷。
UIKIT_EXTERN UIActivityType const UIActivityTypeSaveToCameraRoll   API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
对象将URL添加到Safari的阅读列表中。
UIKIT_EXTERN UIActivityType const UIActivityTypeAddToReadingList   API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
对象将提供的图像发布到用户的Flickr帐户。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToFlickr       API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
该对象将提供的视频发布到用户的Vimeo帐户。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToVimeo        API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
该对象将提供的内容发布到用户的腾讯微博上。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToTencentWeibo API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
该对象通过AirDrop提供所提供的内容。
UIKIT_EXTERN UIActivityType const UIActivityTypeAirDrop            API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
对象打开iBooks中的内容。
UIKIT_EXTERN UIActivityType const UIActivityTypeOpenInIBooks       API_AVAILABLE(ios(9.0)) __TVOS_PROHIBITED;
PDF内容
UIKIT_EXTERN UIActivityType const UIActivityTypeMarkupAsPDF        API_AVAILABLE(ios(11.0)) __TVOS_PROHIBITED;
自定义服务对象

创建个类,比如demo中的ShareCustomActivity类,继承自UIActivity,重写下面的方法

  1. activityType:是提供的服务类型的标识符,一般返回自定义的类名
  2. activityTitle:自定的服务的标题
  3. activityImage:自定的服务的LOGO
  4. canPerform(withActivityItems:):对分享的内容做下预判断,看是否需要进行分享
  5. prepare(withActivityItems:):点击分享按钮后,对分享进行操作
  6. activityCategory:分享的类型,分为share和action.
import UIKit

class ShareCustomActivity: UIActivity {
    //用于保存传递过来的要分享的数据
    var text:String!
    var url:URL!
    var image:UIImage!
     
    //显示在分享框里的名称
    override var activityTitle: String?  {
        return "我和春天有个约定"
    }
     
    //分享框的图片
    override var activityImage: UIImage? {
        return UIImage.init(named: "default")
    }

     
    //分享类型,在UIActivityViewController.completionHandler回调里可以用于判断,一般取当前类名
    override var activityType: UIActivity.ActivityType? {
        return UIActivity.ActivityType(rawValue: ShareCustomActivity.self.description())
    }
     
    //按钮类型(分享按钮:在第一行,彩色,动作按钮:在第二行,黑白)
    override class var activityCategory: UIActivity.Category {
        return .share
    }
     
    //是否显示分享按钮,这里一般根据用户是否授权,或分享内容是否正确等来决定是否要隐藏分享按钮
    override func canPerform(withActivityItems activityItems: [Any]) -> Bool {
        for item in activityItems {
            if item is UIImage {
                return true
            }
            if item is String {
                return true
            }
            if item is URL {
                return true
            }
        }
        return false
    }
     
    //解析分享数据时调用,可以进行一定的处理
    override func prepare(withActivityItems activityItems: [Any]) {
        for item in activityItems {
            if item is UIImage {
                image = (item as! UIImage)
            }
            if item is String {
                text = (item as! String)
            }
            if item is URL {
                url = (item as! URL)
            }
        }
    }
     
    //执行分享行为
    //这里根据自己的应用做相应的处理
    //例如你可以分享到另外的app例如微信分享,也可以保存数据到照片或其他地方,甚至分享到网络
    override func perform() {        //具体的执行代码这边先省略
        //......
        activityDidFinish(true)
    }
     
    //分享时调用
    override var activityViewController: UIViewController? {
        return nil
    }
     
    //完成分享后调用
    override func activityDidFinish(_ completed: Bool) {
    }
}

在创建UIActivityViewController时,这样初始化,其它不变
// 2.创建分享的控制器
let activityViewController = UIActivityViewController(activityItems: activityItems, applicationActivities:nil)
present(activityViewController, animated: true, completion: nil)
IMG_E7883F9C7FB0-1.jpeg

你可能感兴趣的:(UIActivityViewController)