SuperAPI AI 工具集

unity-gameobject

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

用途:面向 Unity 场景层级的 GameObject 操作,适用于搭建或调整场景层级、新建或删除物体、修改 Transform。

主要能力:单对象技能包括 gameobject_create、gameobject_delete、gameobject_duplicate(同级命名 <name>_Copy)、gameobject_rename、gameobject_set_transform、gameobject_set_active、gameobject_set_parent(不传 parent id 即解除父子)、gameobject_set_sibling_index(索引会被截断)。批量技能包括对应的 *_batch,以及 gameobject_set_layer_batch、gameobject_set_tag_batch。查询技能为 gameobject_find(按名称子串或正则、tag、layer、component)与 gameobject_get_info(transform、父级、子级、组件),两者均为 SemiAuto 只读,无批量版本。2 个及以上对象建议使用 *_batch,一次调用完成。

用法要点:标识符可用 entityId(字符串,Unity 6000.4+)、instanceId(整数,旧版 Unity)、path("Parent/Child",大小写不敏感,可带场景名前缀)、name,至少给出一个,优先级为 entityId > instanceId > path > name,失效 id 或未命中路径会顺延到下一个给定标识。名称匹配优先精确匹配,否则使用整词或子串匹配;多个模糊匹配返回 TARGET_NOT_FOUND 与候选(path 加 entityId),非精确解析记录在 resolutionNotes。gameobject_create 的 x/y/z 与 rotX/Y/Z 默认相对父级局部空间,space:"world" 则在挂接后按世界空间应用。gameobject_set_transform 的 posX/Y/Z 与 rotX/Y/Z 为世界空间,localPosX/Y/Z 为局部空间,应用顺序为世界位置、局部位置、旋转、缩放,同一轴局部值优先,省略轴保持原值,scaleX/Y/Z 始终为 localScale;RectTransform 字段(anchor、pivot、sizeDelta、width/height)仅 UI 可用。create、set_transform 及其批量调用会回读并返回 Transform。批量 items 为 JSON 数组,全部成功或全部回滚,失败时 rolledBack:true,未知键被忽略并在 warnings 中说明。

限制:gameobject_delete 与 gameobject_delete_batch(Operation.Delete)在 Approval/Auto 下为 MODE_FORBIDDEN,仅在 Bypass 或命中 Allowlist 时可执行。不存在 gameobject_move、gameobject_rotate、gameobject_set_scale、gameobject_set_position、gameobject_add_component、gameobject_get_transform,应改用 gameobject_set_transform、component_add、gameobject_get_info;组件相关用 component_,材质或颜色用 material_,scene_find_objects 也可搜索对象。参数、默认值与必填项以 GET /skills/schema?category=GameObject 或 ?names=a,b 为准,常见错误包括 TARGET_NOT_FOUND、MISSING_PARAM、SEMANTIC_INVALID 及传输类错误码。