Runtime v2.81 · อัปเดต 30 ก.ย. 2569

Touch

ตัวช่วยแบบคงที่สำหรับการคลิก/การปัดแบบขนานที่สร้างโดย UI หรือโค้ดผ่านการคลิก(..., Parallel=True) และ การปัด(..., Parallel=True) คุณสามารถรวบรวมการดำเนินการคลิก/ปัดแล้วส่งพร้อมกัน หรือตรวจสอบการดำเนินการคลิก/ปัดที่ทำงานอยู่หรืออยู่ในคิว ตัวช่วยยังรองรับการยกเลิกการดำเนินการคลิก/ปัดนิ้วที่ใช้งานอยู่ (เฉพาะ Android 8.0 ขึ้นไป)

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

Touch

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

พารามิเตอร์

ไม่มี

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

—

พฤติกรรม / ผลข้างเคียง

ตัวช่วยแบบคงที่สำหรับการคลิก/การปัดแบบขนานที่สร้างโดย UI หรือโค้ดผ่านการคลิก(..., Parallel=True) และ การปัด(..., Parallel=True) คุณสามารถรวบรวมการดำเนินการคลิก/ปัดแล้วส่งพร้อมกัน หรือตรวจสอบการดำเนินการคลิก/ปัดที่ทำงานอยู่หรืออยู่ในคิว ตัวช่วยยังรองรับการยกเลิกการดำเนินการคลิก/ปัดนิ้วที่ใช้งานอยู่ (เฉพาะ Android 8.0 ขึ้นไป)

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

ท่าทาง Android ใช้อุปกรณ์ร่วมกัน parallel=True จัดคิว id การสัมผัส แต่ delay_before และ delay_after ยังทำให้รอนอกโหมด collect ในโหมด collect จะรวบรวมการสัมผัสเพื่อ Touch.send(); Touch.wait() รอจนเสร็จ

ตัวอย่าง

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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

เมธอด

7 เมธอด

Touch.collect

Enable collect mode for click/swipe calls with parallel=True.

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

Touch.collect()

พารามิเตอร์

ไม่มี

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

None

พฤติกรรม / ผลข้างเคียง

Enable collect mode for click/swipe calls with parallel=True. When enabled, parallel click/swipe calls are not sent immediately; they are collected and only sent after Touch.send(). This method works for both UI/code. If Touch.collect() is not enabled, parallel click/swipe calls are sent immediately, and later click/swipe calls must wait for the previous click/swipe to finish before they can run because running a later click/swipe immediately would cancel the previous one. You can intentionally cancel the previous click/swipe with Touch.cancel().

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

collect/send และการอ่านสถานะไม่รอท่าทางเสร็จ คำสั่งที่รวมถึง executor เมื่อ Touch.send() เท่านั้น ภาพสถานะคิวเปลี่ยนได้ทันที

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.send

Send all click/swipe calls collected by Touch.collect() at once, return their matching numeric ids, then turn off Touch.collect() collection mode.

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

Touch.send()

พารามิเตอร์

ไม่มี

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

list[Number]

พฤติกรรม / ผลข้างเคียง

Send all click/swipe calls collected by Touch.collect() at once, return their matching numeric ids, then turn off Touch.collect() collection mode.

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

collect/send และการอ่านสถานะไม่รอท่าทางเสร็จ คำสั่งที่รวมถึง executor เมื่อ Touch.send() เท่านั้น ภาพสถานะคิวเปลี่ยนได้ทันที

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.queued

Return touch states currently in the queue.

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

Touch.queued()

พารามิเตอร์

ไม่มี

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

list[TouchState]

พฤติกรรม / ผลข้างเคียง

Return touch states currently in the queue.

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

collect/send และการอ่านสถานะไม่รอท่าทางเสร็จ คำสั่งที่รวมถึง executor เมื่อ Touch.send() เท่านั้น ภาพสถานะคิวเปลี่ยนได้ทันที

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.active

Return active touch states.

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

Touch.active()

พารามิเตอร์

ไม่มี

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

list[TouchState]

พฤติกรรม / ผลข้างเคียง

Return active touch states.

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

collect/send และการอ่านสถานะไม่รอท่าทางเสร็จ คำสั่งที่รวมถึง executor เมื่อ Touch.send() เท่านั้น ภาพสถานะคิวเปลี่ยนได้ทันที

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.all

Return recent and queued/active touch states.

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

Touch.all()

พารามิเตอร์

ไม่มี

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

list[TouchState]

พฤติกรรม / ผลข้างเคียง

Return recent and queued/active touch states.

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

collect/send และการอ่านสถานะไม่รอท่าทางเสร็จ คำสั่งที่รวมถึง executor เมื่อ Touch.send() เท่านั้น ภาพสถานะคิวเปลี่ยนได้ทันที

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.wait

Wait for one numeric id, or every queued/active touch when id is None.

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

Touch.wait(id=None)

พารามิเตอร์

ไม่มี

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

TouchState | list[TouchState]

พฤติกรรม / ผลข้างเคียง

Wait for one numeric id, or every queued/active touch when id is None.

การทำงาน

  • รอให้เสร็จ: ใช่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

รอในโฟลว์ผู้เรียกจนถึงเวลาที่กำหนดหรือการสัมผัสเสร็จ โฟลว์อื่นทำต่อได้ pause และ stop ยังมีผล

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Touch.cancel

Cancel one queued or active touch by numeric id.

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

Touch.cancel(id=None)

พารามิเตอร์

ไม่มี

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

Boolean | Int

พฤติกรรม / ผลข้างเคียง

Cancel one queued or active touch by numeric id. When id is None, cancels every queued/active touch and returns the accepted cancel count. Active cancel requires Android 8.0+; Android 7.x scripts fail with a clear error when an active touch is targeted.

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: มีข้อจำกัด
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

ท่าทาง Android ใช้อุปกรณ์ร่วมกัน parallel=True จัดคิว id การสัมผัส แต่ delay_before และ delay_after ยังทำให้รอนอกโหมด collect ในโหมด collect จะรวบรวมการสัมผัสเพื่อ Touch.send(); Touch.wait() รอจนเสร็จ

ตัวอย่าง

# ตรวจสอบหรือควบคุมการสัมผัสที่รวบรวมไว้
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()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง