Blueprint Developer API

Editor Utility Blueprint 및 Editor Utility Widget 작성자는 Locus의 선별된 비동기 노드를 사용해야 합니다. Unreal 리플렉션 시스템을 통해 노출되는 더 낮은 수준의 요청 객체는 Python과 공유되는 인프라이며 일반적인 Blueprint 워크플로가 아닙니다.

Blueprint 팔레트의 Locus > 노트, Locus > 문서, Locus > 핀에서 노드를 찾습니다.

사용 가능한 노드

범주	노드
Locus > 노트	List Locus Notes, Get Locus Note, Search Locus Notes, Create Locus Note, Update Locus Note, Archive Locus Note
Locus > 문서	List Locus Documents, Get Locus Document, Search Locus Documents, Create Locus Document, Update Locus Document
Locus > 핀	List Locus Pins, Get Locus Pin, Create Locus Pin, Update Locus Pin Metadata, Add Locus Pin Comment

비동기 결과

각 노드는 종료 Succeeded 및 Failed 실행 출력을 노출합니다. 비동기 결과로 오인할 수 있는 즉시 완료 경로는 의도적으로 제공하지 않습니다.

두 결과 모두 다음을 노출합니다.

형식화된 Result
제공자 중립적인 Operation Status
형식화된 Error

실패 시 Message를 파싱하지 말고 Error > Code로 분기합니다. 노출된 Async Action 프록시는 실행을 시작하지 않은 작업에 대해 협력적인 Cancel을 제공합니다. 이미 영속화 처리에 들어간 변경을 취소로 중단할 수는 없습니다.

문서 만들기

Create Locus Document를 추가하고 다음을 제공합니다.

Path: 선택한 표시 루트에 상대적인 경로. 예: Design/Combat.md
Markdown: 초기 소스. 예: # Combat
Presentation Root: Locus 문서 또는 콘텐츠 브라우저

Succeeded 결과의 Identity > Relative Path를 권위 있는 문서 ID로 사용합니다. 표시 경로나 /Game/... 컨텍스트로 대체하지 마세요.

리비전 안전 노트 업데이트

Get Locus Note를 사용하고 Identity 및 Revision 출력을 보관합니다.
Locus Developer Note Changes 구조체를 만듭니다.
변경할 필드에 대해서만 Set ... 의도 플래그를 설정합니다.
Identity, 읽은 리비전을 Expected Revision, Changes로 사용해 Update Locus Note를 호출합니다.
Succeeded를 따르거나 Failed > Error > Code를 확인합니다. Stale Revision이면 노트를 다시 가져와 업데이트를 재고합니다.

변경 구조체는 변경하지 않음, 설정, 지우기를 구분합니다.

값	의미
`Set Title = false`	Title을 변경하지 않으며 Title 값은 무시됩니다.
`Set Title = true`, `Title = "New Title"`	비어 있지 않은 제목을 설정합니다.
`Set Title = true`, `Title = ""`	도메인 검증에 따라 빈 제목을 명시적으로 요청합니다.

같은 패턴이 노트 본문, 태그, 상태에도 적용됩니다. 성공한 뒤 다음 변경에는 새 결과 리비전을 사용하세요.

핀 메타데이터 변경에는 같은 의도 규칙으로 Set Title, Set Description, Set Pin Type, Set Tags를 사용합니다. Update Locus Pin Metadata는 핀의 월드, 위치, 앵커, 뷰, 범위를 보존합니다.

핀

Create Locus Pin은 명시적인 범위, 저장된 월드 애셋 경로, 월드 공간 위치 및 제목을 허용합니다. 고급 입력에는 월드 레이블, 설명, 핀 유형 및 태그가 있습니다. 월드 경로는 지원되는 저장된 프로젝트 소유 월드를 식별해야 합니다. 예: /Game/Maps/Main.Main

Blueprint는 핀을 나열하고 가져오며, 안전한 기본 핀 형식을 만들고, 메타데이터를 업데이트하고, 댓글을 추가할 수 있습니다. Developer API는 핀 위치 재지정 또는 임의의 앵커 교체를 노출하지 않습니다.

리비전, 형식화된 오류, 작업 상태, 범위 및 전체 기능 매트릭스는 Developer API 개요를 참조하세요.