个人资料(Cocos)

FRVRSDK.instance 暴露当前玩家由渠道分配的身份 —— 一个稳定的 id,以及(在渠道仍提供时)显示昵称和头像。

读取字段

const id    = await FRVRSDK.instance.getPlayerId();
const name  = await FRVRSDK.instance.getPlayerName();
const photo = await FRVRSDK.instance.getPlayerImage();

都是异步的。id 几乎总是可用。name 和 photo 不保证一定有 —— 见下文。

把头像加载为 base64

便于在 UI 里渲染,且不用处理 CORS:

if (photo) {
  const dataUrl = await FRVRSDK.instance.loadPlayerImage(photo);
  // dataUrl 形如 "data:image/…;base64,…" —— 通过 Image 元素喂给 SpriteFrame 等
}

Facebook Instant:昵称与头像不再可用

警告

在 Meta 的 Network-Enabled Zero-Permissions Games 模式下,Facebook Instant 不再向游戏返回显示昵称或头像。

getPlayerName() 与 getPlayerImage() 在该渠道上会解析为 undefined / null。要在那里渲染玩家身份,请走 Shield 覆盖层 路径(从 Cocos 也适用 —— 你的构建在 Facebook 上会经过支持 Shield 的 WebView 封装)。

防御式渲染

const name   = await FRVRSDK.instance.getPlayerName();
const photo  = await FRVRSDK.instance.getPlayerImage();

this.nameLabel.string = name ?? 'Player';
if (photo) loadAvatar(photo);
else       useDefaultAvatar();

玩家 id 的稳定性

getPlayerId() 返回一个由渠道分配的稳定 id。用来给不需要跨设备同步的逐玩家数据做 key(本地存储 key、分析的用户属性等)。需要跨设备身份时,请使用云存储层附带的 FRVR id。