動態對話框

您可以在應用程式中加入動態對話框，以便用戶將個別帶有留言的動態發佈至自己的生活時報。

透過動態對話框分享動態時，不需要獲取任何進階權限。

整合

此對話框可以和 Facebook SDK for JavaScript、iOS 和 Android 一同使用，使用方法為執行完整重新導向至某個網址。以下是一些可用來觸發此對話框的程式碼片段範例。

JavaScript

若要觸發動態對話框，您可以呼叫 FB.ui 函數，並於 method 參數中使用 feed 值。

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

請參閱我們的 iOS「分享」對話框指南；此指南亦會講解如何發佈開放式圖表動態。

Android

請參閱有關 Android「分享」對話框的文章；此文章亦會講解如何發佈開放式圖表動態。

網址重新導向

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

注意

如果用戶將「誰可以在你的生活時報發佈帖子？」設定設為「只限本人」，而另一位用戶嘗試使用動態對話框發佈帖子至第一位用戶的生活時報，系統將會顯示「無法發佈帖子」錯誤。

參數

請注意：如果您的應用程式會分享連結至 iTunes、Google Play 商店、Facebook 個人檔案或專頁，則我們不會發佈任何您在分享中使用以下參數所指定的圖像或描述。我們會改為發佈使用 Webcrawler 直接從應用程式商店或 Facebook 專頁抓取的部分應用程式資訊，其中可能不含圖像。若要預覽分享至 iTunes 或 Google Play 的連結，請在分享偵錯工具中輸入您的網址。

參數	描述
`app_id`	您應用程式的唯一識別碼。此為必要項目。
`redirect_uri`	用戶點擊對話框上的按鈕後重新導向至的網址。使用網址重新導向時為必要項目。
`display`	決定對話框的轉譯方式。如果您使用了網址重新導向對話框，則這將會是全螢幕顯示方式，並會在 Facebook.com 中顯示。此顯示類型稱為 `page`。如果您使用 Facebook iOS SDK 或 Facebook Android SDK 來觸發對話框，則系統會自動指定此項目，並為裝置選擇適當的顯示類型。如果您使用 Facebook SDK for JavaScript，此項目將針對登入您應用程式的用戶預設為模組 `iframe` 類型，當用戶在使用 Facebook.com 的遊戲時設為 `async`，其他情況則設為 `popup` 視窗。如有需要，您還可以在使用 Facebook SDK for JavaScript 時強制使用 `popup` 或 `page` 類型。流動版網頁應用程式一律預設為 `touch` 顯示類型。
`from`	發佈訊息的用戶編號。如果未有指定，將預設為目前的用戶。如有指定，則必須是該用戶的編號，或者該用戶所管理的網頁編號。
`to`	此動態發佈位置的個人檔案編號。如果未有指定，將預設為 `from` 值。此編號必須為您的朋友，需要同樣使用您的應用程式。
`link`	附加至此帖子的連結。
`source`	附加至此帖子的媒體檔案（SWF 或 MP3 格式）網址。如果是 SWF 檔案，您還必須指定 `picture` 來提供影片的縮圖。
`ref`	此引數為逗號分隔清單，由最多 5 個不同項目組成，每個項目長度必須為 1 至 15 個字元，並擷取自「0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_」組合。Facebook 洞察報告會使用不同類別，以協助您衡量不同類型帖子的成效

已停用參數

參數	描述
`post_id`	如果用戶選擇發佈內容至他們的生活時報，則此參數會是已發佈動態的編號。
`properties`	此為鍵／值組的 JSON 物件，將顯示在描述下方的串流影片附件中，每個屬性各佔一行。鍵必須是字串，值可以是字串或含有 `text` 和 `href` 鍵的 JSON 物件。
`actions`	此為包含單一物件的 JSON 陣列，這件單一物件會描述將顯示在帖子下方「回應」和「讚好」連結旁的動作連結。包含的物件必須含有 `name` 和 `link` 鍵。
`picture`	附加至此帖子的圖片網址。圖片尺寸必須最少為 200 x 200 像素。如需查看有關尺寸的詳細資訊，請參閱分享最佳操作實例文件。
`name`	連結附件的名稱。
`caption`	連結的說明文字（顯示在連結名稱下方）。如果未有指定，此欄位將會自動填入連結的網址。
`description`	連結的描述（顯示在連結說明文字下方）。如果未有指定，此欄位會自動填入從連結抓取的資料，通常會是網頁的標題。
`thumbnail`	已上載的本機圖像檔案，格式為 `.jpg`、`.jpeg`、`.gif` 或 `.png`。