在 iOS 分享

本指南詳細說明如何從您的 iOS 應用程式啟用分享至 Facebook。當用戶從您的應用程式進行分享時,其內容會顯示在用戶的「生活時報」以及用戶朋友的「動態消息」中。

用戶也可以使用 Messenger Expression Platform 從您的應用程式將內容分享至 Facebook Messenger,或者從 iOS SDK 中的分享的「訊息」對話框分享。

iOS 專用 Messenger SDK「訊息」對話框

必要條件

您需要先進行下列操作,才能夠新增分享至您的應用程式:

  • iOS 專用 Facebook SDK 新增至您的流動開發環境
  • 設定並連結您的 Facebook 應用程式編號
  • 新增您的應用程式編號、顯示名稱,並提供容易理解的理由陳述,說明為什麼您需要存取應用程式 .plist 檔案的相片。
  • FBSDKShareKit.framework 連結至您的專案。

您的應用程式不應該預先填入任何要分享的內容。這和 Facebook 開放平台政策不一致,請參閱 Facebook 開放平台政策第 2.3 節

iOS SDK 新手指南

建立內容模型

Facebook SDK 4.0+ 版包含用於分享內容的新模型。每一個內容類型都有一個介面,您可以用來代表其符合 <FBSDKSharingContent>。建立內容的模型之後,請對您符合 <FBSDKSharing> 的應用程式新增分享介面,例如 FBSDKShareDialog

當用戶從您的應用程式分享連結至 Facebook 時,contentURL 會與連結一併分享。請使用 FBSDKShareLinkContent 模型建立連結的分享內容。如需所有屬性的清單,請參閱 FBSDKShareLinkContent 參考資料

從 2017 年 4 年 18 日開始,Graph API 2.9 版及更新的版本將不再支援下列參數。2.8 版及更舊的版本將持續支援這些參數至 2017 年 7 年 17 日止。

  • contentTitle - 代表連結中的內容標題
  • imageURL - 顯示在帖子上的縮圖圖像網址
  • contentDescription - 內容的說明,通常為 2 至 4 個句子

以下是如何觸發分享的範例:

FBSDKShareLinkContent *content = [[FBSDKShareLinkContent alloc] init];
content.contentURL = [NSURL URLWithString:@"https://developers.facebook.com"];

注意: 如果您的應用程式分享連結至 iTunes 或 Google Play 商店,我們不會張貼您在分享中指定的任何圖像或說明。相反,我們會張貼使用 Webcrawler 直接從應用程式商店抓取的部分應用程式資訊。此資訊可能不含圖像。若要預覽 iTunes 或 Google Play 的連結分享,請在分享錯誤檢查工具中輸入您的網址。

相片

用戶可以使用「分享」對話框或自訂介面,從您的應用程式將相片分享至 Facebook:

  • 相片大小不得超過 12MB
  • 用戶需要安裝原生 iOS 版 Facebook 應用程式 7.0 版或更高版本

請使用 FBSDKSharePhotoContent 模型建立相片的分享內容。如需所有屬性的清單,請參閱 FBSDKSharePhotoContent 參考資料

- (void)imagePickerController:(UIImagePickerController *)picker
didFinishPickingMediaWithInfo:(NSDictionary *)info
{
  UIImage *image = info[UIImagePickerControllerOriginalImage];

  FBSDKSharePhoto *photo = [[FBSDKSharePhoto alloc] init];
  photo.image = image;
  photo.userGenerated = YES;
  FBSDKSharePhotoContent *content = [[FBSDKSharePhotoContent alloc] init];
  content.photos = @[photo];
  ...
}

影片

使用您應用程式的用戶可以使用「分享」對話框或您的自訂介面,將影片分享至 Facebook:

  • 影片大小不得超過 12MB。
  • 進行分享的用戶應該安裝 iOS 專用 Facebook 用戶端版本 26.0 或更高版本。

請使用 FBSDKShareVideoContent 模型建立您的影片分享內容。如需所有屬性的清單,請參閱 FBSDKShareVideoContent 參考資料

- (void)imagePickerController:(UIImagePickerController *)picker
didFinishPickingMediaWithInfo:(NSDictionary *)info
{
  NSURL *videoURL = [info objectForKey:UIImagePickerControllerReferenceURL];

  FBSDKShareVideo *video = [[FBSDKShareVideo alloc] init];
  video.videoURL = videoURL;
  FBSDKShareVideoContent *content = [[FBSDKShareVideoContent alloc] init];
  content.video = video;
  ...
}

影片網址 videoURL 必須是資源網址。您可以從 UIImagePickerController 等取得影片資源網址。

多媒體

應用程式用戶可以使用分享對話框,分享相片及影片的組合至 Facebook。注意下列事項:

  • 用戶必須使用 iOS 7.0 以上版本。
  • 進行分享的用戶應該安裝 iOS 專用 Facebook 用戶端 52.0 版或更新版本。
  • 每個相片及影片的大小不得超過 12MB。
  • 用戶可分享最多 1 個影片和多達 29 張相片,或是 30 張相片。

使用 FBSDKShareMediaContent 模組建立您的多媒體分享內容。如需所有屬性的清單,請參閱 FBSDKShareMediaContent 參考資料

FBSDKSharePhoto *photo = [FBSDKSharePhoto photoWith...
FBSDKShareVideo *video = [FBSDKShareVideo videoWith...
FBSDKShareMediaContent *content = [FBSDKShareMediaContent new];
content.media = @[photo, video];
}

分享方式

透過建立模型完成處理內容之後,您可以觸發「分享」對話框或「訊息」對話框或者您自己的自訂介面進行分享。

按鈕

在 iOS 上,Facebook 具有可觸發分享的原生按鈕。


「讚好」按鈕

使用「讚好」按鈕是用戶和朋友分享內容的快速方法。點一下「讚好」按鈕即可從您的應用程式對某些內容片段「讚好」,並將內容分享至 Facebook。若要將「讚好」按鈕新增至您的檢視,請在您的檢視中新增下列程式碼片段:

FBSDKLikeControl *button = [[FBSDKLikeControl alloc] init];
button.objectID = @"https://www.facebook.com/FacebookDevelopers";
[self.view addSubview:button];

「分享」按鈕

藉由「分享」按鈕,您可以允許用戶將內容分享至自己的 Facebook 生活時報或者朋友的生活時報,或者在群組中分享。「分享」按鈕將會調用「分享」對話框。若要將「分享」按鈕新增至您的檢視,請在您的檢視中新增下列程式碼片段:

FBSDKShareButton *button = [[FBSDKShareButton alloc] init];
button.shareContent = content;  
[self.view addSubview:button];

「傳送」按鈕

「傳送」按鈕可讓用戶使用 Facebook Messenger 以私密方式將相片、影片和連結傳送給朋友和聯絡人。「傳送」按鈕將會調用「訊息」對話框。若要將「傳送」按鈕新增至您的檢視,請在您的檢視中新增下列程式碼片段:

FBSDKSendButton *button = [[FBSDKSendButton alloc] init];
button.shareContent = content; 
[self.view addSubview:button];

如果未安裝 Messenger 應用程式,「傳送」按鈕會隱藏。請確定此按鈕處於隱藏狀態時,您的應用程式版面仍然正確。若要檢查「傳送」按鈕是否可以顯示在目前的裝置上,請使用 FBSDKSendButton 屬性 isHidden

if (button.isHidden) {
  NSLog(@"Is hidden");
} else {
  [self.view addSubview:button];
}

「分享」對話框

若要使用 Facebook 建立的分享體驗,您要依前述建立內容模型區段定義您的內容,然後調用「分享」對話框。例如,若要使用「分享」對話框來分享連結:

FBSDKShareLinkContent *content = [[FBSDKShareLinkContent alloc] init];
content.contentURL = [NSURL URLWithString:@"http://developers.facebook.com"];
[FBSDKShareDialog showFromViewController:self
                              withContent:content
                                 delegate:nil];

在舊版 iOS 專用 SDK 中,您的應用程式需要先檢查是否已安裝原生 Facebook 應用程式,然後才能開啟「分享」對話框。如果用戶尚未安裝該應用程式,您需要自行提供程式碼以調用後援對話框。

現在,SDK 會自動檢查原生 Facebook 應用程式。如果未安裝,SDK 會將用戶切換至其預設瀏覽器並開啟動態對話框。如果用戶要分享「開放式圖表」動態,SDK 會開啟網頁分享對話框

如果已經安裝原生 Facebook 應用程式,SDK V4.0-V4.4 將切換至原生 iOS 專用 Facebook 應用程式,然後在發佈帖子之後將控制權返回至您的應用程式。如果您使用 SDK V4.5+,用戶將會看到 iOS 分享表格;除非分享是一個開放式圖表動態,否則不會將用戶切換至原生 iOS 專用 Facebook 應用程式。

「訊息」對話框

訊息對話框會切換至原生 iOS 版 Messenger 應用程式,然後在發佈帖子之後將控制權返回至您的應用程式。

[FBSDKMessageDialog showWithContent:content delegate:nil];

注意: 目前,iPad 並不支援訊息對話框。

iOS 整合

iOS 6+ 包含原生分享表格,可讓用戶將近況更新、相片、影片和連結張貼至 Facebook,並支援設定帖子的分享對象和使用地點來標註帖子。您無法使用分享表格分享開放式圖表動態。Facebook SDK 支援使用此原生控制器;從 Facebook SDK V4.5 開始,這是當您調用 Facebook「分享」對話框時,用戶在大多數情況下將會看到的體驗。

使用 iOS 分享表格必須遵循 Facebook 開放平台政策,其中包括 2.3 節:不可預先填入分享表格的內容。這表示如果應用程式用戶不曾輸入內容,應用程式就不能預先填入分享表格的 initialText 欄位。

此 API 還使用相同樣式的區塊作為 Facebook SDK 的其他部分。若要顯示原生 iOS 分享對話框,請使用:

// Example content. Replace with content from your app.
FBSDKShareLinkContent *content = [[FBSDKShareLinkContent alloc] init];
content.contentURL = [NSURL URLWithString:@"https://developers.facebook.com"];

FBSDKShareDialog *dialog = [[FBSDKShareDialog alloc] init];
dialog.fromViewController = self;
dialog.content = content;
dialog.mode = FBSDKShareDialogModeShareSheet;
[dialog show];

請注意,必須要有 .fromViewController 才會顯示分享表格。

其他功能

相較於 API,使用 Facebook 分享對話框時,您會擁有更多的選項。

主題標籤

您可以指定單一主題標籤顯示分享相片、連結或影片。主題標籤也會顯示在分享對話框中,用戶也可以選擇在發佈之前將其移除。

以下是新增主題標籤至連結分享的範例。

FBSDKShareLinkContent *content = [[FBSDKShareLinkContent alloc] init];
content.contentURL = [NSURL URLWithString:@"https://developers.facebook.com"];
content.hashtag = [FBSDKHashtag hashtagWithString:@"#MadeWithHackbook"];

金句分享

您可以啟用功能讓用戶標記文字,並以金句連同分享連結一起顯示。或者,您也可以預先定義金句,例如從文章標記一句引文,然後連同分享連結一起顯示。無論是上述哪種情況,金句都會顯示於自己的欄位,並與用戶回應隔開。

FBSDKShareLinkContent *content = [[FBSDKShareLinkContent alloc] init];
content.contentURL = [@"https://developers.facebook.com/products/sharing"];
content.quote = @"Learn quick and simple ways for people to share content from your app or website to Facebook.";

進階主題

您可以藉由應用程式連結從您應用程式發佈的 Facebook 帖子連結回您的應用程式。

當用戶點擊從您的應用程式發佈的 Facebook 帖子時,應用程式會開啟,您甚至可以連結至應用程式內的特定內容。

自訂介面

若要使用您自己的介面來進行分享,您需要:

以下是可將連結張貼至 Facebook 的 Graph API 調用:

[FBSDKShareAPI shareWithContent:content delegate:nil];

分享開放式圖表動態

開放式圖表動態可讓用戶透過開放式圖表動作和物件定義的強型別 API 來分享豐富的結構化內容。

分享的動態會連結回您的應用程式或應用程式的「應用程式商店」網頁。

若要深入瞭解如何新增自訂動態至您的應用程式,請參閱 iOS 中的開放式圖表動態

使用 FBSDKShareOpenGraphContent 模型建立開放式圖表動作的分享內容。如需所有屬性的清單,請參閱 FBSDKShareOpenGraphContent 參考資料

NSDictionary *properties = @{
  @"og:type": @"fitness.course",
  @"og:title": @"Sample Course",
  @"og:description": @"This is a sample course.",
  @"fitness:duration:value": @100,
  @"fitness:duration:units": @"s",
  @"fitness:distance:value": @12,
  @"fitness:distance:units": @"km",
  @"fitness:speed:value": @5,
  @"fitness:speed:units": @"m/s",
};
FBSDKShareOpenGraphObject *object = [FBSDKShareOpenGraphObject objectWithProperties:properties];
FBSDKShareOpenGraphAction *action = [[FBSDKShareOpenGraphAction alloc] init];
action.actionType = @"fitness.runs";
[action setObject:object forKey:@"fitness:course"];
FBSDKShareOpenGraphContent *content = [[FBSDKShareOpenGraphContent alloc] init];
content.action = action;
content.previewPropertyName = @"fitness:course";

iOS 模擬器與測試

如果您在應用程式中使用模擬器測試分享並嘗試分享影片、相片或開放式圖表動作,您將會看到錯誤。這是因為您需要安裝 iOS 專用 Facebook,以便提供「分享」對話框。我們不對模擬器提供與此相關的支援。

對於連結分享的情況,您不需要安裝 iOS 專用 Facebook,因此能夠進行此測試案例。若要測試其他分享案例,請設定已安裝 iOS 專用 Facebook 的實際測試裝置。