포톤 퀀텀2
QTN에 정의 가능한 것들.
- component : 유니티 entity에 컴퍼넌트로 붙여서 값을 넣어서 퀀텀코드로 넘길 수 있음
- 미리정해진키워드 ex) input, global : component와 비슷하게 유니티에서 퀀텀코드로 넘길 변수를 추가 할 수 있는데,
미리 정의 된 키워드를 사용해야하고, frame안에 해당 키워드들을 얻어오는 함수도 미리 정의 되어 있다.
특히 global 키워드는 여러 qtn에 중복으로 선언 되어 있을 수 있고, 빌드하면 codegen의 __global__에 통합 된다.
- enum : 빌드하면 codegen에 추가 되고 단순 enum뿐 아니라 관련 된 세트가 추가 된다.
- synced event
EVENT_TYPE_COUNT가 증가 되고 GetEventType 에 case가 추가 된다.
EventBase 상속받는 XX 클래스가 추가 된다
FrameEvents 클래스에 XX형을 리턴하는 XX이름의 함수가 추가 되고 해당 함수 호출 시 frame의 이벤트 리스트에 add 된다.
- signal XX(int32 value);
ISignal 인터페이스를 상속 받는 ISignalXX 이름의 인터페이스가 생성 된다
Frame클래스에 ISignalXX 배열형의 변수가 선언 되고, XX이름의 함수가 추가 된다.
*런타임 에러
Checksum Error Detected By Server, Simulation Halting.
quantum.code를 리빌드하고 게임 exe 를 다시 빌드해서 테스트 하니 정상 작동.
퀀텀&유니티 통신 목록
—------------------------------------
퀀텀코드
Signal
퀀텀코드->유니티 CALL
Event
OnEntityInstantiated
유니티->퀀텀코드 CALL
[미리 정의 됨]
CallBack + input ( callback 의 구조체파라미터인 미리 정의 된 이름의 input의 변수를 사용자 정의 가능 )
[사용자 정의 가능]
EntityComponent
Command
퀀텀&유니티 통신 상세
—------------------------------------
*OnEntityInstantiated
퀀텀코드->유니티 CALL
entityView.OnEntityInstantiated.AddListener(OnEntityInstantiated);
*event
퀀텀코드->유니티 CALL
[호출 순서]
1.qtn 파일에 event{ string log; } 등록
2.unity 씬에 포함 된 오브젝트의 스크립트가 시작 되는 부분에서 case2 호출.
3.quntum.code 에서 f.events.log(“test”); 호출
ex)
case 1.QuantumCallback.Subscribe(this, (CallbackPollInput callback) => PollInput(callback));
case 2.QuantumEvent.Subscribe<EventLog>(this, EventLog);
*CallBack
유니티->퀀텀코드 CALL
ex)
QuantumCallback.Subscribe<CallbackPollInput>(this, PollInput);
public void PollInput(CallbackPollInput pollInput)
{
pollInput.SetInput(a, DeterministicInputFlags.Repeatable);
}
*Command
유니티->퀀텀코드 CALL
[준비]
1.DeterministicCommand를 상속받는 클래스 생성 후 파라미터로 넘겨받을 변수를 멤버 변수로 선언.
1-1.추상 함수 Serialize 재정의 후 멤버변수 serialize
1-2.실제 동작 할 함수 “Excute” 선언
2.모든 Command를 처리 할 System 클래스 생성 후 SystemSetup에 등록
2-1.update에서 frame.PlayerCommand 얻어온 후 실제 동작 함수 Excute 호출
var command = f.GetPlayerCommand(player->player);
if(command is SHCommand shcommand)
{
shcommand.Excute(f);
}
2-2.유니티에서 호출
QuantumRunner.Default.Game.SendCommand(new SHCommand()
{
shNumber = 3,
});
*Signal
퀀텀코드->퀀텀코드 CALL.
전역적으로 접근 할 수 있는 frame 내부에 함수를 선언 하는 것이다.
[Signal 선언]
.qtn 에 signal FunctionName(parametertype parametername);
[Signal 정의]
quantum.code system 클래스를 정의한 ISignalxx 인터페이스로 상속 받는다.
함수 구현 해 주면 호출시 해당 함수가 호출 된다
[Signal 호출]
f.signal.xx();
<유니티에서 퀀텀 주요 키워드 얻어오기>
EntityRef
GetComponent<EntityView>().EntityRef
Frame
var frame = QuantumRunner.Default.Game.Frames.Predicted;
<퀀텀문법>
*GetPointer
파라미터로 generic 형식에 Quantum.IComponent 형 struct를 넣어주면 entityRef 가 가지고 있는 컴퍼넌트를 리턴 한다. Quantum.IComponent 형 struct를 만들기 위해서는 qtn 파일에 component로 선언 해 주면 된다.
ex)
PlayerData data = f.Unsafe.GetPointer<PlayerData>(entityRef);
*TryGetPointer
GetPointer과 사용 목적이 같다.
ex)
if( f.Unsafe.TryGetPointer<PlayerData>(entityRef, out PlayerData* playerData))
{
}
*QuantumRunner : 유니티에서 Quantum에 접근하기 위한 MonoBehavior을 상속받는 인스턴스.
Session이라는 객체를 가지고 있고 내부의 update에서 Session.Update 돌면 퀀텀코드의 각종 콜백들이 호출 된다. 그중 하나가 “OnGameStart”
사용법
QuantumCallback.Subscribe(this, (CallbackGameStarted callback) => GameStarted(callback));
그런데 정작 필요한 OnGameStart가 호출 됐을 때 퀀텀코드에서 처리 할 함수는 재정의가 안 된다. OnEntityInstantiated는 Signal을 상속 받아서 처리 할 수 있는데 콜백은 안 돼서 아쉽다. command를 쏴서 구현 가능.
퀀텀 dsl component 는 component를 상속받은 struct이다
qtn에 struct를 정의 할 수 있고, struct에 함수를 추가 하고 싶으면 같은 이름의 구조체 하나 만들고 patial키워드 붙인 후 함수 선언 해 주면 된다.
*자료형변환
float time;
FP time;
float To FP
확장함수를 사용해서 time.ToFP(); 해 주면 되고
FP To float
time.AsFloat
*퀀텀 프록시 패턴 사용 예 ( 대리자 )
스킬 쿨타임을 퀀텀코드에서 관리 한다고 했을 때 유니티 UI에서 출력하기 위해 값을 얻어와야 하는데, event를 계속 쏴서 얻어오긴 부담스럽기 때문에 프록시패턴을 이용해서
프록시 클래스를 만들고 그 안에 얻어 올 퀀텀 코드에서의 프로타입컨퍼넌트들을 멤버 변수로 선언 해 준다.
static 으로 자기 자신을 리턴하는 Resolve 함수를 만들고, frame과 entityRef를 이용해서 GetPoint로 값을 가져온 뒤 프록시에 담아서 리턴한다.
callback+command 주의사항
퀀텀에서 정의 한 콜백을 사용 할 때 QuantumCallback.Subscribe 으로 콜백 등록을 하는데, 유니티 실행 후 바로 활성화 되는 게임오브젝트의 Awake에 Subscribe를 한 후, 콜백에서 Command를 했더니 퀀텀에서 받질 못했고 Start에서 Subscribe 하니 받아졌다. 콜백 자체는 호출 되는걸 보면 Command가 전송이 안 되는것같은데 아마 콜백 등록당시에는 QuantumRunner.Default.Game이 비정상 상태이지 않을까 싶다. 각각 로그를 찍어봤을때는 모두 QuantumRunner.Defualt가 null이고, 내부적으로 아직 다른 요소가 Awake에서는 준비가 안 된 상태이지 않을까싶다.
퀀텀코드 포인터주의
Get을 할 때는 상관없지만 Set을 할 때는 포인터를 다른 변수에 넣어두고 그 변수의 값을 셋팅하면 값이 변하지 않는다. 자신 없으면 좀 길더라도 원본에 셋 하도록 한다
GetPointer의 반복버전
var abilityHolders = f.Unsafe.GetComponentBlockIterator<Abilitys>();
foreach (var (e, a) in abilityHolders)
*퀀텀 WokerJob ( 쓰레드 ) 사용
SystemMainThread가 아닌 SystemBase 상속 받아서 작업
<???????????????????????>
?프레임개념?
Frame의 Predicted , Verified 차이
?아이콘 모양 차이는?
같은 프로젝트인데 솔루션에 따라 아이콘이 다르게 보이는 경우가 있다. 아래 c#이 보이는 아이콘의 프로젝트는 속성 보기가 가능하고, 위의 아이콘 프로젝트는 속성 보기가 안 된다.
