การตั้งค่าโปรเจ็กต์ Unity

คู่มือนี้จะอธิบายรายละเอียดเกี่ยวกับเวอร์ชันเครื่องมือแก้ไข การตั้งค่ากราฟิก การตั้งค่า URP และการตั้งค่าโปรเจ็กต์ Android ที่แนะนำเมื่อพัฒนาแอปพลิเคชัน Unity สำหรับ Android XR

สิ่งที่ต้องมีก่อน

หากต้องการพัฒนาด้วย Unity คุณจะต้องดาวน์โหลดและติดตั้ง Unity Hub

ติดตั้ง Unity Editor และ Android Build Support เวอร์ชัน 6000.0.23f1 ขึ้นไป ซึ่งประกอบด้วย

• OpenJDK
• Android SDK
• เครื่องมือ Android NDK

เลือกเครื่องมือแสดงผล

เราขอแนะนำให้ใช้ Vulkan Graphics API เพื่อแสดงผลแอป Android XR หากต้องการเลือก Vulkan เป็น Graphics API ให้ทำตามขั้นตอนต่อไปนี้

1. ใน Unity ให้ไปที่แก้ไข > การตั้งค่าโปรเจ็กต์ > ผู้เล่น
2. เลือกแท็บ Android แล้วไปที่การตั้งค่าอื่นๆ > การแสดงผล
3. หากเปิดใช้ Auto Graphics API ให้ปิดการตั้งค่านี้เพื่อแสดงส่วน Graphics API

4. ในส่วน Graphics APIs ให้เลือกปุ่มเพิ่ม (+) แล้วเลือก Vulkan จากเมนูแบบเลื่อนลง

   

5. จัดเรียง Graphics API ใหม่โดยใช้แฮนเดิล (=) เพื่อให้ Vulkan แสดงเป็นอันดับแรก

6. (ไม่บังคับ) เลือก Graphics API อื่นๆ แล้วคลิกปุ่มนําออก (-) เพื่อนําออก

Universal Render Pipeline

Android XR ใช้ได้กับ Universal Render Pipeline (URP) หากวางแผนที่จะใช้การส่งผ่าน คุณควรอัปเดตการตั้งค่า URP เริ่มต้นเพื่อให้ได้ประสิทธิภาพการส่งผ่านที่ดีที่สุดใน Android XR

หมายเหตุ: สำหรับโปรเจ็กต์ที่มีอยู่ซึ่งมีชิ้นงานที่สร้างขึ้นสำหรับไปป์ไลน์การเรนเดอร์ในตัว คุณควรใช้เครื่องมือแปลงไปป์ไลน์การเรนเดอร์เพื่อแปลงชิ้นงานเหล่านั้นให้ใช้งานร่วมกับ URP ได้

ตารางต่อไปนี้แสดงรายการการตั้งค่า URP ที่ Unity แนะนำ ซึ่งจะอธิบายอย่างละเอียดในส่วนต่อไปนี้

การเกริ่นนำ	ตำแหน่ง	ค่าที่แนะนำ
HDR	ชิ้นงาน Universal Render Pipeline	ปิดอยู่
หลังการประมวลผล	ข้อมูลโปรแกรมแสดงผลแบบ Universal	ปิดอยู่

หมายเหตุ: คุณต้องใช้ Vulkan หากใช้ URP เราขอแนะนำให้ใช้ Vulkan เป็น API กราฟิกสำหรับ Android XR เนื่องจากฟีเจอร์กราฟิกรุ่นใหม่ๆ รองรับเฉพาะ API ดังกล่าว

การตั้งค่าชิ้นงาน Universal Render Pipeline

ทําตามขั้นตอนต่อไปนี้เพื่อเพิ่มประสิทธิภาพชิ้นงาน Universal Render Pipeline สําหรับ Android XR

1. ค้นหาชิ้นงาน Universal Render Pipeline ของโปรเจ็กต์ วิธีหนึ่งในการทำเช่นนี้คือการพิมพ์ t:UniversalRenderPipelineAsset ในแถบค้นหาของหน้าต่างโปรเจ็กต์

   หมายเหตุ: หากโปรเจ็กต์ไม่มีชิ้นงาน Universal Render Pipeline โปรดดูการติดตั้ง Universal Render Pipeline ในโปรเจ็กต์ที่มีอยู่จากเอกสาร URP

2. ปิดใช้ HDR ในส่วนหัวคุณภาพ

   

การตั้งค่าข้อมูลโปรแกรมแสดงผลแบบ Universal

ทําตามขั้นตอนต่อไปนี้เพื่อเพิ่มประสิทธิภาพข้อมูลโปรแกรมแสดงผลแบบ Universal สําหรับ Android XR

1. ค้นหาชิ้นงานข้อมูล Universal Renderer ของโปรเจ็กต์ วิธีหนึ่งในการทำเช่นนี้คือการพิมพ์ t:UniversalRendererData ในแถบค้นหาของหน้าต่างโปรเจ็กต์

2. ในเครื่องมือตรวจสอบ ภายในส่วนหัวหลังการประมวลผล ให้ยกเลิกการเลือกเปิดใช้

   

ระดับ API ของ Android ขั้นต่ำ

ตั้งค่าโปรเจ็กต์เป็น API ระดับ 24 เป็นอย่างต่ำ ซึ่ง OpenXR Loader กำหนด มิฉะนั้นบิลด์อาจดำเนินการไม่สำเร็จ

ทําตามขั้นตอนเหล่านี้เพื่อตั้งค่าระดับ API ขั้นต่ำของ Android

1. ไปที่แก้ไข > การตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น
2. เลือกแท็บ Android แล้วเปิดการตั้งค่าอื่นๆ
3. ในส่วนการระบุ ให้เลือก 24 ขึ้นไปสำหรับระดับ API ขั้นต่ำ

จุดแรกเข้าของแอปพลิเคชัน

กําหนดการตั้งค่าต่อไปนี้สําหรับจุดแรกเข้าของแอปพลิเคชัน

1. ไปที่แก้ไข > การตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น
2. เลือกแท็บ Android แล้วเปิดการตั้งค่าอื่นๆ
3. ในส่วนจุดแรกเข้าของแอปพลิเคชัน ให้ตรวจสอบว่าเลือก GameActivity แล้วและไม่ได้เลือก Activity

หน้าต่างป๊อปอัป

แอป Android XR ส่วนใหญ่ต้องใช้หน้าต่างที่ปรับขนาดได้ เนื่องจากต้องแสดงผลป๊อปอัป เช่น คำขอสิทธิ์ของระบบ

ทําตามขั้นตอนเหล่านี้เพื่อให้หน้าต่างป๊อปอัปแสดงผลอย่างถูกต้อง

1. ไปที่แก้ไข > การตั้งค่าโปรเจ็กต์ > โปรแกรมเล่น
2. เลือกแท็บ Android แล้วเปิดใช้กิจกรรมที่ปรับขนาดได้

ดูเพิ่มเติม

• Unity Android XR: OpenXR
• นําเข้าส่วนขยาย Android XR สําหรับ Unity