遊戲專用 Facebook 登入使用案例

本文件說明如何使用應用程式主控板上的「遊戲專用 Facebook 登入」使用案例建立和自訂應用程式。

開始之前

您需要下列項目：

步驟 1：開始應用程式建立程序

有許多方法可以建立應用程式。

如果您剛完成註冊流程，請點擊「建立第一個應用程式」按鈕
如果您在應用程式主控板中，請點擊右上角的「建立應用程式」
如果您在現有應用程式的主控板中，且想要建立新的應用程式，請選擇左上角的下拉式功能表，然後點擊「新建應用程式」按鈕

步驟 2：選擇使用案例

選擇「使用 Facebook 登入驗證和要求用戶資料」使用案例。

您可以點擊說明右側的 V 形箭號，查看此使用案例的其他使用方式及其必備條件。

點擊「繼續」按鈕。

稍後您將能夠在應用程式的主控板中自訂使用案例。

步驟 3：登入類型

系統將詢問您是否正在建置遊戲，請選擇「是」，然後點擊「繼續」。

步驟 4：應用程式詳細資料

您將在此步驟中新增以下內容：

應用程式的應用程式名稱
此應用程式專用的聯絡電子郵件地圵

您也可以使用下拉式功能表將此應用程式連結至現有的商業帳號，或是稍後再新增此應用程式。

點擊「建立應用程式」儲存應用程式的詳細資料。

步驟 5：自訂應用程式

在取得遊戲登入並要求用戶資料區塊中，您將看到系統已自動將「遊戲專用 Facebook 登入」、gaming_profile 和 gaming_user_picture 權限新增至應用程式。這可讓應用程式使用「Facebook 登入」，並向應用程式用戶要求存取玩家檔案資訊和大頭貼照的權限。

點擊「自訂」按鈕。

自訂「Facebook 登入」和要求用戶資料

設定

「遊戲專用 Facebook 登入」可讓您控制 oAuth 設定，並新增取消授權回呼網址和重新導向 URI 驗證程式。

快速入門

「遊戲專用 Facebook 登入」快速入門可讓您快速取得代碼以在您的應用程式中實作「遊戲專用 Facebook 登入」。

權限

您將看到「遊戲專用 Facebook 登入」使用案例中可用的權限清單，以及每個權限的完整說明和必備條件。

gaming_profile – 自動新增且無法移除
gaming_user_picture – 自動新增且無法移除

當您向應用程式新增權限後，即可看到該權限的狀態：

準備好上線模式 – 此權限已在應用程式審查中獲得批准，並準備好發佈並完成應用程式審查權限測試要求
準備好測試 – 您可以針對需要此權限的端點進行 API 呼叫測試
需要驗證 – 此權限需要新增至應用程式的已驗證 Meta 商業帳號

您也可以查看針對需要每個權限的端點所成功發出的 API 呼叫次數。

步驟 6：新增更多使用案例

點擊右上角的「返回」按鈕或左側功能表中的使用案例，為應用程式新增更多使用案例。

當您建立此應用程式時，這些是您選擇最常搭配使用案例使用的使用案例。您將自訂應用程式主控板中所列的大多數使用案例，然後按照開發人員文件中的下列指示實作程式碼來使用這些產品。

建議您先完成每個使用案例，然後再新增另一個使用案例。這可讓您查看每個使用案例提供的功能，如此就不會新增應用程式不需要的使用案例。

使用案例	要新增的權限和要實作的產品
協助玩家找到朋友一起玩遊戲 – 透過協助現有玩家找到朋友一起玩遊戲，為您的遊戲吸引更多玩家。	`user_friends`
在 Facebook 和 Instagram 分享您的遊戲體驗 – 玩家可以將遊戲體驗的螢幕截圖和影片片段分享至 Instagram 和 Facebook，包括限時動態和 Facebook 社團	遊戲分享功能
使用應用程式事件追蹤互動 – Meta 應用程式事件可讓您的應用程式瞭解用戶如何在各個應用程式、裝置、平台和網站之間與您的商家互動。	Meta 應用程式事件
使用 Webhooks 取得即時通知 – 在應用程式用戶對新增至應用程式的權限進行相關變更時，取得自動 HTML 通知。	Meta Webhooks

後續步驟

您現在已經成功自訂其他使用案例，可以開始測試您的實作以及新增測試應用程式、粉絲專頁和用戶等。