Touch

จัดการการคลิกและปัดแบบขนานจากสคริปต์หรือแอ็กชันของมาโคร: จัดกลุ่ม ดูความคืบหน้า รอ หรือยกเลิก ในสคริปต์ใช้ click(..., parallel=True) หรือ swipe(..., parallel=True) ต้องเปิดบริการการช่วยเหลือพิเศษของ CogniTab เพื่อส่งท่าทาง

รูปแบบคำสั่ง

Touch

ไม่สามารถสร้างคลาสนี้โดยตรงได้

ค่าที่ส่งกลับ

—

ตัวอย่าง

Touch.collect()
a = click(Point(300, 900), hold_ms=5000, parallel=True)
b = click(Point(780, 900), hold_ms=1000, delay_before=1000, parallel=True)
sent = Touch.send()
Touch.cancel(a)
Touch.wait()

เมธอด

7 เมธอด

Touch.collect

เก็บคำสั่งคลิก/ปัดถัดไปในสคริปต์ที่ใช้ parallel=True จนเรียก Touch.send() เพื่อให้ทำงานร่วมกัน คำสั่งอื่นไม่เปลี่ยน หากไม่เก็บ คำสั่งขนานจะส่งทันที ต้องเรียก Touch.send() ก่อนสคริปต์จบ มิฉะนั้นท่าทางที่ยังไม่ส่งจะทำให้เกิดข้อผิดพลาด

รูปแบบคำสั่ง

Touch.collect()

ค่าที่ส่งกลับ

None

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Touch.send

ส่งท่าทางที่เก็บไว้พร้อมกันแล้วหยุดโหมดเก็บ คืน ID ตัวเลขตามลำดับที่เก็บ หรือรายการว่างหากไม่มี เกิน 10 ท่าทางจะเกิดข้อผิดพลาด การส่งไม่รอให้ทำงานเสร็จ ใช้ Touch.wait() เพื่อรอ

รูปแบบคำสั่ง

Touch.send()

ค่าที่ส่งกลับ

list[Number]

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Touch.queued

คืนสถานะของท่าทางที่ส่งแล้วและกำลังรอเริ่ม ท่าทางที่ Touch.collect() เก็บไว้จะยังไม่รวมจนเรียก Touch.send()

รูปแบบคำสั่ง

Touch.queued()

ค่าที่ส่งกลับ

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.queued())
Touch.wait()

Touch.active

คืนสถานะของท่าทางที่กำลังทำงาน

รูปแบบคำสั่ง

Touch.active()

ค่าที่ส่งกลับ

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.active())
Touch.wait()

Touch.all

คืนสถานะท่าทางที่รอหรือกำลังทำงาน พร้อมสถานะที่เพิ่งจบสูงสุด 64 รายการ ไม่รวมท่าทางที่ยังไม่ได้ส่งด้วย Touch.send()

รูปแบบคำสั่ง

Touch.all()

ค่าที่ส่งกลับ

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.all())
Touch.wait()

Touch.wait

รอท่าทางที่ส่งแล้วตาม ID ตัวเลขนี้และคืน TouchState หรือ None หากไม่รู้จัก ID หรือไม่ได้เก็บไว้แล้ว เมื่อ id=None จะรอทุกท่าทางที่รอหรือกำลังทำงาน แล้วคืนสถานะที่ยังเก็บไว้ รวมรายการที่เพิ่งจบ ต้องส่งท่าทางที่เก็บไว้ก่อน

รูปแบบคำสั่ง

Touch.wait(id=None)

ค่าที่ส่งกลับ

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait(first)
Touch.wait()

Touch.cancel

ยกเลิกท่าทางที่ส่งแล้วซึ่งรอหรือกำลังทำงานตาม ID ตัวเลข คืน True หากรับคำสั่ง มิฉะนั้น False เมื่อ id=None จะยกเลิกทั้งหมดและคืนจำนวนที่รับคำสั่ง การยกเลิกท่าทางที่กำลังทำงานต้องใช้ Android 8.0+ และเกิดข้อผิดพลาดบน Android 7.x ไม่ยกเลิกท่าทางที่ Touch.collect() ยังเก็บไว้

รูปแบบคำสั่ง

Touch.cancel(id=None)

ค่าที่ส่งกลับ

Boolean | Int

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
# การยกเลิกการทำงานที่กำลังดำเนินอยู่ต้องใช้ Android 8 ขึ้นไป
Touch.cancel(second)
Touch.wait()