在 Android 分享

本指南詳細說明如何從您的 Android 應用程式分享至 Facebook。當用戶從您的應用程式進行分享時,其內容可能顯示在用戶的「動態時報」上,也可能顯示在用戶朋友的「動態消息」上。

用戶也可以從您的應用程式將內容分享至 Facebook Messenger。

必要條件

您必須先連結或下載 Android 專用 Facebook 分享 SDK,才能從應用程式分享至 Facebook。

Android 專用分享 SDK 是 Facebook Android SDK 的元件。若要在專案中使用 Facebook 分享 SDK,請以 Maven 相依性的方式加入,或下載該 SDK。請點擊以下按鈕選擇您偏好的方式。

使用 Maven 連結 SDK

  1. 在專案中開啟 your_app | Gradle Scripts | build.gradle(專案),然後將下列存放庫新增至 buildscript { repositories {}} 區塊,以便從 Maven Central 存放庫下載 SDK:
    mavenCentral() 
  2. 在專案中開啟 your_app | Gradle Scripts(Gradle 指令碼)| build.gradle(模組:應用程式),然後將下列編譯陳述式新增至 dependencies{} 區塊以編譯最新版的 SDK:
    compile 'com.facebook.android:facebook-share:[4,5)'
  3. 建立您的專案。

下載 SDK

若要下載 SDK,請點擊以下按鈕。

下載 SDK

使用 Facebook 分享 SDK 時,除非您停用自動事件記錄功能,否則應用程式會自動記錄發生的事件,並收集資料以供 Facebook 分析工具使用。如需深入瞭解會收集哪些資料,以及如何停用自動事件記錄,請參閱自動記錄應用程式事件

額外必要條件

此外,您還需要執行以下操作:

如需這些必備要求的詳細資訊,請參閱 Android - 新手指南

您還需要在 ContentProvider 中設定 AndroidManifest.xml,其中 {APP_ID} 是您的應用程式編號:

<provider android:authorities="com.facebook.app.FacebookContentProvider{APP_ID}"
          android:name="com.facebook.FacebookContentProvider"
          android:exported="true"/>

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

建立內容模型

Facebook SDK 4.0+ 版包含用於分享內容的新模型。用戶要分享的每一種內容類型都有一個供您用來代表該內容的類別。建立內容的模型之後,請在您的應用程式新增分享介面。

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

自 2017 年 4 月 18 日起,圖形 API 2.9 版及更新版本已不再支援下列參數。而針對 2.8 版及更舊版本,參數仍可使用至 2017 年 7 月 17 日為止。

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

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

ShareLinkContent content = new ShareLinkContent.Builder()
        .setContentUrl(Uri.parse("https://developers.facebook.com"))
        .build();

若要預覽 Google Play 或 App Store 的連結分享,請在分享偵錯工具中輸入您的網址。

如果應用程式分享內容中,含有前往任何應用程式的 Google Play 或 App Store 連結,則系統會忽略分享時包含的說明和圖像,改為直接從商店抓取應用程式的名稱和圖像(如果商店中沒有圖像,則分享時便不會附圖)。

相片

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

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

請將相片的分享內容建立到 SharePhotoContent 模型中。如需所有屬性的清單,請參閱 SharePhotoContent 參考資料

Bitmap image = ...
SharePhoto photo = new SharePhoto.Builder()
        .setBitmap(image)
        .build();
SharePhotoContent content = new SharePhotoContent.Builder()
        .addPhoto(photo)
        .build();

影片

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

影片大小不得超過 12MB。

請將影片的分享內容建立到 ShareVideoContent 模型中。如需所有屬性的清單,請參閱 ShareVideoContent 參考資料

Uri videoFileUri = ...
ShareVideo = new ShareVideo.Builder()
        .setLocalUrl(videoUrl)
        .build();
ShareVideoContent content = new ShareVideoContent.Builder()
        .setVideo(video)
        .build();

多媒體

用戶可以使用「分享」對話方塊,將您應用程式中的相片和影片組合分享到 Facebook。注意事項:

  • 用戶必須安裝原生 Android 版 Facebook 應用程式 71 版或更新版本。
  • 相片大小不得超過 12MB。
  • 影片大小不得超過 12MB。
  • 每次最多可分享 6 張(段)相片和影片。

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

SharePhoto sharePhoto1 = new SharePhoto.Builder()
    .setBitmap(...)
    .build();
SharePhoto sharePhoto2 = new SharePhoto.Builder()
    .setBitmap(...)
    .build();
ShareVideo shareVideo1 = new ShareVideo.Builder()
    .setLocalUrl(...)
    .build();
ShareVideo shareVideo2 = new ShareVideo.Builder()
    .setLocalUrl(...)
    .build();

ShareContent shareContent = new ShareMediaContent.Builder()
    .addMedium(sharePhoto1)
    .addMedium(sharePhoto2)
    .addMedium(shareVideo1)
    .addMedium(shareVideo2)
    .build();

ShareDialog shareDialog = new ShareDialog(...);
shareDialog.show(shareContent, Mode.AUTOMATIC);

新增分享介面

透過建立模型處理好內容之後,您可以觸發 Facebook 分享介面或者自行建立呼叫圖形 API 的 Facebook 分享介面。

按鈕

Facebook 在 Android 提供可觸發分享的原生按鈕。


4.28.0 版 Facebook Android SDK 已停用 Android 專用的「讚」按鈕。本功能僅支援至 2018 年 2 月 5 日。

「讚」按鈕

使用「讚」按鈕是用戶和朋友分享內容的快速方法。點按「讚」按鈕即會從您的應用程式對某些內容片段「按讚」,並將內容分享至 Facebook。「讚」按鈕的用法和 Facebook 粉絲專頁或任何開放社交關係圖物件類似,也可以由網址或編號參照。若要新增「讚」按鈕,請在您的檢視中加入下列程式碼片段:

LikeView likeView = (LikeView) findViewById(R.id.like_view);
likeView.setObjectIdAndType(
    "https://www.facebook.com/FacebookDevelopers",
    LikeView.ObjectType.PAGE);

分享按鈕

「分享」按鈕將會呼叫「分享」對話方塊。若要新增「分享」按鈕,請在您的檢視中新增下列程式碼片段:

ShareButton shareButton = (ShareButton)findViewById(R.id.fb_share_button);
shareButton.setShareContent(content);

4.28.0 版 Facebook SDK 已停用「發送」按鈕。本功能僅支援至 2018 年 2 月 5 日。

「發送」按鈕

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

SendButton sendButton = (SendButton)findViewById(R.id.fb_send_button);
sendButton.setShareContent(shareContent);
sendButton.registerCallback(callbackManager, new FacebookCallback<Sharer.Result>() { ... });

「分享」對話方塊

「分享」對話方塊會切換至原生 Android 版 Facebook 應用程式,然後在發佈貼文之後將控制權返回至您的應用程式。視您使用的 SDK 而定,用戶可能需要點按返回箭頭圖示才能返回您的應用程式。如果未安裝 Facebook 應用程式,「分享」對話方塊將會自動切換回網頁型對話方塊。

ShareDialog.show(activityOrFragment, content);

例如,若要對活動中的連結顯示 ShareDialog,請在 onCreate 方法中建立 ShareDialog 執行個體:

public class MainActivity extends FragmentActivity {
    CallbackManager callbackManager;
    ShareDialog shareDialog;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        callbackManager = CallbackManager.Factory.create();
        shareDialog = new ShareDialog(this);
        // this part is optional
        shareDialog.registerCallback(callbackManager, new FacebookCallback<Sharer.Result>() { ... });
    }

然後顯示 ShareDialog:

if (ShareDialog.canShow(ShareLinkContent.class)) {
    ShareLinkContent linkContent = new ShareLinkContent.Builder()
            .setContentUrl(Uri.parse("http://developers.facebook.com/android"))
            .build();
    shareDialog.show(linkContent);
}

最後在 callbackManager 中呼叫 SDK 的 onActivityResult 以處理回應:

@Override
protected void onActivityResult(final int requestCode, final int resultCode, final Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    callbackManager.onActivityResult(requestCode, resultCode, data);
}

「訊息」對話方塊

「訊息」對話方塊會切換至原生 Android 版 Messenger 應用程式,然後在發佈貼文之後將控制權返回至您的應用程式。視您使用的 SDK 而定,用戶可能需要點按返回箭頭圖示才能返回您的應用程式。

MessageDialog.show(activityOrFragment, content);

其他功能

相較於使用 API 分享,使用 Facebook 分享對話方塊讓您有更多選項。

主題標籤

您可以指定單一主題標籤與分享的相片、連結或影片一同顯示。此主題標籤也會顯示在「分享」對話方塊中,且用戶可以在發佈前將其移除。

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

ShareLinkContent content = new ShareLinkContent.Builder()
        .setContentUrl(Uri.parse("https://developers.facebook.com"))
        .setShareHashtag(new ShareHashtag.Builder()
                .setHashtag("#ConnectTheWorld")
                .build());
        .build();

分享引文

用戶可以強調內文,將內文以引文方式呈現並附上分享連結;或者,您可以預先定義引文(例如文章的摘要式引文)與分享連結一同顯示。不管您使用何種方式,此引文都會顯示在不同於用戶留言的獨立欄位中。

ShareLinkContent content = new ShareLinkContent.Builder()
        .setContentUrl(Uri.parse("https://developers.facebook.com"))
        .setQuote("Connect on a global scale.")
        .build();

進階主題

內建分享後援

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

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

您可以藉由應用程式連結從您應用程式發佈的 Facebook 貼文連結回您的應用程式。當用戶點擊從您應用程式發佈的 Facebook 貼文,應用程式就會開啟,您甚至可以連結至應用程式內的特定內容。

自訂介面

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

以下是從您自己的介面張貼連結至 Facebook 的程式碼:

ShareApi.share(content, null);

分享開放社交關係圖動態

開放社交關係圖動態可讓用戶透過開放社交關係圖動作和物件定義的強型別 API ,分享豐富的結構化內容。這些貼文可連結回您的應用程式或應用程式的「應用程式商店」網頁。

若要深入瞭解如何設定「開放社交關係圖」動態,請參閱 Android 中的開放社交關係圖動態

請將開放社交關係圖動作的分享內容建立到 ShareOpenGraphContent 模型中。如需所有屬性的清單,請參閱 ShareOpenGraphContent 參考資料

ShareOpenGraphObject object = new ShareOpenGraphObject.Builder()
        .putString("og:type", "fitness.course")
        .putString("og:title", "Sample Course")
        .putString("og:description", "This is a sample course.")
        .putInt("fitness:duration:value", 100)
        .putString("fitness:duration:units", "s")
        .putInt("fitness:distance:value", 12)
        .putString("fitness:distance:units", "km")
        .putInt("fitness:speed:value", 5)
        .putString("fitness:speed:units", "m/s")
        .build();
ShareOpenGraphAction action = new ShareOpenGraphAction.Builder()
        .setActionType("fitness.runs")
        .putObject("fitness:course", object)
        .build();
ShareOpenGraphContent content = new ShareOpenGraphContent.Builder()
        .setPreviewPropertyName("fitness:course")
        .setAction(action)
        .build();