readme.md

ส่วนเสริม NVDA สำหรับเพิ่มประสิทธิภาพการเข้าถึง LINE Desktop

ภาพรวม (Overview)

ส่วนเสริม (Add-on) นี้ช่วยเพิ่มประสิทธิภาพการทำงานของโปรแกรมอ่านหน้าจอ NVDA สำหรับแอปพลิเคชัน LINE บน Windows (เวอร์ชัน Qt6) โดยจะช่วยอำนวยความสะดวกในการนำทางห้องแชท การอ่านข้อความ และการโทรออกผ่านระบบ OCR และการสั่งการแบบระบุพิกัดอัตโนมัติ

Important

ข้อควรทราบ: ส่วนเสริมนี้มีการใช้เทคโนโลยี OCR (Optical Character Recognition) ในบางฟังก์ชัน ผลลัพธ์ที่ได้อาจไม่ถูกต้องแม่นยำ 100%

คุณสมบัติเด่น (Features)

• ปรับปรุงระบบการนำทาง: สำหรับรายการแชทและช่องกรอกข้อความ
• การโทรด้วยเสียงและวิดีโอ: เริ่มการโทรจากแท็บเพื่อน
• การจัดการสายเรียกเข้า: รับสาย ปฏิเสธสาย หรือตรวจสอบข้อมูลผู้โทร
• รองรับระบบ OCR: พยายามอ่านข้อความที่ระบบการเข้าถึงมาตรฐาน (Accessibility APIs) เข้าไม่ถึงโดยอัตโนมัติ
• เครื่องมือช่วยเหลือ (Debug Tools): มีคีย์ลัดสำหรับตรวจสอบโครงสร้าง UI เพื่อใช้ในการแก้ไขปัญหา
• โปรแกรมอ่านข้อความแชท: ส่งออกห้องแชทปัจจุบันและเปิดอ่านในหน้าต่างอ่านที่เข้าถึงง่าย
• คีย์ยืนยันตามบริบท: มีคีย์เดี่ยวชั่วคราวสำหรับกล่องโต้ตอบเรียกคืนข้อความและการยินยอม "แปลงเป็นข้อความ"
• การตอบกลับสถานะ: ประกาศการสลับแท็บและสถานะไมโครโฟน/กล้องระหว่างการโทร พร้อมเล่นเสียงสั้นเมื่อส่งข้อความสำเร็จจริง

คำแนะนำการใช้งาน (Usage Tips)

• การสร้างการเชื่อมต่อ: ก่อนจะใช้ส่วนเสริมนี้ส่งข้อความหาใครเป็นครั้งแรก แนะนำให้ส่งข้อความหาคนนั้นผ่านโทรศัพท์มือถือหรือ Chrome Extension ก่อนอย่างน้อยหนึ่งข้อความ เนื่องจากประวัติการแชทจะช่วยให้ส่วนเสริมค้นหาตำแหน่งขององค์ประกอบต่าง ๆ ได้แม่นยำยิ่งขึ้น
• การส่งข้อความ:
  1. ค้นหาชื่อเพื่อน โดยพยายามใช้คำค้นหาที่แสดงผลลัพธ์เพียงรายการเดียวเพื่อป้องกันความผิดพลาด
  2. เมื่ออยู่ในรายการแชทหรือแถบด้านข้าง ให้กด Shift+Tab เพื่อไปยังช่องพิมพ์ข้อความ (Edit field)
  3. พิมพ์ข้อความแล้วกด Enter เพื่อส่ง
• การโทรออก: ขณะนี้ไม่สามารถกดโทรออกได้โดยตรงจากแท็บแชทด้วยส่วนเสริมนี้ โปรดทำตามขั้นตอนต่อไปนี้:
  1. กด Control+1 เพื่อสลับไปยังแท็บเพื่อน
  2. ค้นหาชื่อเพื่อน เลือกเพื่อน และเปิดห้องแชท
  3. กด NVDA+Windows+C เพื่อโทรด้วยเสียง หรือกด NVDA+Windows+V เพื่อโทรด้วยวิดีโอ
• การตรวจสอบ: ควรตรวจสอบประวัติการแชทและชื่อผู้รับให้แน่ใจทุกครั้งก่อนจะส่งข้อความหรือกดโทรออก

เอฟเฟกต์เสียง

• ค่าเริ่มต้น (คัดลอกสำเร็จ): หากข้อความถูกอ่านผ่านการคัดลอกจากเมนูคลิกขวา จะไม่มีเสียงเอฟเฟกต์พิเศษ
• เสียง OCR สำรอง: หากข้อความถูกอ่านผ่าน OCR จะมีเสียง ocr.wav ดังขึ้นเพื่อแจ้งว่าเนื้อหาที่อ่านได้อาจไม่ถูกต้องทั้งหมด
• เสียงเมื่อส่งข้อความ: เมื่อกด Enter ในช่องข้อความและ LINE ส่งข้อความสำเร็จจริง ส่วนเสริมจะเล่นเสียงสั้น ๆ หาก Enter ใช้เพียงยืนยันการพิมพ์ของ IME จะไม่มีเสียง

Warning

ผลลัพธ์จาก OCR (การรู้จำอักขระด้วยแสง) ไม่ถูกต้อง 100% หากคุณได้ยินเสียง ocr.wav โปรดทราบว่าข้อความที่อ่านได้อาจแตกต่างจากเนื้อหาจริง หากต้องการยืนยันเนื้อหาที่แน่นอน แนะนำให้ตรวจสอบข้อความบนโทรศัพท์มือถือหรือแพลตฟอร์มอื่น

การอ่านและคัดลอกข้อความ

• การอ่านข้อความ: เมื่อเลื่อนดูรายการข้อความ ส่วนเสริมจะใช้วิธี "คัดลอกก่อน" ในการอ่านข้อความ โดยจะคลิกขวาที่ข้อความโดยอัตโนมัติ → เลือก "คัดลอก" → อ่านเนื้อหาจากคลิปบอร์ด เนื้อหาคลิปบอร์ดเดิมจะถูกกู้คืนหลังจากอ่านเสร็จ
• การคัดลอกข้อความ: กด Control+C ในรายการข้อความ ส่วนเสริมจะคัดลอกข้อความไปยังคลิปบอร์ดผ่านเมนูคลิกขวา
• การใช้ OCR สำรอง: หากการคัดลอกผ่านเมนูคลิกขวาล้มเหลว (เช่น ไม่พบเมนูหรือรายการเมนู) ส่วนเสริมจะสลับไปใช้ OCR (การรู้จำอักขระด้วยแสง) เพื่ออ่านเนื้อหาข้อความโดยอัตโนมัติ

โปรแกรมอ่านข้อความ เมนูคลิกขวา และคีย์ชั่วคราว

• โปรแกรมอ่านข้อความ (NVDA+Windows+J): ส่วนเสริมจะเปิดเมนู "ตัวเลือกเพิ่มเติม" ของห้องแชท เลือก "บันทึกแชท" โดยอัตโนมัติ แยกวิเคราะห์ข้อความที่ส่งออก แล้วเปิดหน้าต่างอ่านที่เข้าถึงได้ง่าย
• การนำทางในโปรแกรมอ่านข้อความ: ใช้ UpArrow / DownArrow เพื่อเลื่อนไปยังข้อความก่อนหน้าและถัดไป และกด Escape เพื่อปิด หน้าต่างจะคงบรรทัดแบ่งวันที่ไว้และประกาศตำแหน่งปัจจุบัน
• เมนูคลิกขวาข้อความ (Applications / Shift+F10): ในรายการข้อความ ส่วนเสริมจะเปิดเมนูคลิกขวาเสมือนสำหรับข้อความที่โฟกัสอยู่ เพื่อให้สั่งคัดลอก ตอบกลับ เรียกคืน หรือ "แปลงเป็นข้อความ" ได้ง่ายขึ้น
• คีย์ยืนยันการเรียกคืนข้อความ: หลังเลือกเรียกคืน ส่วนเสริมจะผูก Y = เรียกคืน, N = ยกเลิก, P = เรียกคืนแบบไร้ร่องรอย (ต้องใช้ Premium) ชั่วคราว หากไม่กดอะไรภายใน 10 วินาที ระบบจะยกเลิกให้อัตโนมัติ
• คีย์ยินยอมการแปลงรูปภาพเป็นข้อความ: เมื่อ LINE แสดงประกาศอัปโหลดรูปภาพในการใช้ "แปลงเป็นข้อความ" ครั้งแรก ส่วนเสริมจะผูก A = ยอมรับ และ D = ไม่ยอมรับ ชั่วคราว หากไม่กดอะไรภายใน 10 วินาที ระบบจะเลือกไม่ยอมรับโดยอัตโนมัติ

หน้าต่างเสมือน (Virtual Windows)

หน้าต่างเสมือนคืออะไร？

หน้าต่างเสมือนเป็นอินเทอร์เฟซพิเศษที่ส่วนเสริมนี้จัดเตรียมไว้ เพื่อปรับปรุงการเข้าถึงฟีเจอร์บางอย่างของ LINE ที่ยากต่อการเข้าถึงผ่าน API การเข้าถึงมาตรฐาน เมื่อคุณใช้คีย์ลัดเฉพาะ ส่วนเสริมจะสร้างเมนูหรือกล่องโต้ตอบเสมือน ทำให้คุณสามารถใช้งานฟีเจอร์เหล่านี้ได้สะดวกยิ่งขึ้น

ประเภทของหน้าต่างเสมือน

ส่วนเสริมนี้ปัจจุบันมีหน้าต่างเสมือนดังต่อไปนี้：

1. เมนูตัวเลือกเพิ่มเติมของห้องแชท: กด NVDA+Windows+O เพื่อเปิด
2. เมนูคลิกขวาข้อความ: ใช้สำหรับคัดลอก ตอบกลับ เรียกคืนข้อความ และการดำเนินการอื่นๆ
3. หน้าต่างรหัสยืนยัน: อ่านรหัสยืนยันเมื่อเข้าสู่ระบบ LINE ครั้งแรก กรุณานำรหัสนี้ไปป้อนในโทรศัพท์มือถือของคุณ
4. เมนูถาดระบบ: ใช้สำหรับเข้าถึงตัวเลือก LINE ในถาดระบบ

วิธีใช้หน้าต่างเสมือน

1. เปิดหน้าต่างเสมือน: ใช้คีย์ลัดที่เกี่ยวข้อง (เช่น NVDA+Windows+O)
2. นำทางตัวเลือก: ใช้ปุ่มลูกศรขึ้นและลงเพื่อเคลื่อนที่ระหว่างตัวเลือก
3. เลือกตัวเลือก: กด Enter เพื่อดำเนินการตัวเลือกที่เลือก
4. ปิดหน้าต่าง: กด Escape เพื่อปิดหน้าต่างเสมือน

ข้อควรระวัง

• หน้าต่างเสมือนเป็นอินเทอร์เฟซจำลอง การดำเนินการจริงยังคงดำเนินการโดยส่วนเสริมผ่านระบบอัตโนมัติแบบพิกัด
• ตัวเลือกหน้าต่างเสมือนบางอย่างอาจแตกต่างกันไปตามเวอร์ชัน LINE หรือสถานะของอินเทอร์เฟซ
• หากหน้าต่างเสมือนไม่ทำงานอย่างถูกต้อง โปรดตรวจสอบให้แน่ใจว่าหน้าต่าง LINE อยู่ในสถานะปกติและไม่ถูกบดบังโดยหน้าต่างอื่น

คีย์ลัด (Keyboard Shortcuts)

Note

ในคอลัมน์ "หมวดหมู่" คำว่า "ส่วนเสริม" หมายถึงคีย์ลัดที่ส่วนเสริมนี้จัดเตรียมให้ "ส่วนเสริม (ชั่วคราว)" หมายถึงคีย์ลัดที่ใช้ได้เฉพาะตอนมีกล่องโต้ตอบบางประเภทเปิดอยู่ และ "LINE" หมายถึงคีย์ลัดที่มาพร้อมกับ LINE Desktop

Tip

คุณสามารถปรับแต่งคีย์ลัดเหล่านี้ได้ผ่าน "เมนู NVDA → การตั้งค่า → ท่าทางการป้อนข้อมูล"

การโทรและสายเรียกเข้า

คีย์ลัด	หมวดหมู่	คำสั่ง
NVDA+Windows+C	ส่วนเสริม	เริ่มการโทรด้วยเสียง (Voice Call)
NVDA+Windows+V	ส่วนเสริม	เริ่มการโทรด้วยวิดีโอ (Video Call)
NVDA+Windows+A	ส่วนเสริม	รับสายเรียกเข้า
NVDA+Windows+D	ส่วนเสริม	ปฏิเสธสายเรียกเข้า
NVDA+Windows+S	ส่วนเสริม	ตรวจสอบข้อมูลผู้โทร
NVDA+Windows+F	ส่วนเสริม	ไปยังหน้าต่างการโทร
Ctrl+Shift+A	LINE	เปิด/ปิดไมโครโฟน; ระหว่างการโทร ส่วนเสริมจะประกาศสถานะใหม่
Ctrl+Shift+V	LINE	เปิด/ปิดกล้อง; ระหว่างการโทร ส่วนเสริมจะประกาศสถานะใหม่

การจัดการข้อความ

คีย์ลัด	หมวดหมู่	คำสั่ง
Control+C	ส่วนเสริม	คัดลอกข้อความปัจจุบัน (ใช้ในรายการข้อความ; ในช่องแก้ไขจะเป็นการคัดลอกปกติ)
NVDA+Windows+R	ส่วนเสริม	ตอบกลับข้อความปัจจุบัน
NVDA+Windows+Delete	ส่วนเสริม	เรียกคืนข้อความ (ยกเลิกการส่ง)
NVDA+Windows+T	ส่วนเสริม	อ่านชื่อห้องแชทปัจจุบัน
NVDA+Windows+K	ส่วนเสริม	เปิดกล่องโต้ตอบบันทึกเป็น (ไฟล์สามารถดาวน์โหลดได้เพียง 7 วันหลังอัปโหลด)
Applications / Shift+F10	ส่วนเสริม	เปิดเมนูคลิกขวาเสมือนของข้อความปัจจุบัน

คีย์ยืนยันชั่วคราว

คีย์ลัด	หมวดหมู่	คำสั่ง
Y	ส่วนเสริม (ชั่วคราว)	ยืนยันการเรียกคืนข้อความ
N	ส่วนเสริม (ชั่วคราว)	ยกเลิกการเรียกคืนข้อความ
P	ส่วนเสริม (ชั่วคราว)	เรียกคืนแบบไร้ร่องรอย (ต้องใช้ Premium)
A	ส่วนเสริม (ชั่วคราว)	ยอมรับประกาศอัปโหลดรูปภาพสำหรับ "แปลงเป็นข้อความ"
D	ส่วนเสริม (ชั่วคราว)	ปฏิเสธประกาศอัปโหลดรูปภาพสำหรับ "แปลงเป็นข้อความ"

คีย์ลัดพื้นฐาน

คีย์ลัด	หมวดหมู่	คำสั่ง
Ctrl+W	LINE	ปิดหน้าต่าง
Ctrl+L	LINE	เปิดโหมดล็อค
Ctrl+1	LINE	ไปยังแท็บเพื่อน
Ctrl+2	LINE	ไปยังแท็บแชท
Ctrl+3	LINE	ไปยังแท็บเพิ่มเพื่อน
Ctrl+Shift+P	LINE	จับภาพหน้าจอ
Ctrl+Shift+K	LINE	เปิด Keep Memo
F1	LINE	แสดงคำแนะนำคีย์ลัด (หมายเหตุ: โปรแกรมอ่านหน้าจอไม่สามารถอ่านคำอธิบายนี้ได้ กรุณาอ่านเอกสารนี้แทน)

การนำทางแท็บห้องแชท

คีย์ลัด	หมวดหมู่	คำสั่ง
NVDA+Windows+1	ส่วนเสริม	ไปยังแท็บแชททั้งหมด
NVDA+Windows+2	ส่วนเสริม	ไปยังแท็บเพื่อน
NVDA+Windows+3	ส่วนเสริม	ไปยังแท็บกลุ่ม
NVDA+Windows+4	ส่วนเสริม	ไปยังแท็บชุมชน
NVDA+Windows+5	ส่วนเสริม	ไปยังแท็บบัญชีทางการ

รายการเพื่อนและแชท

คีย์ลัด	หมวดหมู่	คำสั่ง
Ctrl+Shift+F	LINE	ค้นหา
Ctrl+Tab	LINE	ย้ายไปยังห้องแชทก่อนหน้า

ห้องแชท

คีย์ลัด	หมวดหมู่	คำสั่ง
Enter	LINE	ส่งข้อความ; ส่วนเสริมจะเล่นเสียงเมื่อส่งสำเร็จจริงเท่านั้น
NVDA+Windows+J	ส่วนเสริม	เปิดโปรแกรมอ่านข้อความ
NVDA+Windows+O	ส่วนเสริม	คลิกปุ่มตัวเลือกเพิ่มเติม (More Options)
Shift+Enter	LINE	ขึ้นบรรทัดใหม่
Ctrl+F	LINE	ค้นหา
Ctrl+N	LINE	เปิดโน้ต
Ctrl+E	LINE	เปิดหน้าต่างสติกเกอร์
Ctrl+O	LINE	ส่งไฟล์
Ctrl+K	LINE	เปิด Keep Memo
Ctrl+P	LINE	จับภาพหน้าจอ

การจัดรูปแบบข้อความ

คีย์ลัด	หมวดหมู่	คำสั่ง
Ctrl+B	LINE	ตัวหนา
Ctrl+I	LINE	ตัวเอียง
Ctrl+Shift+X	LINE	ขีดฆ่า
Ctrl+Shift+C	LINE	กรอบข้อความสีแดง
Ctrl+Shift+D	LINE	กรอบย่อหน้า

เครื่องเล่นสื่อ

คีย์ลัด	หมวดหมู่	คำสั่ง
NVDA+Windows+K	ส่วนเสริม	บันทึกข้อความเสียง
NVDA+Windows+P	ส่วนเสริม	เล่นข้อความเสียง
Ctrl+S	LINE	บันทึกไฟล์
Ctrl+C	LINE	คัดลอกไฟล์
Enter	LINE	แสดงเต็มจอ
Space	LINE	เล่น/หยุดชั่วคราว
Ctrl+Left / Right	LINE	กรอวิดีโอไปข้างหน้า/ย้อนกลับ 5 วินาที
Ctrl+Up / Down	LINE	เพิ่ม/ลดระดับเสียงวิดีโอ
Ctrl+Shift+Plus / Ctrl+Minus	LINE	ซูมเข้า/ออกรูปภาพ

จับภาพหน้าจอ

คีย์ลัด	หมวดหมู่	คำสั่ง
Space	LINE	รีเซ็ตพื้นที่จับภาพ
Ctrl+Z	LINE	เลิกทำ
Ctrl+Shift+Z / Ctrl+Y	LINE	ทำซ้ำ
Ctrl+C	LINE	คัดลอก
Ctrl+S	LINE	บันทึก
Shift	LINE	วาดเส้นตรง สี่เหลี่ยม และวงกลม

การจัดหมวดหมู่ห้องแชท

คีย์ลัด	หมวดหมู่	คำสั่ง
Alt+Left / Right	LINE	ย้ายหมวดหมู่

เครื่องมือช่วยเหลือ (Debug)

คีย์ลัด	หมวดหมู่	คำสั่ง
NVDA+Shift+K	ส่วนเสริม	ตรวจสอบ UIA และ OCR (คัดลอกลงคลิปบอร์ด)
NVDA+Shift+V	ส่วนเสริม	รายงานเวอร์ชัน LINE ภาษา ประเภทหน้าต่าง และสถานะการเข้าถึงของ Qt
NVDA+Shift+J	Global (ทั่วไป)	รายงานข้อมูลแอปและกระบวนการ (Process) ที่โฟกัสอยู่

ชุมชนและการสนับสนุน (Community & Support)

• กลุ่มผู้ใช้ LINE (LINE User Group): เข้าร่วมกลุ่ม ยินดีต้อนรับสู่เข้าร่วมกลุ่มเพื่อเสนอแนะฟีเจอร์ใหม่ แจ้งปัญหาการใช้งาน หรือร่วมพูดคุยกับทีมพัฒนา
• รหัสต้นฉบับ (Source Code) และการติดตามปัญหา: GitHub Repository หากมีข้อเสนอแนะหรือพบข้อบกพร่อง สามารถเปิด Issue ได้ และหากต้องการร่วมพัฒนา สามารถส่ง Pull Request ได้เสมอ
• ติดต่อนักพัฒนา: ติดต่อผ่าน LINE

เวอร์ชันที่รองรับ (Supported Versions)

• LINE สำหรับ Windows (ทั้งเวอร์ชันปกติ และ Microsoft Store)
• NVDA เวอร์ชัน 2022.1 หรือใหม่กว่า