facebook instant game 发布指南-丰富游戏功能

社交功能

借助小游戏,您可通过多种方式促进玩家之间的社交互动。下面是有关这些功能的详细信息。

1.自定义更新

2.自定义分享

3.关联的玩家

4.更改游戏环境

5.游戏智能助手

自定义更新

借助小游戏,您可以在玩游戏的 Messenger 对话中发送自定义消息。可使用图片、说明,甚至包含自定义文本的“行动号召”按钮对此消息进行全面自定义。

默认情况下,仅最后一条特定游戏的更新消息会在对话中展开。但之前的消息可由对话中的任何用户展开。

更新消息还可以传递最多 1kb 的自定义数据块。通过FBInstant.getEntryPointData()从该消息打开游戏的任何玩家都可以获得此数据。

每个环境每个会话只能发送一条消息,所以应包含对应游戏会话中最重要的信息。例如,在回合制游戏中,应说明一方已完成操作,现在该下一个玩家了。但这种使用情况不限于回合制游戏,因为消息是可全面自定义的,可灵活地说明关于任何游戏内操作的有意义的更新。

// This will post a custom update. If the game is played in a messenger

// chat thread, this will post a message into the thread with the specified

// image and text message. And when people launch the game from this

// message, those game sessions will be able to access the specified blob

// of data through FBInstant.getEntryPointData().

FBInstant.updateAsync({ 

     action: 'CUSTOM', 

     cta: 'Play', 

     image: base64Picture, 

     text: {   

        default: 'Edgar just played BASH for 9 points!',   

        localizations: {     

           en_US: 'Edgar just played BASH for 9 points!',     

           pt_BR: 'Edgar jogou BASH por 9 pontos!',   

         } 

       } 

       template: 'WORD_PLAYED', 

      data: { myReplayData: '...' }, 

      strategy: 'IMMEDIATE', 

      notification: 'NO_PUSH',

  }).then(function() { 

     console.log('Message was sent successfully');

  });

自定义分享

您可以让玩家分享关于游戏的有意义时刻。SDK 调用的运作方式与上述自定义更新调用相似,但不是更新当前对话中的内容,而是通过FBInstant.shareAsync()方法提示玩家在其他地方分享精彩时刻。

玩家可以在动态消息或 Messenger 对话中分享。如果他们在动态消息中分享,则可以在分享中添加自定义消息。

动态消息中的动态和 Messenger 消息都会包含图片、文本和按钮,这些都会在调用 API 时设置。使用按钮启动游戏。通过该接入点,开发者可以访问FBInstant.getEntrypointData(),此函数会返回通过FBInstant.shareAsync()中的data:参数传递的数据对象。

FBInstant.shareAsync({ 

     intent: 'REQUEST', 

     image: myBase64Picture, 

     text: 'Hey I\'m stuck on this puzzle! Can you help me?', 

     data: { myReplayData: '...' },

关联的玩家

FBInstant.player.getConnectedPlayersAsync()方法会检索在 Messenger 与当前玩家建立联系以及向游戏授予权限的用户列表。

请注意,此方法不会提供在相同环境和未在相同环境中玩游戏的玩家之间的区别。您可以从FBInstant.context.getPlayersAsync()获取特定于该环境的信息。

获取玩家的好友

FBInstant.player.getConnectedPlayersAsync() 

    .then(function(players) {   

      _leaderboard.render(players); 

    });

获取相同环境玩家

FBInstant.context.getPlayersAsync() 

    .then(function(players) {   

      _leaderboard.render(players); 

     });

更改游戏环境

用户可以在许多不同的环境中玩小游戏,例如 Messenger 对话或动态消息中的动态。借助以下 SDK 调用,您可以通过任何会话切换环境,无论用户从哪里进入游戏。这意味着,您可以允许玩家切换至其他对话,而无需退出并重新打开游戏。

为方便更改为新的游戏环境,我们提供三种不同的方法:

通过FBInstant.context.chooseAsync()打开一个原生对话框,允许玩家选择想要更改为哪一种对话。

例如,开发者可使用FBInstant.context.switchAsync(contextId)将玩家发送到预定义的游戏环境,以便继续之前在其他对话中开始的游戏竞赛。

FBInstant.context.createAsync(playerId)会尝试为指定的玩家创建游戏环境。例如,您可以利用此方法在玩家与推荐好友之间开始一场比赛。

游戏智能助手

游戏智能助手可帮助您打造再次吸引玩家的体验。游戏智能助手使用Messenger 平台构建,是可与玩家互动,并利用有意义的时刻邀请玩家重回游戏的对话型智能助手。您可以使用游戏智能助手提供支线任务、故事模式、玩家进度更新、激励规则等。

当玩家关闭游戏时,游戏智能助手的服务器会收到 Webhook 通知,之后便可直接向玩家发送消息。智能助手还可以提供“玩游戏”按钮,此按钮可以根据环境选择进行自定义。

注意:我们提供多个可供加入和退出智能助手对话的接入点,因此您不必假设所有玩家均已连接至您的智能助手,也无需完全依赖智能助手消息来提供游戏体验。智能助手消息可作为游戏体验的有益补充,但并非必要条件。

其他信息

1.小游戏快速入门

2.设置游戏智能助手

3.关于 Messenger 平台中“玩游戏”按钮的文档

4.关于 Messenger 平台中“玩游戏”Webhook 的文档

另外我创建了一个 Facebook Instant Game   交流QQ群:814298516

欢迎同行们加入讨论技术
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,133评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,682评论 3 390
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,784评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,508评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,603评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,607评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,604评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,359评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,805评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,121评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,280评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,959评论 5 339
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,588评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,206评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,442评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,193评论 2 367
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,144评论 2 352

推荐阅读更多精彩内容

  • FBInstant 小游戏 SDK 的顶级命名空间。 player 包含与当前玩家相关的功能和属性。 getID(...
    寻乐人阅读 3,460评论 0 0
  • there are five squirrels in the playground, who are not a...
    津城燕窝Donna阅读 234评论 0 0
  • “夫道者,上知天文,下知地理,中知人事,可以长久。”——《素问》 “天有其时,地有其财,人有其治。”——荀子 中国...
    白立平阅读 490评论 4 6
  • 春溪路的街角坐着一个傻子 每天的正午会趴在地上痛哭 下午三点钟的太阳习惯性的磨亮这个肮脏的城市 留下傻子一个人睡在...
    软骨_阅读 150评论 0 0
  • 子夏问曰:“‘巧笑倩兮,美目盼兮,素以为绚兮’。(1)何谓也?”子曰:“绘事后素(2)。”曰:“礼后乎?”子曰:“...
    名言名语March阅读 534评论 0 1