Skip to content

基础信息

属性

name

玩家的昵称。

点击查看示例代码
javascript
// 在所有玩家中,通过玩家名称筛选出某一位玩家
const myPlayer = world
  .querySelectorAll("player")
  .filter((e) => e.player.name === "吉吉喵")[0];

javascript
// 如果'吉吉喵'和'魔术喵'加入游戏,会被缩小到0.25倍。其他玩家不受影响
const TEST_PLAYER = ["吉吉喵", "魔术喵"];

world.onPlayerJoin(({ entity }) => {
  if (!TEST_PLAYER.includes(entity.player.name)) return;
  entity.player.scale = 0.25;
});

:::

userId

玩家的用户 ID,个人中心昵称下方可见。

## boxId

玩家的 Box ID(3-15 字符)。

信息

该属性已不推荐使用,建议使用 entity.player.userId 获取玩家 ID。


userKey

玩家的唯一识别码(16 字符),可以用于存储玩家信息到数据库,无法控制更改。

信息

该属性已不推荐使用,建议使用 entity.player.userId 获取玩家 ID。


avatar

玩家的头像 url 直链。


movementBounds

默认值:new GameBounds3(new GameVector3(-50, -50, -50), new GameVector3(178, 178, 178))

玩家的活动范围限制,如超出此范围,则传回出生点


url

获取该玩家进入地图时所用的 URL 链接地址, 主要用于获取 URL 参数, 以便区别对待进来的玩家

方法

querySocial()

查询当前玩家的社交关系,并返回具体的玩家 ID 列表

  • 关注 ID 列表
  • 粉丝 ID 列表
  • 好友 ID 列表

输入参数

参数必填默认值类型说明
socialTypeSocialType查询的方式

返回值

类型说明
Promise‹number[]›异步返回玩家 ID 列表

## querySocialStatistic()

查询当前玩家的社交统计信息,并返回具体的统计数

  • 关注人数
  • 粉丝人数
  • 好友人数

返回值

类型说明
Promise‹SocialStatisticType›异步返回数据统计信息

## openUserProfileDialog()

对当前玩家,调起指定 ID 玩家的个人主页。

输入参数

参数必填默认值类型说明
userIdnumber玩家的用户 ID

接口

SocialStatisticType

社交统计信息的类型

参数类型说明
followingNumnumber关注人数
followerNumnumber粉丝人数
friendsNumnumber好友人数

枚举

SocialType

玩家的社交关系类型

属性说明
FOLLOWING关注
FOLLOWERS粉丝
FRIENDS好友