set_unpack() — Fast Ref API Reference

지정된 슬롯의 Unpack 상태를 ON/OFF 합니다. Unpack ON 상태에서는 레퍼런스 노드들이 최상위 그룹 컨테이너에서 분리되어 월드 레벨로 이동합니다.

시그니처

api.set_unpack(slot: int, on: bool) -> dict

파라미터

파라미터	타입	설명
`slot`	`int`	슬롯 번호 (0-9)
`on`	`bool`	`True` = Unpack, `False` = Repack(그룹 복원)

반환값

{"success": bool, "message": str}

예외

예외	조건
`TypeError`	slot이 int가 아닐 때 (bool 포함) [v2 추가]
`ValueError`	슬롯이 유효하지 않거나 비어 있을 때

예제

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
api.set_unpack(slot=0, on=True)  # Unpack (detach from group)
api.set_unpack(slot=0, on=False) # Repack (restore group)