在 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 參考資料

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

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:

  • 影片大小不得超過 50MB。
  • 分享內容的用戶需要安裝 iOS 專用 Facebook 用戶端版本 26.0 或更高版本。

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

 - (void)imagePickerController:(UIImagePickerController *)picker
didFinishPickingMediaWithInfo:(NSDictionary *)info
{
  FBSDKShareVideo *video = [[FBSDKShareVideo alloc] init];
  if (@available(iOS 11, *)) {
    video.videoAsset = [info objectForKey:UIImagePickerControllerPHAsset];
  } else {
    video.videoURL = [info objectForKey:UIImagePickerControllerReferenceURL];
  }
  FBSDKShareVideoContent *content = [[FBSDKShareVideoContent alloc] init];
  content.video = video;
  ...
}

多媒體

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

  • 用戶必須使用 iOS 7.0 以上版本。
  • 分享內容的用戶需要安裝 iOS 專用 Facebook 用戶端版本 52.0 或更高版本。
  • 照片大小必須小於 12MB,影片大小必須小於 50MB。
  • 用戶可分享最多 1 條影片和最多 29 或 30 張相片。

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

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

分享方式

透過建立模型來處理內容後,您可以觸發分享或訊息對話框。

按鈕

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


分享按鈕

有了分享按鈕,您便可以允許用戶將內容分享至自己的 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 4.0 至 4.4 版將切換至原生 iOS 專用 Facebook 應用程式,然後在發佈帖子後將控制權交回至您的應用程式。如果您使用 SDK V4.5+,用戶將會看到 iOS 分享表格;除非分享是一個開放式圖表動態,否則不會將用戶切換至原生 iOS 專用 Facebook 應用程式。

「訊息」對話框

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

[FBSDKMessageDialog showWithContent:content delegate:nil];

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

iOS 整合

iOS 包含原生分享表格,可讓用戶將近況更新、相片、影片和連結發佈至 Facebook,並支援設定帖子的受眾和在帖子中標註地點。您無法使用分享表格分享開放式圖表動態。Facebook SDK 支援使用此原生控制器;從 Facebook SDK 4.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 帖子時,應用程式會開啟,您甚至可以將之連結至應用程式的特定內容。

分享開放式圖表動態

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

分享的動態會連結回您的應用程式或應用程式的 App Store 網頁。

若要深入瞭解如何新增自訂動態至您的應用程式,請參閱 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 的實際測試裝置。