설정: TORUS App 등록

Api.Initialize()과 App 등록 정보

TORUS App은 Api.Initialize() 함수를 통해 TORUS 플랫폼에 연결 됩니다. 따라서 TORUS App은 실행 후 TORUS 플랫폼과 연결되기 위해 Api.Initialize()를 가장 먼저 실행하여야 합니다.

TORUS 플랫폼은 TORUS App의 연결 요청을 받으면 보유중인 App 등록 정보 중에 해당 TORUS App과 일치하는 것이 있는지 확인합니다. 일치하는 App 등록 정보가 있다면 TORUS App의 연결을 허용하고, 없다면 연결을 거부합니다.
TORUS 플랫폼에 App 정보를 등록하려면 JSON 포맷의 정보 파일을 만들어 [TORUS Install Folder]/Binary/application 폴더에 위치시켜야 합니다. 이 정보 파일들을 "App 등록 정보 파일"(앱인포 파일)이라고 합니다. TORUS 플랫폼은 플랫폼 시작시에만 App 등록 정보 파일들을 읽기 때문에 새로운 파일이 추가되면 TORUS 플랫폼을 재시작해야 합니다.

 

App 등록 정보 파일 작성

위와 같이 TORUS 플랫폼이 TORUS App에 대한 App 등록 정보 파일을 가지고 있어야 해당 TORUS App이 TORUS 플랫폼에 연결될 수 있습니다. 그러므로 새로운 TORUS App을 개발한다면 해당 TORUS App의 App 등록 정보 파일도 함께 배포해야 합니다.
App 등록 정보 파일의 이름 형식은 "[App이름].info"입니다. 확장자가 반드시 "info"여야 합니다.
App 등록 정보 파일의 내용은 TORUS 플랫폼이 TORUS App을 인식, 파악하기 위해 필요한 속성입니다. 

App.info 작성예시 (TORUS App "CommandTester"의 App 등록 정보 파일)

{     "App ID": "4300C7D2-FB9B-45B2-978C-DEB419FF5B94",     "App Name": "CommandTester",     "Version": "1.0.0",     "App File": "CommandTester.exe" }

위 예시의 파일명은 "[App이름].info" 형식에 따라 CommandTester.info입니다. [TORUS Install Folder]/Binary/application 폴더에 실제 CommandTester.info 파일이 들어있습니다.
"CommandTester"는 TORUS 테스트 목적으로 TORUS 설치시 기본 제공되는 TORUS App입니다. [TORUS Install Folder]/Binary/CommandTester.exe가 "CommandTester"의 실행 파일입니다. 만약 CommandTester.info 파일을 삭제하면 "CommandTester"는 TORUS 플랫폼에 연결될 수 없습니다.

위 예시에서는 App 등록 정보 파일의 속성 중 반드시 필요한 것만 작성 되어있습니다. 나머지 속성은 TORUS 매뉴얼을 참조하여 주십시오.
예시의 각 속성에 대한 설명은 다음과 같습니다.

• App ID: App의 GUID입니다.
• App Name: App의 이름, App의 Label 역할입니다.
• Version: App의 버전 정보입니다.
• App File: App 실행 파일의 파일명(확장자 포함)입니다.

TORUS App에서 아래와 같이 Api.Initialize()을 실행할때 매개변수로 AppID(GUID), AppName(string)가 필요합니다.
※ 아래의 매개변수는 가장 기본적인 사용 예시입니다. 추가 설정은 TORUS 매뉴얼을 참조하십시오.

int result = Api.Initialize(new GUID("4300C7D2-FB9B-45B2-978C-DEB419FF5B94"), "CommandTester");

"AppID", "AppName", "App 실행 파일의 파일명" 이 3가지가 TORUS 플랫폼이 가진 App 등록 정보와 일치해야 TORUS 플랫폼이 TORUS App의 연결을 허가합니다.