Skip to content

Fixes IOHIDEvent/UITouch phase mismatch that causes some games #223

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DaDaweiZhou wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Fixes IOHIDEvent/UITouch phase mismatch that causes some games #223

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b6d0ace
fix: Update IOHIDEvent on touch phase changes for game compatibility
May 17, 2026
f269984
Merge branch 'PlayCover:master' into master
DaDaweiZhou Jun 7, 2026
98b08ae
Add back parameter comments for handEvent and fingerEvent
Jun 7, 2026
2265c73
Use fingerTimestamp instead of timeStamp for per-finger HID events
Jun 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 31 additions & 3 deletions PlayTools/Controls/PTFakeTouch/Additions/IOHIDEvent+KIF.m
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -160,11 +160,39 @@ IOHIDEventRef kif_IOHIDEventWithTouches(NSArray *touches) {
IOHIDEventSetIntegerValue(handEvent, kIOHIDEventFieldDigitizerIsDisplayIntegrated, true);

for (UITouch *touch in touches) {
uint32_t eventMask = (touch.phase == UITouchPhaseMoved) ? kIOHIDDigitizerEventPosition : (kIOHIDDigitizerEventRange | kIOHIDDigitizerEventTouch);
uint32_t isTouching = (touch.phase == UITouchPhaseEnded) ? 0 : 1;
// Set eventMask and touch/range state based on actual touch phase.
// These must accurately reflect the UITouch.phase so that game-side
// validation (e.g. Tencent anti-automation) does not flag the IO HID
// event as inconsistent with the UIKit touch state.
uint32_t eventMask;
uint32_t isTouching;
switch (touch.phase) {
case UITouchPhaseMoved:
eventMask = kIOHIDDigitizerEventPosition;
isTouching = 1;
break;
case UITouchPhaseEnded:
case UITouchPhaseCancelled:
eventMask = kIOHIDDigitizerEventTouch;
isTouching = 0;
break;
default: // Began / Stationary
eventMask = kIOHIDDigitizerEventRange | kIOHIDDigitizerEventTouch;
isTouching = 1;
break;
}

CGPoint touchLocation = [touch locationInView:touch.window];

// Each finger gets its own timestamp for more realistic HID events.
// Real multi-touch hardware fires independent events per finger.
uint64_t fingerTime = mach_absolute_time();
AbsoluteTime fingerTimestamp;
Comment thread
TheMoonThatRises marked this conversation as resolved.
fingerTimestamp.hi = (UInt32)(fingerTime >> 32);
fingerTimestamp.lo = (UInt32)(fingerTime);

IOHIDEventRef fingerEvent = IOHIDEventCreateDigitizerFingerEventWithQuality(kCFAllocatorDefault, // allocator
timeStamp, // timestamp
fingerTimestamp, // finger timestamp
(UInt32)[touches indexOfObject:touch] + 1, //index
2, // identity
eventMask, // eventMask
Expand Down
4 changes: 4 additions & 0 deletions PlayTools/Controls/PTFakeTouch/Additions/UITouch-KIFAdditions.m
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,10 @@ - (void)setPhaseAndUpdateTimestamp:(UITouchPhase)phase
//DLog(@"setPhaseAndUpdateTimestamp : %ld",(long)phase);
[self setTimestamp: [[NSProcessInfo processInfo] systemUptime]];
[self setPhase:phase];
// Update the IOHIDEvent to match the new phase.
// Some games validate IOHIDEvent.eventMask against UITouch.phase,
// so keeping them in sync is critical for fake touch acceptance.
[self kif_setHidEvent];
}

- (void)kif_setHidEvent {
Expand Down
Loading