Facebook Instant Game 捆綁包配置方法

捆綁包配置

小游戲的一些配置可以通過(guò)開(kāi)發(fā)者門(mén)戶(hù)或游戲捆綁包中嵌入的專(zhuān)用 JSON 文件來(lái)實(shí)現(xiàn)。在開(kāi)發(fā)者門(mén)戶(hù)中更新某個(gè)值時(shí)，將全局更改所有游戲版本中的這個(gè)值，而捆綁包配置只會(huì)更改某個(gè)特定捆綁包中的這個(gè)值。后者尤其適用于同時(shí)有兩個(gè)或多個(gè)捆綁包上線的軟發(fā)布階段。

設(shè)置

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

{

  "instant_games": {

    "property_1": "VALUE A",

    "property_2": "VALUE B",

    //...

  }}

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

受支持的配置

平臺(tái)版本

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

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

{

  "instant_games": {

    "platform_version": "RICH_GAMEPLAY",

  }}

自定義更新模板

通過(guò)此配置，您可以為應(yīng)用發(fā)送的每個(gè)自定義更新指定標(biāo)識(shí)符。您可以通過(guò) SDK 4.0 及更高版本發(fā)送包含標(biāo)識(shí)符的自定義更新。這是在  fbapp-config.json  中設(shè)置配置的方法

{

  "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!"

      }

    }

  }}

在配置文件中設(shè)置好這些模板后，可以通過(guò)   template  參數(shù)調(diào)用  FBInstant.updateAsync()  來(lái)參考這些模板，如下面的示例所示：

// game.jsFBInstant.updateAsync({

  action: 'CUSTOM',

  template: 'play_turn',

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

  image: '...',

  data: '...',})

今后，您可以通過(guò)實(shí)施此配置為每個(gè)模板指定帶格式的字符串和本地化內(nèi)容。

玩家統(tǒng)計(jì)數(shù)據(jù)

使用玩家統(tǒng)計(jì)數(shù)據(jù) API 存儲(chǔ)的部分玩家統(tǒng)計(jì)數(shù)據(jù)可在 Facebook 中顯示。這些統(tǒng)計(jì)數(shù)據(jù)可在  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",

        }

      }

    }

  }}

為方便大家群策群力， 我 們 創(chuàng)建了一個(gè) Facebook Instant Game   交流群： 814298516 。 歡迎同 學(xué) 們加入 交流開(kāi)發(fā)和運(yùn)營(yíng)經(jīng)驗(yàn)。