การสนับสนุนเกมคอนโทรลเลอร์
โครงร่าง¶
ใน UI ที่ได้รับจาก SDK คุณสามารถเลื่อนเคอร์เซอร์ของเมาส์และคลิกปุ่มโดยใช้ 'ตัวควบคุมเกม' แทนที่จะเป็นเมาส์ปกติ ตัวอย่างเช่น ในพื้นที่ webview ที่ SDK เปิดเผย ผู้ใช้สามารถเลื่อนเคอร์เซอร์เมาส์ด้วยตัวควบคุมเกม และคลิกปุ่มภายในพื้นที่ webview
Note
ฟังก์ชั่น 'ตัวควบคุมเกม' ใช้งานได้ตั้งแต่เวอร์ชัน SDK ด้านล่าง
-
Hive SDK v4 Unity Windows 24.1.0 หรือสูงกว่า
- Hive SDK v4 Android 26.7.0 หรือสูงกว่า
คอนโทรลเลอร์เกมที่รองรับ{ #supported-controller }¶
ประเภทของตัวควบคุมเกมที่ SDK รองรับมีดังต่อไปนี้ และจำนวนตัวควบคุมที่สามารถใช้ได้ต่อ SDK คือ สูงสุด 1 ตัว
-
ไมโครซอฟต์เอกซ์บอกซ์คอนโทรลเลอร์
-
Sony PlayStation DualSense คอนโทรลเลอร์ DualShock
-
คอนโทรลเลอร์ Nintendo Switch Pro
การแมปคีย์คอนโทรลเลอร์{ #controller-keymapping }¶
เริ่มตั้งแต่เวอร์ชัน Hive SDK ด้านล่าง UI บางส่วนรองรับการแมปคีย์คอนโทรลเลอร์เมื่อใช้คอนโทรลเลอร์เกม
-
Hive SDK v4 Unity Windows 25.0.0 หรือสูงกว่า
-
Hive SDK v4 Android 26.7.0 หรือสูงกว่า
Warning
โปรดทราบว่าใน UI ที่รองรับการแมปคีย์คอนโทรลเลอร์ [วิธีดำเนินการคีย์] (#key) จะแตกต่างจากวิธีดำเนินการคีย์ใน UI ที่มีอยู่
Note
ใน UI ที่ไม่รองรับการแมปคีย์คอนโทรลเลอร์แยกกัน เคอร์เซอร์ของเมาส์จะปรากฏบนหน้าจอ และ UI จะถูกควบคุมด้วยตัวควบคุมเกมโดยการเลื่อนเคอร์เซอร์
วิธีการใช้งานคีย์{ #key }¶
ตรวจสอบ| อุปกรณ์อินพุต | วิธีการทำงานของคีย์ UI ที่มีอยู่ | การแมปคีย์คอนโทรลเลอร์ รองรับวิธีการทำงานของคีย์ UI |
| จอยสติ๊กอนาล็อกด้านซ้าย | เลื่อนเคอร์เซอร์ของเมาส์ | ย้ายโฟกัส |
| จอยสติ๊กอนาล็อกขวา | เมาส์ล้อเลื่อนแนวตั้งและแนวนอน | เมาส์ล้อเลื่อนแนวตั้งและแนวนอน |
| ปุ่ม A | คลิกปุ่มซ้ายของเมาส์ | (ปุ่ม X สำหรับ Dual Sense หรือ Dual Shock) |
| ปุ่ม B | ไม่รองรับ | ยกเลิก (ปุ่ม O สำหรับ Dual Sense หรือ Dual Shock) |
| ดีแพด | ไม่รองรับ | ย้ายโฟกัส |
รายการ UI รองรับการแมปคีย์คอนโทรลเลอร์{ #key-mapping-ui-list }¶
ด้านล่างนี้คือรายการ UI ที่รองรับฟีเจอร์การแมปคีย์คอนโทรลเลอร์:
เซิร์ฟเวอร์ กรอกหมายเลขยืนยันตัวตน| UI ที่สนับสนุน | SDK v4 Unity Windows รองรับ | SDK v4 Android รองรับ | |
| 1 | อัพเดตแอป | รองรับ | รองรับ |
| 2 | ข้อจำกัดการเข้าถึง | รองรับ | รองรับ |
| 3 | ตรวจสอบ | รองรับ | รองรับ |
| 4 | กำลังรอการเข้าสู่ระบบ | รองรับ | - |
| 5 | รายการ IdP | รองรับ | - |
| 6 | บัญชีขัดแย้ง | - | รองรับ |
| 7 | แบนเนอร์ส่งเสริมการขาย | รองรับ | รองรับ (แบนเนอร์ด้านหน้า) |
| 8 | ป๊อปอัพรีวิวโปรโมชั่น | - | รองรับ |
| 9 | ป๊อปอัพท้ายโปรโมชั่น | - | รองรับ |
| 10 | ตรวจสอบบัญชีการชำระเงินของ Google | รองรับ | - |
| 11 | ยืนยันการชำระเงิน | รองรับ | - |
| 12 | ข้อผิดพลาดในการชำระเงิน | รองรับ | - |
| 13 | การชำระคืน | - | รองรับ |
| 14 | Steam Deck เข้าสู่ระบบ | รองรับ | - |
| 15 | เข้าสู่ระบบ | รองรับ | - |
| 16 | ค้นหารหัสผ่าน | รองรับ | - |
| 17 | รองรับ | - | |
| 18 | ค้นหาอีเมล | รองรับ | - |
| 19 | ข้อมูลบัญชีที่ไม่มีการเคลื่อนไหว | รองรับ | - |
| 20 | หน้าจอยินยอมของ Analytics | - | รองรับ |
ข้อควรระวัง (ทั่วไปสำหรับแพลตฟอร์ม){ #notes_all_platform }¶
เมื่อใช้ 'ตัวควบคุมเกม' กับ SDK ต้องคำนึงถึงประเด็นต่อไปนี้
ช่วงการเคลื่อนไหวของตัวควบคุมเกม¶
ตัวควบคุมเกมรองรับเฉพาะใน UI ที่ใช้งานกับSDK ตัวอย่างเช่น UI มุมมองเว็บที่แสดงโดย SDK ในเกม เช่น หน้าจอเข้าสู่ระบบ แบนเนอร์ข่าวสารและโปรโมชัน ฯลฯ ไม่รองรับ UI ที่ไม่ได้ใช้งานโดย SDK เช่น หน้าต่างเบราว์เซอร์ภายนอก การเลื่อนเคอร์เซอร์ของเมาส์โดยใช้ตัวควบคุมเกมภายในเกมจะต้องดำเนินการโดยผู้พัฒนาโดยตรง
หมายเหตุ (Windows){ #notes_windows_platform }¶
การรวมระบบ Steam¶
หากคุณตั้งค่า "เปิดใช้งานอุปกรณ์ควบคุม Steam" เมื่อเชื่อมโยงกับ Steam คุณจะไม่สามารถใช้ฟังก์ชันตัวควบคุมเกมที่ SDK มอบให้ได้ อย่างไรก็ตาม ด้วยการเปลี่ยนเค้าโครงที่ Steam มอบให้ จึงสามารถจัดเตรียมสภาพแวดล้อมที่คล้ายกับฟังก์ชันตัวควบคุมเกมที่ SDK มอบให้ได้ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ [หน้าอุปกรณ์ควบคุม Steam] (https://partner.steamgames.com/doc/features/steam_controller) ในเอกสาร Steamworks อย่างเป็นทางการ
จัดการอินพุตคอนโทรลเลอร์ด้วยวิธีดั้งเดิม¶
หากอินพุตคอนโทรลเลอร์เกม (รวมถึงคอนโทรลเลอร์ของ Steam Deck เอง) เกิดขึ้นหลังจากที่แอปเรียกใช้เมธอด SDK และก่อนที่จะได้รับการตอบกลับ แอปจะต้องไม่ประมวลผลอินพุตคอนโทรลเลอร์เกมเอง เนื่องจาก SDK ประมวลผลอินพุตตัวควบคุมเกมที่เกิดขึ้นบน UI ที่ SDK ใช้งาน
แป้นพิมพ์บนหน้าจอ Windows¶
เมื่อใช้ฟังก์ชันสนับสนุนตัวควบคุมเกมที่ SDK มอบให้ในแป้นพิมพ์บนหน้าจอของ Windows คุณต้องตั้งค่า "ตัวเลือก" ต่อไปนี้ในแป้นพิมพ์บนหน้าจอของ Windows เพื่อใช้ฟังก์ชันตัวควบคุมเกม
-
ทำเครื่องหมาย สแกนและป้อน
-
ตรวจสอบเท่านั้น ใช้จอยสติ๊ก เกมแพด หรืออุปกรณ์เล่นเกมอื่นๆ
ข้อจำกัดเกี่ยวกับฟังก์ชันการแมปคีย์คอนโทรลเลอร์¶
UI พร้อมฟังก์ชันการแมปคีย์คอนโทรลเลอร์ที่ใช้จะทำงานได้อย่างถูกต้องใน Rog Ally > โหมด Gamepad
ประกาศ (Android){ #notes_android_platform }¶
ข้อจำกัดการควบคุมแป้นพิมพ์เสมือนระบบปฏิบัติการ Android¶
แป้นพิมพ์เสมือนระบบปฏิบัติการ Android ที่แสดงโดยการเลือกช่องป้อนข้อความใน UI ด้วยตัวควบคุมเกมไม่สามารถใช้งานได้กับตัวควบคุมเกม เมื่อเปิดใช้งานแป้นพิมพ์เสมือน คุณต้องสัมผัสหน้าจอโดยตรงเพื่อป้อนข้อความ
ช่วงการเคลื่อนไหวของตัวควบคุมเกม¶
ฟังก์ชันการทำงานของตัวควบคุมเกมของ Hive SDK รองรับเฉพาะในพื้นที่ UI ที่นำมาใช้กับ SDK โดยตรงเท่านั้น
ดังที่แสดงด้านล่าง UI ที่แสดงตัวเองในโมดูลภายนอกและพื้นที่ระบบจะไม่รวมอยู่ในการควบคุมตัวควบคุมเกมผ่าน Hive SDK
-
UI การรวมไลบรารีภายนอก: หน้าจอเข้าสู่ระบบ IdP ภายนอก, ป๊อปอัปการชำระเงิน (IAP), ป๊อปอัปการแชร์เนื้อหา ฯลฯ
-
เบราว์เซอร์ภายนอกและมุมมองเว็บ: เบราว์เซอร์ในแอปและเบราว์เซอร์ระบบภายนอก
ปัญหาที่ทราบ{ #issues }¶
หากคุณพยายามเชื่อมต่อตัวควบคุมเกมอีกครั้งอย่างรวดเร็วและรวดเร็ว ตัวควบคุมอาจทำงานผิดปกติ ตัวอย่างเช่น ในกรณีของ Switch Pro Controller หากการตัดการเชื่อมต่อและการเชื่อมต่อเกิดขึ้นซ้ำภายในระยะเวลาสั้นๆ เคอร์เซอร์ของเมาส์อาจเคลื่อนที่ไปในทิศทางที่กำหนดแม้ว่าผู้ใช้จะไม่ได้ใช้งานก็ตาม นี่เป็นปัญหาของ Switch Pro Controller และสามารถแก้ไขได้ด้วยการกดปุ่มซิงค์ที่อยู่ทางด้านซ้ายของขั้วต่อแบบมีสายหากเกิดปัญหาขึ้น