系統(tǒng)分享功能使用實(shí)現(xiàn)UIActivityViewController,可以分享文字,圖片,音視頻到其它平臺(tái)。
// 1. 初始化,創(chuàng)建分享控制器(系統(tǒng)服務(wù)對(duì)象)
let activityViewController = UIActivityViewController(activityItems: activityItems, applicationActivities:nil)
present(activityViewController, animated: true, completion: nil)
UIActivityViewController有2個(gè)參數(shù)
activityItems:設(shè)置分享的內(nèi)容,可以是任意類型
applicationActivities:表示應(yīng)用程序支持的自定義服務(wù)對(duì)象數(shù)組,一般我們寫(xiě)nil;如果需要我們自定義服務(wù)對(duì)象時(shí),官方文檔解釋,UIActivity必須通過(guò)繼承的方式來(lái)使用,重寫(xiě)方法,本文下面會(huì)有介紹。
// 2. 設(shè)定分享內(nèi)容
let textShare = "我和春天有個(gè)約定"
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.設(shè)置操作回調(diào),用戶點(diǎn)擊 菜單按鈕后事件執(zhí)行完成會(huì)回調(diào)這個(gè)block
activityViewController.completionWithItemsHandler = {(_ activityType: UIActivity.ActivityType?, _ completed: Bool, _ returnedItems: [Any]?, _ activityError: Error?) -> Void in
print(completed ? "成功" : "失敗")
}
// 4.設(shè)定不想顯示的平臺(tái)和功能
activityViewController.excludedActivityTypes = [
.addToReadingList,
.postToFacebook,
.postToTwitter,
.copyToPasteboard,
.assignToContact,
.postToVimeo,
.openInIBooks,
.postToFlickr
]
以下是支持分享到的平臺(tái),我們可以自定義設(shè)置想要分享到的平臺(tái)。
typedef NSString * UIActivityType NS_TYPED_EXTENSIBLE_ENUM;
該對(duì)象將提供的內(nèi)容發(fā)布到Facebook上的用戶墻上。(↓)
UIKIT_EXTERN UIActivityType const UIActivityTypePostToFacebook API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
該對(duì)象將提供的內(nèi)容發(fā)布到用戶的Twitter提要。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToTwitter API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
該對(duì)象將提供的內(nèi)容發(fā)布到用戶的微博上。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToWeibo API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED; // SinaWeibo
該對(duì)象將提供的內(nèi)容發(fā)布到消息應(yīng)用程序。
UIKIT_EXTERN UIActivityType const UIActivityTypeMessage API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
該對(duì)象將提供的內(nèi)容發(fā)布到新的電子郵件中。
UIKIT_EXTERN UIActivityType const UIActivityTypeMail API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
對(duì)象打印提供的內(nèi)容。
UIKIT_EXTERN UIActivityType const UIActivityTypePrint API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
對(duì)象將提供的內(nèi)容復(fù)制到粘貼板。
UIKIT_EXTERN UIActivityType const UIActivityTypeCopyToPasteboard API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
對(duì)象將圖像分配給聯(lián)系人。
UIKIT_EXTERN UIActivityType const UIActivityTypeAssignToContact API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
對(duì)象將圖像或視頻分配給用戶的照相機(jī)卷。
UIKIT_EXTERN UIActivityType const UIActivityTypeSaveToCameraRoll API_AVAILABLE(ios(6.0)) __TVOS_PROHIBITED;
對(duì)象將URL添加到Safari的閱讀列表中。
UIKIT_EXTERN UIActivityType const UIActivityTypeAddToReadingList API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
對(duì)象將提供的圖像發(fā)布到用戶的Flickr帳戶。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToFlickr API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
該對(duì)象將提供的視頻發(fā)布到用戶的Vimeo帳戶。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToVimeo API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
該對(duì)象將提供的內(nèi)容發(fā)布到用戶的騰訊微博上。
UIKIT_EXTERN UIActivityType const UIActivityTypePostToTencentWeibo API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
該對(duì)象通過(guò)AirDrop提供所提供的內(nèi)容。
UIKIT_EXTERN UIActivityType const UIActivityTypeAirDrop API_AVAILABLE(ios(7.0)) __TVOS_PROHIBITED;
對(duì)象打開(kāi)iBooks中的內(nèi)容。
UIKIT_EXTERN UIActivityType const UIActivityTypeOpenInIBooks API_AVAILABLE(ios(9.0)) __TVOS_PROHIBITED;
PDF內(nèi)容
UIKIT_EXTERN UIActivityType const UIActivityTypeMarkupAsPDF API_AVAILABLE(ios(11.0)) __TVOS_PROHIBITED;
自定義服務(wù)對(duì)象
創(chuàng)建個(gè)類,比如demo中的ShareCustomActivity類,繼承自UIActivity,重寫(xiě)下面的方法
- activityType:是提供的服務(wù)類型的標(biāo)識(shí)符,一般返回自定義的類名
- activityTitle:自定的服務(wù)的標(biāo)題
- activityImage:自定的服務(wù)的LOGO
- canPerform(withActivityItems:):對(duì)分享的內(nèi)容做下預(yù)判斷,看是否需要進(jìn)行分享
- prepare(withActivityItems:):點(diǎn)擊分享按鈕后,對(duì)分享進(jìn)行操作
- activityCategory:分享的類型,分為share和action.
import UIKit
class ShareCustomActivity: UIActivity {
//用于保存?zhèn)鬟f過(guò)來(lái)的要分享的數(shù)據(jù)
var text:String!
var url:URL!
var image:UIImage!
//顯示在分享框里的名稱
override var activityTitle: String? {
return "我和春天有個(gè)約定"
}
//分享框的圖片
override var activityImage: UIImage? {
return UIImage.init(named: "default")
}
//分享類型,在UIActivityViewController.completionHandler回調(diào)里可以用于判斷,一般取當(dāng)前類名
override var activityType: UIActivity.ActivityType? {
return UIActivity.ActivityType(rawValue: ShareCustomActivity.self.description())
}
//按鈕類型(分享按鈕:在第一行,彩色,動(dòng)作按鈕:在第二行,黑白)
override class var activityCategory: UIActivity.Category {
return .share
}
//是否顯示分享按鈕,這里一般根據(jù)用戶是否授權(quán),或分享內(nèi)容是否正確等來(lái)決定是否要隱藏分享按鈕
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
}
//解析分享數(shù)據(jù)時(shí)調(diào)用,可以進(jìn)行一定的處理
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)
}
}
}
//執(zhí)行分享行為
//這里根據(jù)自己的應(yīng)用做相應(yīng)的處理
//例如你可以分享到另外的app例如微信分享,也可以保存數(shù)據(jù)到照片或其他地方,甚至分享到網(wǎng)絡(luò)
override func perform() { //具體的執(zhí)行代碼這邊先省略
//......
activityDidFinish(true)
}
//分享時(shí)調(diào)用
override var activityViewController: UIViewController? {
return nil
}
//完成分享后調(diào)用
override func activityDidFinish(_ completed: Bool) {
}
}
在創(chuàng)建UIActivityViewController時(shí),這樣初始化,其它不變
// 2.創(chuàng)建分享的控制器
let activityViewController = UIActivityViewController(activityItems: activityItems, applicationActivities:nil)
present(activityViewController, animated: true, completion: nil)
IMG_E7883F9C7FB0-1.jpeg