用途:把任意文件(图片、音频、3D 模型)上传为 Remix 平台托管的游戏素材,返回固定 URL 供游戏 HTML 引用。
前提条件:Remix 平台上已存在一个游戏(需要 gameId);已设置 REMIX_API_KEY 环境变量。
使用方式:先确认已有 gameId,避免重复创建游戏。可依次使用任务上下文或先前结果中的 gameId,否则读取最近的 .remix-cli.json,旧项目可能仍使用 .remix-mcp.json,只要其中包含 gameId 就复用。仅当以上来源都没有时,才按上传游戏流程新建游戏。
上传素材:以 multipart 表单发送文件,接口为 POST https://api.remix.gg/v1/games/{gameId}/assets,请求头含 Authorization: Bearer $REMIX_API_KEY 与 Content-Type: multipart/form-data。表单字段 file(必填,二进制文件)和 assetName(可选,显示名称,默认取文件名)。允许扩展名:.jpg、.jpeg、.png、.webp、.mp3、.wav、.hdr、.glb、.gltf。单文件最大 5 MB。响应中的 data.asset.url 即为托管 URL。
在游戏 HTML 中使用该 URL,例如作为 img 的 src、通过 new Image() 加载后 drawImage,或通过 new Audio() 播放。
可选列出全部素材:GET https://api.remix.gg/v1/games/{gameId}/assets,同样带 Bearer 授权。
提示:使用有描述性的文件名(如 player-idle.png、jump-sfx.mp3),文件名会成为默认素材名;游戏开始前预加载素材,等待 onload / canplaythrough 事件再启动游戏循环;保持单文件小于 5 MB,上传前压缩图片和音频,图片优先 .webp、音频优先 .mp3;每个文件都重复步骤 2-3。
限制:仅支持上述扩展名;单文件不超过 5 MB;必须有 gameId 与 REMIX_API_KEY。其他收费、平台细节暂未提供。