捆綁包配置
小游戲的一些配置可以通過開發(fā)者門戶或游戲捆綁包中嵌入的專用 JSON 文件來實現(xiàn)。在開發(fā)者門戶中更新某個值時,將全局更改所有游戲版本中的這個值,而捆綁包配置只會更改某個特定捆綁包中的這個值。后者尤其適用于同時有兩個或多個捆綁包上線的軟發(fā)布階段。
本文檔將詳細介紹如何配置特定版本的更改。
設(shè)置
要啟用捆綁包配置,應(yīng)在 zip 文件中添加fbapp-config.json文件。
{?
??? "instant_games": {? ?
?????? "property_1": "VALUE A",? ?
?????? "property_2": "VALUE B",? ? //...?
??? }
}
此文件必須添加到歸檔文件的根目錄中,而非添加到類似于index.html的任何子文件夾。如果此文件在捆綁包內(nèi),則其包含的任何配置值都將覆蓋應(yīng)用面板中全局設(shè)置的值。
受支持的配置
平臺版本
可通過platform_version屬性設(shè)置特定的捆綁包并使用我們的“經(jīng)典”版平臺(適用于 SDK 2.1 和更低版本)或豐富游戲功能(適用于 SDK 3.0 及更高版本)此屬性接受字串值'RICH_GAMEPLAY'或'CLASSIC'
下面是設(shè)置此值的fbapp-config.json文件的示例。
{?
??? "instant_games": {? ?
?????? "platform_version": "RICH_GAMEPLAY",?
???? }
}
自定義更新模板
通過此配置,您可以為應(yīng)用發(fā)送的每個自定義更新指定標識符。您可以通過 SDK 4.0 及更高版本發(fā)送包含標識符的自定義更新。這是在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è)置好這些模板后,可以通過template參數(shù)調(diào)用FBInstant.updateAsync()來參考這些模板,如下面的示例所示:
// game.js
FBInstant.updateAsync({?
??? action: 'CUSTOM',?
??? template: 'play_turn',?
??? text: 'Kun just played HELLO. Now it\'s Alissa\'s turn!',?
??? image: '...',?
??? data: '...',
})
今后,您可以通過實施此配置為每個模板指定帶格式的字符串和本地化內(nèi)容。
玩家統(tǒng)計數(shù)據(jù)
使用玩家統(tǒng)計數(shù)據(jù) API 存儲的部分玩家統(tǒng)計數(shù)據(jù)可在 Facebook 中顯示。這些統(tǒng)計數(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)建了一個 Facebook Instant Game?? 交流QQ群:814298516
