커스텀 플러그인

Enterprise 플랜에서만 사용 가능합니다.

ProtoPie Connect에는 API, IFTTT, Logitech G29 스티어링 휠, Arduino, Gamepad, blokdots 및 Unity를 포함하여 사전 설치된 여러 플러그인이 제공됩니다.

또한 Enterprise 플랜의 사용자는 자체 커스텀 플러그인을 업로드하여 프로토타입을 ProtoPie Connect를 통해 Socket.IO를 지원하는 모든 하드웨어, API 또는 앱에 연결할 수 있습니다.

커스텀 플러그인 만들기

ProtoPie Connect에서 커스텀 연동은 커스텀 플러그인과 브리지 앱을 사용하여 수행할 수 있습니다. 그러나 브리지 앱 대신 커스텀 플러그인을 사용하는 것이 좋습니다. 커스텀 플러그인 파일은 이식 가능하므로 작업하기 쉽고 팀원 간에 공유하기가 더 편리합니다.

커스텀 플러그인을 만드는 방법은 다음과 같습니다.

1. 코드를 작성하거나 기존 브리지 앱을 재사용합니다.

2. pkg를 사용하여 브리지 앱을 단일 실행 가능한 바이너리 파일로 컴파일합니다.
   Index.js 파일은 여러 타겟에 대해 컴파일할 수 있습니다 (자세한 내용은 여기를 참조하십시오).

• Mac ARM의 경우 pkg -t node16-macos-arm64 index.js

• Mac Intel의 경우 pkg -t node16-macos-x64 index.js

• Windows의 경우 pkg -t node16-win-x64 index.js

  3. 실행 파일을 빈 디렉터리에 복사하고 이름을 plugin으로 변경합니다. metadata.json 파일을 만들고 플러그인의 이름 { "name": "name of the plugin" }을 추가합니다.

  4. 파일(.zip)을 압축합니다. 이제 커스텀 플러그인을 사용할 준비가 되었습니다!

5. 커스텀 플러그인을 ProtoPie Connect로 가져와 터미널에서 실행합니다.

커스텀 플러그인 예시는 여기에서 확인할 수 있습니다.

브리지 앱이란 무엇인가요?

브리지 앱은 Socket.IO를 지원하는 모든 하드웨어, API 또는 앱과 ProtoPie Connect 간의 통신을 가능하게 합니다. 브리지 앱은 이벤트를 포착하고, 서버로부터 데이터를 수신하며, 심지어 단일 애플리케이션으로 작동할 수도 있습니다.

사용자의 편의를 위해 GitHub에서 제공되는 이러한 브리지 앱들을 사용하고 맞춤 설정할 수 있습니다.

브리지 앱을 통해 하드웨어 연결하기

브리지 앱의 주된 역할은 하드웨어의 신호를 ProtoPie가 이해할 수 있는 언어인 Socket.IO 메시지로 변환하거나 그 반대로 변환하는 것입니다.

1. 브리지 앱을 ProtoPie Connect에 연결합니다.

2. 브리지 앱은 하드웨어 신호를 ProtoPie가 해석할 수 있는 Socket.IO 메시지로 변환합니다. 일반적으로 메시지는 다음과 같은 형식입니다.**
   **◦ {messageId: "HwEventName", value: "ValueAssociatedWithEvent"}

3. ProtoPie Connect를 통해 이러한 메시지를 수신하는 프로토타입은 이에 따라 반응합니다. 일부 하드웨어는 양방향 통신을 지원하므로 프로토타입이 하드웨어에 메시지를 보낼 수 있습니다. 이는 브리지 앱이 Socket.IO 메시지를 하드웨어가 해석할 수 있는 신호로 변환할 수 있는 경우에만 가능합니다.

브리지 앱을 통해 API에 연결하기

브리지 앱을 통해 API에 연결하는 경우, 브리지 앱은 API 응답(예: JSON)을 개별 Socket.IO 메시지로 변환합니다.

예를 들어 프로토타입이 API로부터 날씨 데이터를 동적으로 가져와야 하는 경우 브리지 앱은 다음을 수행합니다.

1. JSON 응답을 Socket.IO 메시지로 변환합니다.
   ◦ 예: {"weather": "sunny", "temperature-celsius": 30.5}

2. ProtoPie Connect에 Socket.IO 메시지를 전송하면, ProtoPie Connect는 해당 메시지를 해당 프로토타입에 릴레이합니다.**
   **◦ {messageId: "weather", value: "sunny"},
   **◦ {messageId: "temperature", value: 30.5}

프로토타입에서 “weather” 및 “temperature” 메시지를 받으려면 Receive trigger가 필요합니다. Receive trigger에 대해 자세히 알아보세요.

동일한 장치에서 브리지 앱 실행하기

기본적으로 이러한 브리지 앱의 대부분은 브리지 앱과 ProtoPie Connect가 동일한 컴퓨터에서 실행된다고 가정하므로 IP 주소 http://localhost:9981을 사용합니다.

다른 장치에서 브리지 앱 실행하기

브리지 앱과 ProtoPie Connect가 서로 다른 컴퓨터에서 실행되는 경우 IP 주소를 ProtoPie Connect의 서버와 일치하도록 변경할 수 있습니다.

• ProtoPie Connect Desktop: 인터페이스 오프쪽 하단 모서리에서 서버 주소를 찾을 수 있습니다.

• ProtoPie Connect Embedded: 터미널에서 실행 직후 서버 주소를 찾을 수 있습니다.