# scan()

今扱うリグを 1 つ返します。

リグが 1 つならそれを返します。複数あるときは、選択中のバイパッド、またはツールウィンドウが見ているリグを返します。

### シグネチャ
```python
api.scan() -> rig
```

引数はありません。

### 戻り値

`rig` が 1 つ。フィールドは [scan_all](scan-all.md) と同じです。

リグが無い、または 2 つ以上あってどれか決められないときは `ValueError` です。バイパッドを選択するか、[scan_all](scan-all.md) から選んでください。

### 例
```python
from os_bipedPlus import openAPI

api = openAPI()
rig = api.scan()
print(rig.info)
```

---