Facebook Instant Game 捆綁包配置方法

捆綁包配置

小游戲的一些配置可以通過開發者門戶或游戲捆綁包中嵌入的專用 JSON 文件來實現。在開發者門戶中更新某個值時，將全局更改所有游戲版本中的這個值，而捆綁包配置只會更改某個特定捆綁包中的這個值。后者尤其適用于同時有兩個或多個捆綁包上線的軟發布階段。

設置

要啟用捆綁包配置，應在 zip 文件中添加   fbapp-config.json  文件。

{

  "instant_games": {

    "property_1": "VALUE A",

    "property_2": "VALUE B",

    //...

  }}

此文件必須添加到歸檔文件的根目錄中，而非添加到類似于   index.html  的任何子文件夾。如果此文件在捆綁包內，則其包含的任何配置值都將覆蓋應用面板中全局設置的值。

受支持的配置

平臺版本

可通過   platform_version  屬性設置特定的捆綁包并使用我們的“經典”版平臺（適用于 SDK 2.1 和更低版本）或豐富游戲功能（適用于 SDK 3.0 及更高版本）此屬性接受字串值  'RICH_GAMEPLAY'  或  'CLASSIC'

下面是設置此值的   fbapp-config.json  文件的示例。

{

  "instant_games": {

    "platform_version": "RICH_GAMEPLAY",

  }}

自定義更新模板

通過此配置，您可以為應用發送的每個自定義更新指定標識符。您可以通過 SDK 4.0 及更高版本發送包含標識符的自定義更新。這是在  fbapp-config.json  中設置配置的方法

{

  "instant_games": {

    "custom_update_templates": {

      "pass_score": {

        "example": "Kun just scored 100 and passed Alissa's highscore!"

      },

      "play_turn": {

        "example": "Kun just played HELLO. Now it's Alissa's turn!"

      }

    }

  }}

在配置文件中設置好這些模板后，可以通過   template  參數調用  FBInstant.updateAsync()  來參考這些模板，如下面的示例所示：

// game.jsFBInstant.updateAsync({

  action: 'CUSTOM',

  template: 'play_turn',

  text: 'Kun just played HELLO. Now it\'s Alissa\'s turn!',

  image: '...',

  data: '...',})

今后，您可以通過實施此配置為每個模板指定帶格式的字符串和本地化內容。

玩家統計數據

使用玩家統計數據 API 存儲的部分玩家統計數據可在 Facebook 中顯示。這些統計數據可在  fbapp-config.json  中配置，如下所示：

{

  "instant_games": {

    "surfaceable_stats": {

      "rank": {

        "priority": 1,

        "order": 1,

        "label": {

          "localizations": {

            "en_US": "Rank",

            "th_TH": "\u{0E22}\u{0E28}",

          },

          "fallback": "Rank"

        },

        "values": {

          "0": "Unranked",

          "1": "Bronze",

          "2": "Silver",

          "3": "Gold",

        }

      }

    }

  }}

為方便大家群策群力， 我 們 創建了一個 Facebook Instant Game   交流群： 814298516 。 歡迎同 學 們加入 交流開發和運營經驗。