custom data interface

사용자 정의 DI 도입 게이트

기본 인터페이스로 해결되지 않는 외부 데이터를 나이아가라에 연결하기 전 확인할 구현 경계를 정리합니다.

도입 순서
01

Need

기본 Data Interface와 User Parameter로 해결되지 않는 요구인지 확인합니다.

02

Class

C++에서 인터페이스 클래스를 만들고 노출할 데이터를 정의합니다.

03

Functions

나이아가라 스크립트가 호출할 함수와 입력, 출력 타입을 고정합니다.

04

Runtime

CPU와 GPU 중 어느 실행 경로에서 값을 읽을지 비용을 검토합니다.

05

Test

에디터 프리뷰와 실제 플레이에서 같은 값이 나오는지 검증합니다.

설계 기준

API 경계

나이아가라 그래프에는 필요한 함수만 노출해 사용자가 실수할 여지를 줄입니다.

타입 안정성

Vector, Float, Bool 같은 출력 타입은 그래프 연결성과 성능에 직접 영향을 줍니다.

GPU 경로

GPU 시뮬레이션에서 읽을 데이터라면 업로드 방식과 갱신 주기를 따로 봅니다.

Editor UX

디테일 패널에서 어떤 에셋이나 값을 넣어야 하는지 이름과 설명을 명확히 둡니다.

Fallback

데이터가 없을 때 빈 값, 기본값, 비활성화 중 어떤 동작을 할지 정합니다.

custom cue

도입 전에는 노출 함수, CPU/GPU 실행 경로, 데이터 없음 상태의 fallback을 문서에 고정합니다.