Phones

from tapkit import TapKitClient

client = TapKitClient()
phone = client.get_phone()

print(f"Connected to: {phone.name}")
print(f"Screen: {phone.width}x{phone.height}")

phones = client.list_phones()

for phone in phones:
    print(f"{phone.name} ({phone.id})")
    print(f"  Screen: {phone.width}x{phone.height}")
    print(f"  Unique ID: {phone.unique_id}")

# By name
iphone = client.phone("iPhone 15 Pro")

# By ID
iphone = client.phone("abc123-def456")

client.use_phone("iPhone 15 Pro")

# Now client-level methods use this phone
client.tap((100, 200))
client.home()

phone = client.get_phone()

# Get screen center
center = phone.screen.center
phone.tap(center)

# Check if point is within bounds
point = Point(100, 200)
if phone.screen.contains(point):
    phone.tap(point)

# Clamp coordinates to valid range
clamped = phone.screen.clamp(Point(-10, 3000))

phone = client.get_phone()

# Touch gestures
phone.tap((100, 200))
phone.double_tap((100, 200))
phone.flick((200, 400), direction="up")

# Device control
phone.home()
phone.lock()
phone.volume_up()

# App control
phone.type_text("Hello world")

job = phone.tap((100, 200))

print(f"Job ID: {job.id}")
print(f"Status: {job.status}")  # pending, running, completed, failed
print(f"Created: {job.created_at}")

# These are equivalent when you have one phone:
phone.tap((100, 200))
client.tap((100, 200))
client.tap((100, 200), phone_id=phone.id)