遊戲專用 Facebook 登入使用案例

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

開始之前

您需要下列項目：

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

建立應用程式的方法有很多種。

如果您剛剛完成註冊流程，請點擊建立第一款應用程式按鈕
如果您身處應用程式管理中心，請點擊右上角的建立應用程式
如果您身處現有應用程式的管理中心，而且想建立新的應用程式，請選擇左上角的下拉式選單，然後點擊建立新的應用程式按鈕

第 2 步：選擇使用案例

選擇透過 Facebook 登入驗證並要求取得用戶資料作為使用案例。

您可以點擊說明右側的雙箭咀，以查看此使用案例的其他用途及要求。

點擊下一步按鈕。

您可稍後在應用程式的管理中心自訂使用案例。

步驟 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

後續步驟

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