Tap Counting 기능 설명
gesture_get_tap_count
함수는 탭 카운팅이 활성화되어 있는지 비활성화되어 있는지를 확인하는 데 사용됩니다. 이 함수는 탭 카운팅이 활성화되어 있으면 true
를 반환하고, 그렇지 않으면 false
를 반환합니다. 탭 카운팅은 gesture_tap_count()
함수를 사용하여 활성화하거나 비활성화할 수 있습니다.
탭 카운팅이 활성화되면 각 탭 이벤트에 "tapcount"라는 DS 맵 항목이 추가되어 탭 수가 기록됩니다. 활성화된 경우 모든 탭 이벤트가 트리거됩니다. 예를 들어, 두 번의 탭은 단일 탭 이벤트와 이중 탭 이벤트 모두를 트리거하며, 단일 탭 이벤트의 탭 수는 1, 이중 탭 이벤트의 탭 수는 2가 됩니다. 이중 탭 감지 시간(함수 gesture_double_tap_time()
참조)이 지나면 탭 수 값은 0으로 리셋됩니다.
탭 카운팅이 비활성화된 경우, 초기 탭은 이중 탭 시간이 지나고 두 번째 탭이 감지되지 않을 때까지 등록되지 않습니다. 기본적으로 탭 카운팅은 활성화되어 있습니다.
문법
gesture_get_tap_count();
반환값
- 탭 카운팅이 활성화되어 있으면
true
, 비활성화되어 있으면false
를 반환합니다.
예제
if (!gesture_get_tap_count()) {
gesture_tap_count(true);
}
위 코드는 탭 카운팅이 활성화되어 있는지 확인하고, 비활성화되어 있다면 활성화합니다.
활용 예제
예제 번호 | 설명 |
---|---|
1 | 사용자가 화면을 두 번 탭했을 때 이중 탭 이벤트를 처리하는 코드 |
2 | 탭 카운팅을 사용하여 사용자가 몇 번 탭했는지 기록하는 코드 |
3 | 탭 카운팅이 비활성화된 상태에서 단일 탭 이벤트를 처리하는 코드 |
4 | 이중 탭 감지 시간을 조정하여 사용자 경험을 개선하는 코드 |
예제 코드 스니펫
// 예제 1: 이중 탭 이벤트 처리
if (gesture_get_tap_count()) {
// 이중 탭 이벤트 처리
}
// 예제 2: 탭 수 기록
var tap_count = 0;
if (gesture_get_tap_count()) {
tap_count += 1;
}
// 예제 3: 단일 탭 이벤트 처리
if (!gesture_get_tap_count()) {
// 단일 탭 이벤트 처리
}
// 예제 4: 이중 탭 감지 시간 조정
gesture_double_tap_time(300); // 300ms로 설정