Shield(Facebook Instant 浮层)

FRVR.shield 是一个 Facebook Instant Games 专用层,用来从你的游戏代码里绘制满足 Meta 合规规则的浮层 UI —— 排行榜、对局结束 splash、社交栏等。

自从 Meta 推出 Network‑Enabled Zero‑Permissions Games 后,Shield 也是 Facebook Instant 上唯一能渲染当前玩家显示名和头像的方式。即便原始值对你的 JS 隐藏,Meta 仍会把这些字段提供给 Shield 渲染的 UI。详见 Profile。

启用

FRVR.config.shield = true;   // 或者用 { xmlPath, cssPath } 自行托管
// (在你应用启动里 FRVR.init() 之前设置 —— 此处不需要额外的 init())

创建一个浮层

const overlay = await FRVR.shield.createOverlay(
  'layouts/endscreen.xml',              // Shield XML 布局
  'styles/endscreen.css',               // Shield 样式表
  document.getElementById('game-root'), // 容器元素(可选)
  'width:100%;height:100%;',            // 行内样式(可选)
  { score: 10000, playerName: 'Alex' }, // 绑定到布局里的 payload(可选)
);

if (!overlay) {
  // Shield 不可用(渠道不对、加载失败)。退回到你自己的 UI。
}

浮层创建后会自动显示。如果之后需要销毁或与之通信,记得保存返回的引用。

渲染玩家身份

任何绑定了 {{player.name}} 或 {{player.photo}} 的布局都会拿到 Meta 提供的值,即使在零权限模型下 FRVR.profile.name() / .photo() 都返回 undefined。在 Facebook Instant 上做玩家信息卡、对局结束回顾或社交栏,Shield 就是被设计的路径。

何时使用

在 Facebook Instant 上:任何展示玩家身份(name / photo)、排行榜片段、分享栏、对局结束界面的浮层。这是当前唯一合规暴露 Meta 托管玩家数据的方式。
在其他渠道上:FRVR.shield.createOverlay() 会无错地返回 null。跨渠道的 UI 应该放在你自己的渲染层 —— Shield 专门留给 Facebook Instant。