# 开始

把 Listener 切换到 Python 再粘贴。工具需要已经安装。

只有已验证的 Basic 许可证才能打开。Trial、Player、未登录会抛出 `PermissionError`。

```python
from os_bipedPlus import openAPI

api = openAPI()
```

用 `api` 选取绑定，再用返回的 `rig` 操作。没有 `api.reset()`，要用 `rig.reset()`。

## 查找

场景里只有一个绑定的话，这样就够了。

```python
rig = api.scan()
print(rig.com, rig.namespace)
```

有多个时，先在视口选中那个 Biped，再调用 `scan()`。需要列表就看 [scan_all](scan-all.md)。

## 创建

```python
rig = api.build(height_cm=170, engine_type="unreal")
```

身高单位是厘米。引擎是 `"unreal"` 或 `"unity"`。没写的参数用工具默认值。选项见 [build](build.md)。

## 重置

```python
rig.reset("all")
```

`"all"` 会把 Biped 和控制器一起恢复到默认姿势。其他模式见 [reset](reset.md)。

## 两个对象上各有什么

`api`

- `scan_all` `scan` `build` `update_ui`

`rig`

- `inspect` `reset` `mirror` `flip` `update_init`
- `rig.com` 是 Biped 的名字。还有 `namespace`、`info`、`top_grp`。

---