账户头像是玩家的 iDos Games 角色:所有应用共用一个形象,在 idosgames.com 编辑。 你的应用决定是否使用它以及显示哪些内容;不使用时,应用绘制自己的角色。
玩家看到什么
- 自己的头像:在个人资料中,以及在使用它的应用中。
- 其他玩家的头像:在房间、聊天和排行榜中,以同样方式绘制。
- 个人资料中的 修改形象 会打开 idosgames.com 上的编辑器。
工作原理
- 形象保存在玩家账户上,而不是你的应用里:一次修改立刻到达所有应用。
- 服务器发送的形象已按你的规则处理:隐藏的部位已移除,身高已调整到你的范围内。
- 形象按修订号读取:未改变的形象不带数据返回。
步骤 01添加到项目
无需安装:每个新项目的个人资料在开启后都会显示头像。游戏自己的角色请使用下面的 SDK。
步骤 02在控制台中设置
打开控制台,选择项目并进入 Live Operations → v2 → Avatar。
- 使用账户头像:默认关闭。
- 应用显示的内容:取消勾选的部位会从本应用的所有玩家身上移除。
- 身高:按标准刻度 0.9 到 1.1 的范围。
页面上的 AI 按钮会打开助手:描述你的需求,它会提出修改,你检查后点击 保存。
步骤 03测试并发布
在应用的测试版本中检查头像。设置会通过单独的操作进入正式应用:参见发布与链接。
在模板中
- 游戏构建器:在 3D 类型中,玩家的英雄以其头像形象出现,奔跑、跳跃、攻击和胜利舞蹈都会动起来。2D 类型保留自己的角色。
- 棋盘游戏:玩家的棋子变成其头像形象。在“和好友一起”模式中,好友们在同一个棋盘上看到彼此的头像形象。
- 访客和没有形象的玩家会看到游戏自己的英雄或棋子。
头像商店
- 初始物品对所有人免费;新物品需要付费,由平台以 Aspis 出售。
- 买下的物品永久归玩家所有,在所有应用中可用。玩家在 idosgames.com 的编辑器里穿戴它。
- 个人资料在头像下方显示商店。玩家在你的应用内购买物品时,你会获得价格的一部分;你隐藏的槽位的物品不会在你的应用中出售。
- 个人资料中显示最新物品,“全部物品”打开整个商店:按名称搜索、“我的”、卖家和排序(最新、热门、按价格)。向下滚动会加载更多物品。
- 每次购买都需要玩家在 idosgames.com 上确认。在应用的测试版本中不会扣费,也不会发放物品。
创作者物品
- 平台开放创作者物品后,任何有账号的人都可以在 idosgames.com 制作物品(头像,然后“创建自己的物品”):选择穿戴位置,从一个形状开始,修改名称、颜色和图片,再用 Aspis 定价。
- 在编辑器中,创作者的物品和官方物品放在同样的分区里:按名称搜索、“我的”、来源和排序(最新、热门、按价格)。向下滚动会加载更多物品。
- 物品按与官方物品相同的规则检查,与现有物品完全相同的副本会被拒绝。发布后无法修改物品外观。
- 物品立即归创作者所有,每次售出创作者都能获得分成。玩家可以举报不良物品:未处理投诉多的物品会自动隐藏,直到管理员作出决定。
- 创作者物品会自动出现在你应用的头像商店中,与平台物品并列。被隐藏的物品会从所有玩家身上取下。
开发者
// The player's own look (null: the app does not use the account avatar)
const mine = await client.avatar.getMine()
// Looks of other players of this app: a room, a leaderboard page
const res = await client.avatar.get(userIDs)
// Draw it with @idosgames/characters
import { AvatarActor, avatarFromServer, DEFAULT_AVATAR, renderAvatarCanvas } from '@idosgames/characters/voxel'
const look = avatarFromServer(mine.ok ? mine.data : null)
const actor = new AvatarActor(look?.spec ?? DEFAULT_AVATAR, look?.items ?? {})
const sprite = look && renderAvatarCanvas(look.spec, look.items, { frame: 'full', size: 128 })
// 用 Aspis 购买物品(玩家在 idosgames.com 上确认)
const shop = await client.avatar.getShop()
const page = await client.avatar.browseShop({ slot: 'hat', query: 'crown', sort: 'price_asc' })
const r = await client.credits.pay((id) => client.avatar.buyItem('hat.crown', 250, id))- 访客和没有形象的玩家返回
hasAvatar: false:为他们绘制DEFAULT_AVATAR或randomAvatar。 - 在
avatar:changed事件时重绘;用client.avatar.peek(userID)读取已获取的形象。 getShop()返回在售物品、玩家已有的物品和物品配方;请始终传入玩家看到的价格:如果价格已变,不会扣费。browseShop()按页读取商店,适用于成千上万的物品:槽位、搜索、ownedOnly、卖家和排序;下一页请把响应中的next作为cursor传入。
所有字段都在 SDK 中有说明,由 SDK MCP 服务器提供。
常见问题
玩家能在我的应用里修改头像吗?
不能:玩家在 idosgames.com 编辑,所有使用它的应用都会得到新形象。
访客会得到什么?
没有头像:请为访客和没有形象的玩家绘制默认形象。