일반

로직의 모든 값 입력 항목에서 블록 코딩을 사용할 수 있습니다. 값 입력 항목의 우측 버튼을 클릭하면 네 가지 입력 방식을 선택할 수 있습니다.

• 직접 입력: 값을 그대로 입력합니다.
• 변수의 값: 다른 변수의 현재 값을 사용합니다.
• 블록 편집기: 블록을 조합하여 계산한 결과를 사용합니다.
• Lua 스크립트: Lua 코드를 작성하여 return 값을 사용합니다.

네 방식 모두 해당 입력 항목의 타입과 일치하는 값을 반환해야 합니다. 타입이 일치하지 않으면 실행 시 오류가 발생합니다.

블록 편집기

블록 편집기를 선택하고 블록 편집을 클릭하면 편집기가 열립니다. 편집기는 기능별 블록을 카테고리로 구분한 툴박스와 블록을 연결하여 구성하는 워크스페이스로 이루어져 있습니다.

블록 사용 규칙

• 반환 블록은 워크스페이스에 미리 놓여 있으며, 계산 결과를 블록 편집기 밖으로 내보내는 유일한 경로입니다. 반환 블록에 연결한 값의 타입은 해당 값 입력 항목의 타입과 일치해야 합니다.
• 대부분의 블록은 입력 또는 출력을 가지며(둘 다 없는 블록도 있습니다), 출력이 있는 블록은 드래그하여 다른 블록의 입력에 연결합니다.
• 입력과 출력에는 데이터 타입이 있으며 같은 타입끼리만 연결됩니다. 데이터 타입의 종류는 변수 타입과 동일합니다.
• 블록 위에 마우스를 올리면 설명이 툴팁으로 표시되고, 우클릭하면 사용 가능한 명령이 표시됩니다.
• 입력 개수가 정해지지 않은 블록(조건, 텍스트 합치기, 리스트 만들기, 지역 함수의 매개변수 등)은 블록의 톱니바퀴 버튼으로 항목을 추가·삭제하거나 순서를 변경합니다.
• 이미 블록이 연결된 입력에 새 블록을 연결하면 기존 블록은 밖으로 분리됩니다.
• 쉐도우 블록은 편의를 위해 미리 채워진 블록으로, 다른 블록으로 대체하면 자동으로 삭제됩니다.
• 완성된 블록은 모두 연결된 상태여야 하며, 비어 있는 입력이나 출력이 있으면 실행 시 오류가 발생합니다.
• 여러 블록을 상하로 연결하면 위에서부터 순차적으로 실행되며, 조건문과 반복문으로 복잡한 계산도 구성할 수 있습니다.
• 반복 중단 블록은 반복 블록 안에서만, 지역 함수의 다음을 반환 블록은 지역 함수 안에서만 사용할 수 있습니다.

블록

툴박스는 18개의 기능 카테고리로 구성됩니다. 편집기 상단의 검색창에 이름이나 설명을 입력하면 해당하는 블록만 추려서 표시하며, 각 블록의 상세 설명은 블록 위에 마우스를 올려 툴팁으로 확인할 수 있습니다.

지역 변수와 지역 함수

지역 변수는 해당 블록 편집기 안에서만 사용하는 변수로, 계산 중간값의 임시 저장에 사용합니다. 프로젝트 변수와는 별개이므로 다른 로직이나 대시보드에서는 보이지 않습니다. 변수 만들기, 값 쓰기, 값 읽기, 숫자 더하기 블록을 제공하며, 반복 카테고리의 증감 반복과 리스트 반복은 인덱스와 항목을 지역 변수에 저장하는 방식으로 동작합니다.

지역 함수는 같은 계산을 여러 곳에서 반복해야 할 때 사용합니다. 반환값이 없는 함수와 반환값이 있는 함수 두 가지를 정의할 수 있고, 블록의 톱니바퀴 버튼으로 입력 매개변수를 추가합니다. 정의한 함수는 같은 편집기 안의 다른 블록에서 호출 블록으로 실행하며, 호출 블록도 반환값 유무에 따라 두 가지입니다. 함수 도중에 값을 돌려주려면 다음을 반환 블록을 사용합니다.